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

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

@@ -117,6 +117,10 @@ export interface ReportingLedgerConfigurationV1 {
     sourceSettings: ReportingSourceSliceRequestV1['sourceSettings'];
     contract: ReportingSourceSliceRequestV1['contract'];
     installedAt: string;
+    /** Trusted host ownership boundary, aligned upward to the schedule; absent means installedAt. */
+    historyStart?: string;
+    /** Frozen ordinal for historyStart, including ordinals before the schedule anchor. */
+    historyStartOrdinal?: number;
     supersededAt?: string;
     semanticFingerprint: string;
 }
@@ -134,6 +138,10 @@ export interface ReportingLedgerObligationV1 {
     finalityPolicy?: ReportingLedgerConfigurationV1['finalityPolicy'];
     canonicalization?: ReportingLedgerConfigurationV1['canonicalization'];
     periodOrdinal: number;
+    /** Pre-install ownership; runs after live work and under a per-source worker budget. */
+    history?: true;
+    /** Private backfill retry deadline, frozen durably on its first execution attempt. */
+    historyRecoveryDeadlineAt?: string;
     period: {
         start: string;
         end: string;
@@ -820,11 +828,26 @@ export interface ReportingLedgerStore {
      * port, and commit what it returns.
      */
     resolveTransitionFinalityBaseline?(reporting_obligation_id: string): Promise<ReportingObservedFinalityV1>;
+    /**
+     * Insert an immutable generation or return its existing identity. History metadata must be persisted
+     * with a matching schedule boundary/ordinal. Under the same account fence as extension, reject newly
+     * owned history that overlaps another generation; existing handoff overlap may remain unchanged.
+     */
     putConfiguration(configuration: ReportingLedgerConfigurationV1): Promise<{
         inserted: boolean;
         value: ReportingLedgerConfigurationV1;
     }>;
     listConfigurations(account_id?: string): Promise<ReportingLedgerConfigurationV1[]>;
+    /**
+     * Atomically move ownership earlier, or return an equal boundary unchanged. Refuse later boundaries,
+     * unknown configurations and overlap with another generation. Preserve installedAt, fingerprint,
+     * calendarRules and all existing obligations. Optional for stores without history extension support.
+     */
+    extendConfigurationHistory?(input: {
+        configurationId: string;
+        historyStart: string;
+        historyStartOrdinal: number;
+    }): Promise<ReportingLedgerConfigurationV1>;
     putObligation(obligation: ReportingLedgerObligationV1): Promise<{
         inserted: boolean;
         value: ReportingLedgerObligationV1;
@@ -851,6 +874,8 @@ export interface ReportingLedgerStore {
         now: string;
         leaseMilliseconds: number;
         account_id?: string;
+        /** Claim live work first; omit history for these source offering IDs once their cycle budget is spent. */
+        excludeHistoryOfferingIds?: string[];
     }): Promise<ReportingLedgerLeaseV1 | null>;
     releaseObligationLease(lease: ReportingLedgerLeaseV1): Promise<void>;
     commitRevision(revision: ReportingLedgerRevisionV1, lease: ReportingLedgerLeaseV1): Promise<{
@@ -1056,15 +1081,25 @@ export interface ReportingProducerContactV1 {
     url?: string;
 }
 export interface ReportingProducerV1 {
-    installConfiguration(input: Omit<ReportingLedgerConfigurationV1, 'configurationId' | 'installedAt' | 'semanticFingerprint' | 'calendarRules'>): Promise<ReportingLedgerConfigurationV1>;
+    installConfiguration(input: Omit<ReportingLedgerConfigurationV1, 'configurationId' | 'installedAt' | 'semanticFingerprint' | 'calendarRules' | 'historyStart' | 'historyStartOrdinal'>, options?: {
+        historyStart?: string;
+    }): Promise<ReportingLedgerConfigurationV1>;
+    /** Trusted host operation. Ownership may only move earlier within the source retention window. */
+    extendConfigurationHistory(input: {
+        configurationId: string;
+        historyStart: string;
+    }): Promise<ReportingLedgerConfigurationV1>;
     planObligations(now?: string, options?: {
         account_id?: string;
         maxObligations?: number;
+        maxHistoryObligationsPerSource?: number;
     }): Promise<ReportingLedgerObligationV1[]>;
     runWorker(options?: {
         signal?: AbortSignal;
         now?: () => Date;
         maxIterations?: number;
+        /** Maximum history claims per source offering in this worker pass. Defaults to 10; zero pauses history. */
+        maxHistorySlicesPerSource?: number;
         retryDelayMilliseconds?: number;
         executionDeadlineMilliseconds?: number;
         settlementGraceMilliseconds?: number;

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

@@ -117,6 +117,10 @@ export interface ReportingLedgerConfigurationV1 {
     sourceSettings: ReportingSourceSliceRequestV1['sourceSettings'];
     contract: ReportingSourceSliceRequestV1['contract'];
     installedAt: string;
+    /** Trusted host ownership boundary, aligned upward to the schedule; absent means installedAt. */
+    historyStart?: string;
+    /** Frozen ordinal for historyStart, including ordinals before the schedule anchor. */
+    historyStartOrdinal?: number;
     supersededAt?: string;
     semanticFingerprint: string;
 }
@@ -134,6 +138,10 @@ export interface ReportingLedgerObligationV1 {
     finalityPolicy?: ReportingLedgerConfigurationV1['finalityPolicy'];
     canonicalization?: ReportingLedgerConfigurationV1['canonicalization'];
     periodOrdinal: number;
+    /** Pre-install ownership; runs after live work and under a per-source worker budget. */
+    history?: true;
+    /** Private backfill retry deadline, frozen durably on its first execution attempt. */
+    historyRecoveryDeadlineAt?: string;
     period: {
         start: string;
         end: string;
@@ -820,11 +828,26 @@ export interface ReportingLedgerStore {
      * port, and commit what it returns.
      */
     resolveTransitionFinalityBaseline?(reporting_obligation_id: string): Promise<ReportingObservedFinalityV1>;
+    /**
+     * Insert an immutable generation or return its existing identity. History metadata must be persisted
+     * with a matching schedule boundary/ordinal. Under the same account fence as extension, reject newly
+     * owned history that overlaps another generation; existing handoff overlap may remain unchanged.
+     */
     putConfiguration(configuration: ReportingLedgerConfigurationV1): Promise<{
         inserted: boolean;
         value: ReportingLedgerConfigurationV1;
     }>;
     listConfigurations(account_id?: string): Promise<ReportingLedgerConfigurationV1[]>;
+    /**
+     * Atomically move ownership earlier, or return an equal boundary unchanged. Refuse later boundaries,
+     * unknown configurations and overlap with another generation. Preserve installedAt, fingerprint,
+     * calendarRules and all existing obligations. Optional for stores without history extension support.
+     */
+    extendConfigurationHistory?(input: {
+        configurationId: string;
+        historyStart: string;
+        historyStartOrdinal: number;
+    }): Promise<ReportingLedgerConfigurationV1>;
     putObligation(obligation: ReportingLedgerObligationV1): Promise<{
         inserted: boolean;
         value: ReportingLedgerObligationV1;
@@ -851,6 +874,8 @@ export interface ReportingLedgerStore {
         now: string;
         leaseMilliseconds: number;
         account_id?: string;
+        /** Claim live work first; omit history for these source offering IDs once their cycle budget is spent. */
+        excludeHistoryOfferingIds?: string[];
     }): Promise<ReportingLedgerLeaseV1 | null>;
     releaseObligationLease(lease: ReportingLedgerLeaseV1): Promise<void>;
     commitRevision(revision: ReportingLedgerRevisionV1, lease: ReportingLedgerLeaseV1): Promise<{
@@ -1056,15 +1081,25 @@ export interface ReportingProducerContactV1 {
     url?: string;
 }
 export interface ReportingProducerV1 {
-    installConfiguration(input: Omit<ReportingLedgerConfigurationV1, 'configurationId' | 'installedAt' | 'semanticFingerprint' | 'calendarRules'>): Promise<ReportingLedgerConfigurationV1>;
+    installConfiguration(input: Omit<ReportingLedgerConfigurationV1, 'configurationId' | 'installedAt' | 'semanticFingerprint' | 'calendarRules' | 'historyStart' | 'historyStartOrdinal'>, options?: {
+        historyStart?: string;
+    }): Promise<ReportingLedgerConfigurationV1>;
+    /** Trusted host operation. Ownership may only move earlier within the source retention window. */
+    extendConfigurationHistory(input: {
+        configurationId: string;
+        historyStart: string;
+    }): Promise<ReportingLedgerConfigurationV1>;
     planObligations(now?: string, options?: {
         account_id?: string;
         maxObligations?: number;
+        maxHistoryObligationsPerSource?: number;
     }): Promise<ReportingLedgerObligationV1[]>;
     runWorker(options?: {
         signal?: AbortSignal;
         now?: () => Date;
         maxIterations?: number;
+        /** Maximum history claims per source offering in this worker pass. Defaults to 10; zero pauses history. */
+        maxHistorySlicesPerSource?: number;
         retryDelayMilliseconds?: number;
         executionDeadlineMilliseconds?: number;
         settlementGraceMilliseconds?: number;

package/dist/lib/reporting/service/index.d.mts

@@ -61,7 +61,7 @@ export interface ReliableReportingSourceRouteV1 {
     /** Trusted upstream reporting clock for this account/scope. */
     sourceTimezone: string;
 }
-type LedgerInstallInput = Omit<ReportingLedgerConfigurationV1, 'configurationId' | 'installedAt' | 'semanticFingerprint' | 'calendarRules' | 'account' | 'sourceScope' | 'sourceTimezone' | 'sourceSettings' | 'contract' | 'constituents' | 'mediaBuyIds'>;
+type LedgerInstallInput = Omit<ReportingLedgerConfigurationV1, 'configurationId' | 'installedAt' | 'semanticFingerprint' | 'calendarRules' | 'historyStart' | 'historyStartOrdinal' | 'account' | 'sourceScope' | 'sourceTimezone' | 'sourceSettings' | 'contract' | 'constituents' | 'mediaBuyIds'>;
 /**
  * Seller-resolved configuration facts. `currency`, account identity, source
  * scope, timezone, and source contract are deliberately absent.
@@ -78,11 +78,15 @@ export interface ReliableReportingConfigurationInputV1 extends LedgerInstallInpu
 export interface ReliableReportingInstallContextV1<TCtxMeta = Record<string, unknown>> {
     /** Must be the framework-resolved account from RequestContext. */
     account: Pick<Account<TCtxMeta>, 'id' | 'ctx_metadata'>;
+    /** Trusted host history entitlement; never copy from buyer configuration input. */
+    historyStart?: string;
 }
 interface ReliableReportingSchedulerBaseOptionsV1 {
     intervalMilliseconds: number;
     maxObligationsPerAccount?: number;
     maxWorkerIterationsPerAccount?: number;
+    maxHistoryObligationsPerSource?: number;
+    maxHistorySlicesPerSource?: number;
     /** Bounded transactional notification claims per auxiliary pass. Defaults to 25. */
     notificationRecoveryLimit?: number;
     /** Independent notification recovery workers. Defaults to 4. */
@@ -127,6 +131,10 @@ interface ReliableReportingCycleBaseOptionsV1 {
     now?: Date;
     maxObligations?: number;
     maxWorkerIterations?: number;
+    /** Per source offering planning budget in this cycle; defaults to maxObligations. Zero pauses planning history. */
+    maxHistoryObligationsPerSource?: number;
+    /** Per source offering execution budget in this cycle; defaults to 10. Zero pauses executing history. */
+    maxHistorySlicesPerSource?: number;
     retryDelayMilliseconds?: number;
     executionDeadlineMilliseconds?: number;
     settlementGraceMilliseconds?: number;
@@ -261,6 +269,11 @@ export interface ReliableReportingServiceV1<TCtxMeta = Record<string, unknown>>
     readonly platform: ReliableReportingPlatform<TCtxMeta>;
     readonly running: boolean;
     installConfiguration(configuration: ReliableReportingConfigurationInputV1, context: ReliableReportingInstallContextV1<TCtxMeta>): Promise<ReportingLedgerConfigurationV1>;
+    /** Trusted host operation; does not change the generation version or installedAt. */
+    extendConfigurationHistory(input: {
+        configurationId: string;
+        historyStart: string;
+    }): Promise<ReportingLedgerConfigurationV1>;
     /**
      * Returns the same platform object, narrowed to also carry `reporting`.
      * The input type is preserved: widening to `DecisioningPlatform` would erase

package/dist/lib/reporting/service/index.d.ts

@@ -61,7 +61,7 @@ export interface ReliableReportingSourceRouteV1 {
     /** Trusted upstream reporting clock for this account/scope. */
     sourceTimezone: string;
 }
-type LedgerInstallInput = Omit<ReportingLedgerConfigurationV1, 'configurationId' | 'installedAt' | 'semanticFingerprint' | 'calendarRules' | 'account' | 'sourceScope' | 'sourceTimezone' | 'sourceSettings' | 'contract' | 'constituents' | 'mediaBuyIds'>;
+type LedgerInstallInput = Omit<ReportingLedgerConfigurationV1, 'configurationId' | 'installedAt' | 'semanticFingerprint' | 'calendarRules' | 'historyStart' | 'historyStartOrdinal' | 'account' | 'sourceScope' | 'sourceTimezone' | 'sourceSettings' | 'contract' | 'constituents' | 'mediaBuyIds'>;
 /**
  * Seller-resolved configuration facts. `currency`, account identity, source
  * scope, timezone, and source contract are deliberately absent.
@@ -78,11 +78,15 @@ export interface ReliableReportingConfigurationInputV1 extends LedgerInstallInpu
 export interface ReliableReportingInstallContextV1<TCtxMeta = Record<string, unknown>> {
     /** Must be the framework-resolved account from RequestContext. */
     account: Pick<Account<TCtxMeta>, 'id' | 'ctx_metadata'>;
+    /** Trusted host history entitlement; never copy from buyer configuration input. */
+    historyStart?: string;
 }
 interface ReliableReportingSchedulerBaseOptionsV1 {
     intervalMilliseconds: number;
     maxObligationsPerAccount?: number;
     maxWorkerIterationsPerAccount?: number;
+    maxHistoryObligationsPerSource?: number;
+    maxHistorySlicesPerSource?: number;
     /** Bounded transactional notification claims per auxiliary pass. Defaults to 25. */
     notificationRecoveryLimit?: number;
     /** Independent notification recovery workers. Defaults to 4. */
@@ -127,6 +131,10 @@ interface ReliableReportingCycleBaseOptionsV1 {
     now?: Date;
     maxObligations?: number;
     maxWorkerIterations?: number;
+    /** Per source offering planning budget in this cycle; defaults to maxObligations. Zero pauses planning history. */
+    maxHistoryObligationsPerSource?: number;
+    /** Per source offering execution budget in this cycle; defaults to 10. Zero pauses executing history. */
+    maxHistorySlicesPerSource?: number;
     retryDelayMilliseconds?: number;
     executionDeadlineMilliseconds?: number;
     settlementGraceMilliseconds?: number;
@@ -261,6 +269,11 @@ export interface ReliableReportingServiceV1<TCtxMeta = Record<string, unknown>>
     readonly platform: ReliableReportingPlatform<TCtxMeta>;
     readonly running: boolean;
     installConfiguration(configuration: ReliableReportingConfigurationInputV1, context: ReliableReportingInstallContextV1<TCtxMeta>): Promise<ReportingLedgerConfigurationV1>;
+    /** Trusted host operation; does not change the generation version or installedAt. */
+    extendConfigurationHistory(input: {
+        configurationId: string;
+        historyStart: string;
+    }): Promise<ReportingLedgerConfigurationV1>;
     /**
      * Returns the same platform object, narrowed to also carry `reporting`.
      * The input type is preserved: widening to `DecisioningPlatform` would erase

package/dist/lib/reporting/service/index.js

@@ -248,17 +248,23 @@ function createReliableReportingService(options) {
       void _currency;
       void _timezone;
       void _mediaBuyIds;
-      return producer.installConfiguration({
-        ...ledgerInput,
-        schedule: { ...ledgerInput.schedule, ...scheduleIdentity },
-        account: { account_id: context.account.id },
-        sourceScope,
-        sourceTimezone: normalizedTimezone,
-        sourceSettings: { ...sourceSettings, currency: normalizedCurrency },
-        contract: structuredClone(offering.contract),
-        constituents,
-        mediaBuyIds
-      });
+      return producer.installConfiguration(
+        {
+          ...ledgerInput,
+          schedule: { ...ledgerInput.schedule, ...scheduleIdentity },
+          account: { account_id: context.account.id },
+          sourceScope,
+          sourceTimezone: normalizedTimezone,
+          sourceSettings: { ...sourceSettings, currency: normalizedCurrency },
+          contract: structuredClone(offering.contract),
+          constituents,
+          mediaBuyIds
+        },
+        { ...context.historyStart !== void 0 ? { historyStart: context.historyStart } : {} }
+      );
+    },
+    extendConfigurationHistory(input) {
+      return producer.extendConfigurationHistory(input);
     },
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     install(platform) {
@@ -286,7 +292,8 @@ function createReliableReportingService(options) {
       cycle.signal?.throwIfAborted();
       const planned = await producer.planObligations(planningNow.toISOString(), {
         ...accountId !== void 0 ? { account_id: accountId } : {},
-        ...cycle.maxObligations !== void 0 ? { maxObligations: cycle.maxObligations } : {}
+        ...cycle.maxObligations !== void 0 ? { maxObligations: cycle.maxObligations } : {},
+        ...cycle.maxHistoryObligationsPerSource !== void 0 ? { maxHistoryObligationsPerSource: cycle.maxHistoryObligationsPerSource } : {}
       });
       cycle.signal?.throwIfAborted();
       const result = await producer.runWorker({
@@ -294,6 +301,7 @@ function createReliableReportingService(options) {
         ...cycle.now ? { now: () => cycle.now } : {},
         ...accountId !== void 0 ? { account_id: accountId } : {},
         ...cycle.maxWorkerIterations !== void 0 ? { maxIterations: cycle.maxWorkerIterations } : {},
+        ...cycle.maxHistorySlicesPerSource !== void 0 ? { maxHistorySlicesPerSource: cycle.maxHistorySlicesPerSource } : {},
         ...cycle.retryDelayMilliseconds !== void 0 ? { retryDelayMilliseconds: cycle.retryDelayMilliseconds } : {},
         ...cycle.executionDeadlineMilliseconds !== void 0 ? { executionDeadlineMilliseconds: cycle.executionDeadlineMilliseconds } : {},
         ...cycle.settlementGraceMilliseconds !== void 0 ? { settlementGraceMilliseconds: cycle.settlementGraceMilliseconds } : {}
@@ -379,6 +387,8 @@ async function schedulerLoop(service, options, signal, store, maintenance) {
         await service.runCycle({
           ...accountId === void 0 ? { deploymentWide: true } : { accountId },
           signal,
+          ...options.maxHistoryObligationsPerSource !== void 0 ? { maxHistoryObligationsPerSource: options.maxHistoryObligationsPerSource } : {},
+          ...options.maxHistorySlicesPerSource !== void 0 ? { maxHistorySlicesPerSource: options.maxHistorySlicesPerSource } : {},
           ...options.maxObligationsPerAccount !== void 0 ? { maxObligations: options.maxObligationsPerAccount } : {},
           ...options.maxWorkerIterationsPerAccount !== void 0 ? { maxWorkerIterations: options.maxWorkerIterationsPerAccount } : {},
           ...options.retryDelayMilliseconds !== void 0 ? { retryDelayMilliseconds: options.retryDelayMilliseconds } : {},
@@ -755,6 +765,8 @@ function trustedTimezone(value) {
 function assertNoUntrustedLineageFields(configuration) {
   for (const field of [
     "account",
+    "historyStart",
+    "historyStartOrdinal",
     "sourceScope",
     "sourceTimezone",
     "contract",

package/dist/lib/reporting/service/index.mjs

@@ -245,17 +245,23 @@ function createReliableReportingService(options) {
       void _currency;
       void _timezone;
       void _mediaBuyIds;
-      return producer.installConfiguration({
-        ...ledgerInput,
-        schedule: { ...ledgerInput.schedule, ...scheduleIdentity },
-        account: { account_id: context.account.id },
-        sourceScope,
-        sourceTimezone: normalizedTimezone,
-        sourceSettings: { ...sourceSettings, currency: normalizedCurrency },
-        contract: structuredClone(offering.contract),
-        constituents,
-        mediaBuyIds
-      });
+      return producer.installConfiguration(
+        {
+          ...ledgerInput,
+          schedule: { ...ledgerInput.schedule, ...scheduleIdentity },
+          account: { account_id: context.account.id },
+          sourceScope,
+          sourceTimezone: normalizedTimezone,
+          sourceSettings: { ...sourceSettings, currency: normalizedCurrency },
+          contract: structuredClone(offering.contract),
+          constituents,
+          mediaBuyIds
+        },
+        { ...context.historyStart !== void 0 ? { historyStart: context.historyStart } : {} }
+      );
+    },
+    extendConfigurationHistory(input) {
+      return producer.extendConfigurationHistory(input);
     },
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     install(platform) {
@@ -283,7 +289,8 @@ function createReliableReportingService(options) {
       cycle.signal?.throwIfAborted();
       const planned = await producer.planObligations(planningNow.toISOString(), {
         ...accountId !== void 0 ? { account_id: accountId } : {},
-        ...cycle.maxObligations !== void 0 ? { maxObligations: cycle.maxObligations } : {}
+        ...cycle.maxObligations !== void 0 ? { maxObligations: cycle.maxObligations } : {},
+        ...cycle.maxHistoryObligationsPerSource !== void 0 ? { maxHistoryObligationsPerSource: cycle.maxHistoryObligationsPerSource } : {}
       });
       cycle.signal?.throwIfAborted();
       const result = await producer.runWorker({
@@ -291,6 +298,7 @@ function createReliableReportingService(options) {
         ...cycle.now ? { now: () => cycle.now } : {},
         ...accountId !== void 0 ? { account_id: accountId } : {},
         ...cycle.maxWorkerIterations !== void 0 ? { maxIterations: cycle.maxWorkerIterations } : {},
+        ...cycle.maxHistorySlicesPerSource !== void 0 ? { maxHistorySlicesPerSource: cycle.maxHistorySlicesPerSource } : {},
         ...cycle.retryDelayMilliseconds !== void 0 ? { retryDelayMilliseconds: cycle.retryDelayMilliseconds } : {},
         ...cycle.executionDeadlineMilliseconds !== void 0 ? { executionDeadlineMilliseconds: cycle.executionDeadlineMilliseconds } : {},
         ...cycle.settlementGraceMilliseconds !== void 0 ? { settlementGraceMilliseconds: cycle.settlementGraceMilliseconds } : {}
@@ -376,6 +384,8 @@ async function schedulerLoop(service, options, signal, store, maintenance) {
         await service.runCycle({
           ...accountId === void 0 ? { deploymentWide: true } : { accountId },
           signal,
+          ...options.maxHistoryObligationsPerSource !== void 0 ? { maxHistoryObligationsPerSource: options.maxHistoryObligationsPerSource } : {},
+          ...options.maxHistorySlicesPerSource !== void 0 ? { maxHistorySlicesPerSource: options.maxHistorySlicesPerSource } : {},
           ...options.maxObligationsPerAccount !== void 0 ? { maxObligations: options.maxObligationsPerAccount } : {},
           ...options.maxWorkerIterationsPerAccount !== void 0 ? { maxWorkerIterations: options.maxWorkerIterationsPerAccount } : {},
           ...options.retryDelayMilliseconds !== void 0 ? { retryDelayMilliseconds: options.retryDelayMilliseconds } : {},
@@ -752,6 +762,8 @@ function trustedTimezone(value) {
 function assertNoUntrustedLineageFields(configuration) {
   for (const field of [
     "account",
+    "historyStart",
+    "historyStartOrdinal",
     "sourceScope",
     "sourceTimezone",
     "contract",

package/dist/lib/schemas/browser.d.mts

@@ -12,3 +12,5 @@ export { BiddingPolicySchema } from '../validation/bidding-policy.mjs';
 export { CanonicalBudgetAllocationSchema } from '../validation/budget-allocation.mjs';
 export { SyncCreativesItemSchema, SyncCreativesSuccessStrictSchema, SyncCreativesResponseStrictSchema, SyncCreativesActionSchema, } from '../validation/sync-creatives.mjs';
 export type { SyncCreativesItem, SyncCreativesSuccessStrict } from '../validation/sync-creatives.mjs';
+export { MediaBuyDeliveryReportSchema } from '../validation/media-buy-delivery-report.mjs';
+export type { MediaBuyDeliveryReport } from '../types/media-buy-delivery-report.mjs';

package/dist/lib/schemas/browser.d.ts

@@ -12,3 +12,5 @@ export { BiddingPolicySchema } from '../validation/bidding-policy';
 export { CanonicalBudgetAllocationSchema } from '../validation/budget-allocation';
 export { SyncCreativesItemSchema, SyncCreativesSuccessStrictSchema, SyncCreativesResponseStrictSchema, SyncCreativesActionSchema, } from '../validation/sync-creatives';
 export type { SyncCreativesItem, SyncCreativesSuccessStrict } from '../validation/sync-creatives';
+export { MediaBuyDeliveryReportSchema } from '../validation/media-buy-delivery-report';
+export type { MediaBuyDeliveryReport } from '../types/media-buy-delivery-report';

package/dist/lib/schemas/browser.js

@@ -23,6 +23,7 @@ __export(browser_exports, {
   CanonicalBudgetAllocationSchema: () => import_budget_allocation.CanonicalBudgetAllocationSchema,
   GetProductsRequestSchema: () => import_get_products_request.GetProductsRequestSchema,
   LegacyGetProductsRequestSchema: () => import_get_products_request.LegacyGetProductsRequestSchema,
+  MediaBuyDeliveryReportSchema: () => import_media_buy_delivery_report.MediaBuyDeliveryReportSchema,
   SyncCreativesActionSchema: () => import_sync_creatives.SyncCreativesActionSchema,
   SyncCreativesItemSchema: () => import_sync_creatives.SyncCreativesItemSchema,
   SyncCreativesResponseStrictSchema: () => import_sync_creatives.SyncCreativesResponseStrictSchema,
@@ -34,12 +35,14 @@ var import_get_products_request = require('../validation/get-products-request.js
 var import_bidding_policy = require('../validation/bidding-policy.js');
 var import_budget_allocation = require('../validation/budget-allocation.js');
 var import_sync_creatives = require('../validation/sync-creatives.js');
+var import_media_buy_delivery_report = require('../validation/media-buy-delivery-report.js');
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   BiddingPolicySchema,
   CanonicalBudgetAllocationSchema,
   GetProductsRequestSchema,
   LegacyGetProductsRequestSchema,
+  MediaBuyDeliveryReportSchema,
   SyncCreativesActionSchema,
   SyncCreativesItemSchema,
   SyncCreativesResponseStrictSchema,

package/dist/lib/schemas/browser.mjs

@@ -8,11 +8,13 @@ import {
   SyncCreativesResponseStrictSchema,
   SyncCreativesActionSchema
 } from "../validation/sync-creatives.mjs";
+import { MediaBuyDeliveryReportSchema } from "../validation/media-buy-delivery-report.mjs";
 export {
   BiddingPolicySchema,
   CanonicalBudgetAllocationSchema,
   GetProductsRequestSchema,
   LegacyGetProductsRequestSchema,
+  MediaBuyDeliveryReportSchema,
   SyncCreativesActionSchema,
   SyncCreativesItemSchema,
   SyncCreativesResponseStrictSchema,

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

@@ -42,12 +42,12 @@
 import { z } from 'zod';
 import * as schemas from '../types/schemas.generated.mjs';
 import type { KnownToolRequestSchemas } from '../utils/tool-request-schemas.mjs';
-import { getSchemaDocumentByRef, type Direction, type ResolvedToolSchemaDocument, type ResponseVariant } from '../validation/schema-loader.mjs';
+import { getSchemaDocumentByRef, getSchemaValidatorByRef, type Direction, type ResolvedToolSchemaDocument, type ResponseVariant } from '../validation/schema-loader.mjs';
 import type { ValidateFunction } from 'ajv';
 export * from '../types/schemas.generated.mjs';
 export { AgentOAuthClientCredentialsSchema } from '../auth/oauth/client-credentials-schema.mjs';
 export type { AgentOAuthClientCredentials } from '../types/adcp.mjs';
-export type { PlacementPresentationDocument, PlacementPresentationReference } from '../types/core.generated.mjs';
+export type { AssetVariant, PlacementPresentationDocument, PlacementPresentationReference, } from '../types/core.generated.mjs';
 export { GetProductsRequestSchema, LegacyGetProductsRequestSchema } from '../validation/get-products-request.mjs';
 export type { LooseObjectSchemaFor } from '../validation/get-products-request.mjs';
 export { BiddingPolicySchema } from '../validation/bidding-policy.mjs';
@@ -73,7 +73,7 @@ export type VersionedToolSchema = ResolvedToolSchemaDocument;
  * callers should normally prefer {@link getCanonicalToolValidator} so
  * reference registration stays internal.
  */
-export { getSchemaDocumentByRef };
+export { getSchemaDocumentByRef, getSchemaValidatorByRef };
 /** Retrieve the protocol-authored request JSON Schema for a specific AdCP release. */
 export declare function getToolInputSchema(toolName: string, options?: ToolSchemaLookupOptions): VersionedToolSchema | undefined;
 /** Retrieve a protocol-authored response JSON Schema for a specific AdCP release. */
@@ -178,3 +178,5 @@ export declare function customToolForSchema<TSchema extends InputSchema>(name: s
     inputSchema: TSchema;
     handler: (args: z.input<TSchema>, extra?: unknown) => unknown | Promise<unknown>;
 };
+export { MediaBuyDeliveryReportSchema } from '../validation/media-buy-delivery-report.mjs';
+export type { MediaBuyDeliveryReport } from '../types/media-buy-delivery-report.mjs';

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

@@ -42,12 +42,12 @@
 import { z } from 'zod';
 import * as schemas from '../types/schemas.generated';
 import type { KnownToolRequestSchemas } from '../utils/tool-request-schemas';
-import { getSchemaDocumentByRef, type Direction, type ResolvedToolSchemaDocument, type ResponseVariant } from '../validation/schema-loader';
+import { getSchemaDocumentByRef, getSchemaValidatorByRef, type Direction, type ResolvedToolSchemaDocument, type ResponseVariant } from '../validation/schema-loader';
 import type { ValidateFunction } from 'ajv';
 export * from '../types/schemas.generated';
 export { AgentOAuthClientCredentialsSchema } from '../auth/oauth/client-credentials-schema';
 export type { AgentOAuthClientCredentials } from '../types/adcp';
-export type { PlacementPresentationDocument, PlacementPresentationReference } from '../types/core.generated';
+export type { AssetVariant, PlacementPresentationDocument, PlacementPresentationReference, } from '../types/core.generated';
 export { GetProductsRequestSchema, LegacyGetProductsRequestSchema } from '../validation/get-products-request';
 export type { LooseObjectSchemaFor } from '../validation/get-products-request';
 export { BiddingPolicySchema } from '../validation/bidding-policy';
@@ -73,7 +73,7 @@ export type VersionedToolSchema = ResolvedToolSchemaDocument;
  * callers should normally prefer {@link getCanonicalToolValidator} so
  * reference registration stays internal.
  */
-export { getSchemaDocumentByRef };
+export { getSchemaDocumentByRef, getSchemaValidatorByRef };
 /** Retrieve the protocol-authored request JSON Schema for a specific AdCP release. */
 export declare function getToolInputSchema(toolName: string, options?: ToolSchemaLookupOptions): VersionedToolSchema | undefined;
 /** Retrieve a protocol-authored response JSON Schema for a specific AdCP release. */
@@ -178,3 +178,5 @@ export declare function customToolForSchema<TSchema extends InputSchema>(name: s
     inputSchema: TSchema;
     handler: (args: z.input<TSchema>, extra?: unknown) => unknown | Promise<unknown>;
 };
+export { MediaBuyDeliveryReportSchema } from '../validation/media-buy-delivery-report';
+export type { MediaBuyDeliveryReport } from '../types/media-buy-delivery-report';

package/dist/lib/schemas/index.js

@@ -34,6 +34,7 @@ __export(schemas_exports, {
   CanonicalBudgetAllocationSchema: () => import_budget_allocation.CanonicalBudgetAllocationSchema,
   GetProductsRequestSchema: () => import_get_products_request.GetProductsRequestSchema,
   LegacyGetProductsRequestSchema: () => import_get_products_request.LegacyGetProductsRequestSchema,
+  MediaBuyDeliveryReportSchema: () => import_media_buy_delivery_report.MediaBuyDeliveryReportSchema,
   SyncCreativesActionSchema: () => import_sync_creatives.SyncCreativesActionSchema,
   SyncCreativesItemSchema: () => import_sync_creatives.SyncCreativesItemSchema,
   SyncCreativesResponseStrictSchema: () => import_sync_creatives.SyncCreativesResponseStrictSchema,
@@ -46,6 +47,7 @@ __export(schemas_exports, {
   customToolForSchema: () => customToolForSchema,
   getCanonicalToolValidator: () => getCanonicalToolValidator,
   getSchemaDocumentByRef: () => import_schema_loader.getSchemaDocumentByRef,
+  getSchemaValidatorByRef: () => import_schema_loader.getSchemaValidatorByRef,
   getToolInputSchema: () => getToolInputSchema,
   getToolResponseSchema: () => getToolResponseSchema
 });
@@ -62,6 +64,7 @@ var import_budget_allocation = require('../validation/budget-allocation.js');
 var import_tool_request_schemas2 = require('../utils/tool-request-schemas.js');
 var import_response_schemas = require('../utils/response-schemas.js');
 var import_sync_creatives = require('../validation/sync-creatives.js');
+var import_media_buy_delivery_report = require('../validation/media-buy-delivery-report.js');
 function getToolInputSchema(toolName, options = {}) {
   return (0, import_schema_loader.getToolSchemaDocument)(toolName, "request", (0, import_adcp_version_config.resolveAdcpVersion)(options.adcpVersion));
 }
@@ -113,6 +116,7 @@ function customToolForSchema(name, description, inputSchema, handler) {
   CanonicalBudgetAllocationSchema,
   GetProductsRequestSchema,
   LegacyGetProductsRequestSchema,
+  MediaBuyDeliveryReportSchema,
   SyncCreativesActionSchema,
   SyncCreativesItemSchema,
   SyncCreativesResponseStrictSchema,
@@ -125,6 +129,7 @@ function customToolForSchema(name, description, inputSchema, handler) {
   customToolForSchema,
   getCanonicalToolValidator,
   getSchemaDocumentByRef,
+  getSchemaValidatorByRef,
   getToolInputSchema,
   getToolResponseSchema,
   ...require('../types/schemas.generated.js')

package/dist/lib/schemas/index.mjs

@@ -3,6 +3,7 @@ import { TOOL_REQUEST_SCHEMAS } from "../utils/tool-request-schemas.mjs";
 import {
   getCanonicalToolValidatorForVersion,
   getSchemaDocumentByRef,
+  getSchemaValidatorByRef,
   getToolSchemaDocument
 } from "../validation/schema-loader.mjs";
 import { resolveAdcpVersion } from "../utils/adcp-version-config.mjs";
@@ -63,12 +64,14 @@ function customToolForSchema(name, description, inputSchema, handler) {
   void name;
   return { description, inputSchema, handler };
 }
+import { MediaBuyDeliveryReportSchema } from "../validation/media-buy-delivery-report.mjs";
 export {
   AgentOAuthClientCredentialsSchema,
   BiddingPolicySchema,
   CanonicalBudgetAllocationSchema,
   GetProductsRequestSchema,
   LegacyGetProductsRequestSchema,
+  MediaBuyDeliveryReportSchema,
   SyncCreativesActionSchema,
   SyncCreativesItemSchema,
   SyncCreativesResponseStrictSchema,
@@ -81,6 +84,7 @@ export {
   customToolForSchema,
   getCanonicalToolValidator,
   getSchemaDocumentByRef,
+  getSchemaValidatorByRef,
   getToolInputSchema,
   getToolResponseSchema
 };

package/dist/lib/server/account-response-identity.d.mts

@@ -0,0 +1,17 @@
+import type { SyncAccountsSuccess } from '../types/tools.generated.mjs';
+declare const IDENTITY_RESPONSE_SCHEMAS: {
+    readonly account: "core/account-ref.json";
+    readonly operator_unit: "core/operator-unit.json";
+    readonly identity_change: "core/account-identity-change.json";
+    readonly identity_change_preview: "core/account-identity-change-preview.json";
+};
+type IdentityFields = Pick<SyncAccountsSuccess['accounts'][number], keyof typeof IDENTITY_RESPONSE_SCHEMAS>;
+/**
+ * These canonical identity objects have closed schemas, including their nested
+ * operator identities. Validate and emit the same detached snapshot so retained
+ * DB/request fields or later mutations cannot enter a response or replay cache,
+ * even with whole-response validation off. These four core contracts are shared
+ * by the maintained 3.2 and 3.3 bundles.
+ */
+export declare function projectAccountResponseIdentityFields(account: object): IdentityFields;
+export {};

package/dist/lib/server/account-response-identity.d.ts

@@ -0,0 +1,17 @@
+import type { SyncAccountsSuccess } from '../types/tools.generated';
+declare const IDENTITY_RESPONSE_SCHEMAS: {
+    readonly account: "core/account-ref.json";
+    readonly operator_unit: "core/operator-unit.json";
+    readonly identity_change: "core/account-identity-change.json";
+    readonly identity_change_preview: "core/account-identity-change-preview.json";
+};
+type IdentityFields = Pick<SyncAccountsSuccess['accounts'][number], keyof typeof IDENTITY_RESPONSE_SCHEMAS>;
+/**
+ * These canonical identity objects have closed schemas, including their nested
+ * operator identities. Validate and emit the same detached snapshot so retained
+ * DB/request fields or later mutations cannot enter a response or replay cache,
+ * even with whole-response validation off. These four core contracts are shared
+ * by the maintained 3.2 and 3.3 bundles.
+ */
+export declare function projectAccountResponseIdentityFields(account: object): IdentityFields;
+export {};