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

package/dist/lib/types/schemas.generated.js

@@ -2184,7 +2184,7 @@ const MacroProcessingCapabilitySchema = /* @__PURE__ */ (() => import_zod.z.obje
   universal_semantic: UniversalMacroSchema.optional(),
   operation: import_zod.z.union([import_zod.z.literal("translate_to_native"), import_zod.z.literal("resolve_value")]),
   performed_by: MacroProcessingActorSchema,
-  supported_contexts: import_zod.z.array(MacroValueContextSchema.and(import_zod.z.object({}).passthrough())),
+  supported_contexts: import_zod.z.array(import_zod.z.enum(["url_query_value", "url_path_segment"])),
   supported_encodings: import_zod.z.array(MacroEncodingSchema).optional(),
   translation_target: MacroTranslationTargetSchema.optional()
 }).passthrough()).merge(import_zod.z.object({
@@ -2196,7 +2196,7 @@ const MacroProcessingCapabilitySchema = /* @__PURE__ */ (() => import_zod.z.obje
   universal_semantic: UniversalMacroSchema.optional(),
   operation: import_zod.z.union([import_zod.z.literal("translate_to_native"), import_zod.z.literal("resolve_value")]),
   performed_by: MacroProcessingActorSchema,
-  supported_contexts: import_zod.z.array(MacroValueContextSchema.and(import_zod.z.object({}).passthrough())),
+  supported_contexts: import_zod.z.array(import_zod.z.enum(["url_query_value", "url_path_segment"])),
   supported_encodings: import_zod.z.array(MacroEncodingSchema).optional(),
   translation_target: MacroTranslationTargetSchema.optional()
 }).passthrough()))();
@@ -6509,7 +6509,7 @@ const AgentEncryptionKeySchema = /* @__PURE__ */ (() => import_zod.z.object({
 const AgentNotificationConfigStateSchema = /* @__PURE__ */ (() => import_zod.z.object({
   subscriber_id: import_zod.z.string().min(1).max(64).regex(new RegExp("^[A-Za-z0-9_.:-]{1,64}$")),
   url: import_zod.z.string().refine(adcpJsonSchemaUri, "Invalid URI"),
-  event_types: import_zod.z.array(NotificationTypeSchema.and(import_zod.z.object({}).passthrough())),
+  event_types: import_zod.z.array(import_zod.z.enum(["creative.status_changed", "creative.assignment_changed", "indicators.changed", "creative.purged", "account.status_changed", "account.change_recorded", "product.created", "product.updated", "product.priced", "product.removed", "signal.created", "signal.updated", "signal.priced", "signal.removed", "wholesale_feed.bulk_change", "capabilities.changed", "reporting.delivery_ready", "reporting.status_changed", "reporting.ledger_changed", "principal.changed"])),
   all_authorized_accounts: import_zod.z.boolean().optional(),
   include_future_event_types: import_zod.z.boolean().optional(),
   authentication: import_zod.z.object({
@@ -6521,7 +6521,7 @@ const AgentNotificationConfigStateSchema = /* @__PURE__ */ (() => import_zod.z.o
 const AgentNotificationConfigSchema = /* @__PURE__ */ (() => import_zod.z.object({
   subscriber_id: import_zod.z.string().min(1).max(64).regex(new RegExp("^[A-Za-z0-9_.:-]{1,64}$")),
   url: import_zod.z.string().refine(adcpJsonSchemaUri, "Invalid URI"),
-  event_types: import_zod.z.array(NotificationTypeSchema.and(import_zod.z.object({}).passthrough())),
+  event_types: import_zod.z.array(import_zod.z.enum(["creative.status_changed", "creative.assignment_changed", "indicators.changed", "creative.purged", "account.status_changed", "account.change_recorded", "product.created", "product.updated", "product.priced", "product.removed", "signal.created", "signal.updated", "signal.priced", "signal.removed", "wholesale_feed.bulk_change", "capabilities.changed", "reporting.delivery_ready", "reporting.status_changed", "reporting.ledger_changed", "principal.changed"])),
   all_authorized_accounts: import_zod.z.boolean().optional(),
   include_future_event_types: import_zod.z.boolean().optional(),
   authentication: import_zod.z.object({
@@ -7278,7 +7278,7 @@ const OutcomeTargetCostPerSchema = /* @__PURE__ */ (() => import_zod.z.object({
 }).passthrough())();
 const PackageDeliveryMetricValueSchema = /* @__PURE__ */ (() => import_zod.z.object({}).passthrough().merge(import_zod.z.object({
   scope: import_zod.z.literal("standard"),
-  metric_id: AvailableMetricSchema.and(import_zod.z.object({}).passthrough()),
+  metric_id: import_zod.z.enum(["impressions", "clicks", "ctr", "views", "completed_views", "completion_rate", "conversions", "conversion_value", "commissionable_value", "roas", "cost_per_acquisition", "new_to_brand_rate", "leads", "reach", "frequency", "grps", "engagements", "engagement_rate", "follows", "saves", "profile_visits", "viewable_rate", "viewable_impressions", "measurable_impressions", "viewed_seconds", "quartile_25", "quartile_50", "quartile_75", "quartile_100", "ooh_metrics", "cost_per_click", "cost_per_completed_view", "cpm", "downloads", "units_sold", "new_to_brand_units", "plays", "incremental_sales_lift", "brand_lift", "foot_traffic", "conversion_lift", "brand_search_lift"]),
   qualifier: CanonicalMetricQualifierSchema.optional(),
   value: import_zod.z.number(),
   measurable_impressions: import_zod.z.number().optional(),
@@ -13355,7 +13355,7 @@ const PixelTrackerAssetSchema = /* @__PURE__ */ (() => import_zod.z.object({}).p
 }).passthrough()))();
 const VASTTrackerAssetSchema = /* @__PURE__ */ (() => import_zod.z.object({}).passthrough().merge(import_zod.z.object({
   asset_type: import_zod.z.literal("vast_tracker"),
-  vast_event: VASTTrackingEventSchema.and(import_zod.z.object({}).passthrough()),
+  vast_event: import_zod.z.enum(["creativeView", "loaded", "start", "firstQuartile", "midpoint", "thirdQuartile", "complete", "mute", "unmute", "pause", "resume", "rewind", "skip", "playerExpand", "playerCollapse", "fullscreen", "exitFullscreen", "progress", "acceptInvitation", "adExpand", "adCollapse", "minimize", "overlayViewDuration", "otherAdInteraction", "interactiveStart", "close", "closeLinear"]),
   url: MacroBearingURL7Schema,
   macro_declarations: import_zod.z.array(MacroDeclarationSchema.and(import_zod.z.object({
     location: import_zod.z.object({
@@ -13368,7 +13368,7 @@ const VASTTrackerAssetSchema = /* @__PURE__ */ (() => import_zod.z.object({}).pa
 }).passthrough()))();
 const DAASTTrackerAssetSchema = /* @__PURE__ */ (() => import_zod.z.object({}).passthrough().merge(import_zod.z.object({
   asset_type: import_zod.z.literal("daast_tracker"),
-  daast_event: DAASTTrackingEventSchema.and(import_zod.z.object({}).passthrough()),
+  daast_event: import_zod.z.enum(["creativeView", "start", "firstQuartile", "midpoint", "thirdQuartile", "complete", "mute", "unmute", "pause", "resume", "rewind", "skip", "progress", "close"]),
   url: MacroBearingURL8Schema,
   macro_declarations: import_zod.z.array(MacroDeclarationSchema.and(import_zod.z.object({
     location: import_zod.z.object({

package/dist/lib/types/schemas.generated.mjs

@@ -667,7 +667,7 @@ const MacroProcessingCapabilitySchema = /* @__PURE__ */ (() => z.object({}).pass
   universal_semantic: UniversalMacroSchema.optional(),
   operation: z.union([z.literal("translate_to_native"), z.literal("resolve_value")]),
   performed_by: MacroProcessingActorSchema,
-  supported_contexts: z.array(MacroValueContextSchema.and(z.object({}).passthrough())),
+  supported_contexts: z.array(z.enum(["url_query_value", "url_path_segment"])),
   supported_encodings: z.array(MacroEncodingSchema).optional(),
   translation_target: MacroTranslationTargetSchema.optional()
 }).passthrough()).merge(z.object({
@@ -679,7 +679,7 @@ const MacroProcessingCapabilitySchema = /* @__PURE__ */ (() => z.object({}).pass
   universal_semantic: UniversalMacroSchema.optional(),
   operation: z.union([z.literal("translate_to_native"), z.literal("resolve_value")]),
   performed_by: MacroProcessingActorSchema,
-  supported_contexts: z.array(MacroValueContextSchema.and(z.object({}).passthrough())),
+  supported_contexts: z.array(z.enum(["url_query_value", "url_path_segment"])),
   supported_encodings: z.array(MacroEncodingSchema).optional(),
   translation_target: MacroTranslationTargetSchema.optional()
 }).passthrough()))();
@@ -4992,7 +4992,7 @@ const AgentEncryptionKeySchema = /* @__PURE__ */ (() => z.object({
 const AgentNotificationConfigStateSchema = /* @__PURE__ */ (() => z.object({
   subscriber_id: z.string().min(1).max(64).regex(new RegExp("^[A-Za-z0-9_.:-]{1,64}$")),
   url: z.string().refine(adcpJsonSchemaUri, "Invalid URI"),
-  event_types: z.array(NotificationTypeSchema.and(z.object({}).passthrough())),
+  event_types: z.array(z.enum(["creative.status_changed", "creative.assignment_changed", "indicators.changed", "creative.purged", "account.status_changed", "account.change_recorded", "product.created", "product.updated", "product.priced", "product.removed", "signal.created", "signal.updated", "signal.priced", "signal.removed", "wholesale_feed.bulk_change", "capabilities.changed", "reporting.delivery_ready", "reporting.status_changed", "reporting.ledger_changed", "principal.changed"])),
   all_authorized_accounts: z.boolean().optional(),
   include_future_event_types: z.boolean().optional(),
   authentication: z.object({
@@ -5004,7 +5004,7 @@ const AgentNotificationConfigStateSchema = /* @__PURE__ */ (() => z.object({
 const AgentNotificationConfigSchema = /* @__PURE__ */ (() => z.object({
   subscriber_id: z.string().min(1).max(64).regex(new RegExp("^[A-Za-z0-9_.:-]{1,64}$")),
   url: z.string().refine(adcpJsonSchemaUri, "Invalid URI"),
-  event_types: z.array(NotificationTypeSchema.and(z.object({}).passthrough())),
+  event_types: z.array(z.enum(["creative.status_changed", "creative.assignment_changed", "indicators.changed", "creative.purged", "account.status_changed", "account.change_recorded", "product.created", "product.updated", "product.priced", "product.removed", "signal.created", "signal.updated", "signal.priced", "signal.removed", "wholesale_feed.bulk_change", "capabilities.changed", "reporting.delivery_ready", "reporting.status_changed", "reporting.ledger_changed", "principal.changed"])),
   all_authorized_accounts: z.boolean().optional(),
   include_future_event_types: z.boolean().optional(),
   authentication: z.object({
@@ -5761,7 +5761,7 @@ const OutcomeTargetCostPerSchema = /* @__PURE__ */ (() => z.object({
 }).passthrough())();
 const PackageDeliveryMetricValueSchema = /* @__PURE__ */ (() => z.object({}).passthrough().merge(z.object({
   scope: z.literal("standard"),
-  metric_id: AvailableMetricSchema.and(z.object({}).passthrough()),
+  metric_id: z.enum(["impressions", "clicks", "ctr", "views", "completed_views", "completion_rate", "conversions", "conversion_value", "commissionable_value", "roas", "cost_per_acquisition", "new_to_brand_rate", "leads", "reach", "frequency", "grps", "engagements", "engagement_rate", "follows", "saves", "profile_visits", "viewable_rate", "viewable_impressions", "measurable_impressions", "viewed_seconds", "quartile_25", "quartile_50", "quartile_75", "quartile_100", "ooh_metrics", "cost_per_click", "cost_per_completed_view", "cpm", "downloads", "units_sold", "new_to_brand_units", "plays", "incremental_sales_lift", "brand_lift", "foot_traffic", "conversion_lift", "brand_search_lift"]),
   qualifier: CanonicalMetricQualifierSchema.optional(),
   value: z.number(),
   measurable_impressions: z.number().optional(),
@@ -11838,7 +11838,7 @@ const PixelTrackerAssetSchema = /* @__PURE__ */ (() => z.object({}).passthrough(
 }).passthrough()))();
 const VASTTrackerAssetSchema = /* @__PURE__ */ (() => z.object({}).passthrough().merge(z.object({
   asset_type: z.literal("vast_tracker"),
-  vast_event: VASTTrackingEventSchema.and(z.object({}).passthrough()),
+  vast_event: z.enum(["creativeView", "loaded", "start", "firstQuartile", "midpoint", "thirdQuartile", "complete", "mute", "unmute", "pause", "resume", "rewind", "skip", "playerExpand", "playerCollapse", "fullscreen", "exitFullscreen", "progress", "acceptInvitation", "adExpand", "adCollapse", "minimize", "overlayViewDuration", "otherAdInteraction", "interactiveStart", "close", "closeLinear"]),
   url: MacroBearingURL7Schema,
   macro_declarations: z.array(MacroDeclarationSchema.and(z.object({
     location: z.object({
@@ -11851,7 +11851,7 @@ const VASTTrackerAssetSchema = /* @__PURE__ */ (() => z.object({}).passthrough()
 }).passthrough()))();
 const DAASTTrackerAssetSchema = /* @__PURE__ */ (() => z.object({}).passthrough().merge(z.object({
   asset_type: z.literal("daast_tracker"),
-  daast_event: DAASTTrackingEventSchema.and(z.object({}).passthrough()),
+  daast_event: z.enum(["creativeView", "start", "firstQuartile", "midpoint", "thirdQuartile", "complete", "mute", "unmute", "pause", "resume", "rewind", "skip", "progress", "close"]),
   url: MacroBearingURL8Schema,
   macro_declarations: z.array(MacroDeclarationSchema.and(z.object({
     location: z.object({

package/dist/lib/version.d.mts

@@ -1,7 +1,7 @@
 /**
  * AdCP SDK library version
  */
-export declare const LIBRARY_VERSION = "16.0.0-beta.3";
+export declare const LIBRARY_VERSION = "16.0.0-beta.5";
 /**
  * AdCP specification version this library is built for
  */
@@ -33,10 +33,10 @@ export type AdcpVersion = (typeof COMPATIBLE_ADCP_VERSIONS)[number];
  * Full version information
  */
 export declare const VERSION_INFO: {
-    readonly library: "16.0.0-beta.3";
+    readonly library: "16.0.0-beta.5";
     readonly adcp: "3.2.4";
     readonly compatibleVersions: readonly ["v2.5", "v2.6", "v3", "3.0.0", "3.0", "3.0.1", "3.0.2", "3.0.3", "3.0.4", "3.0.5", "3.0.6", "3.0.7", "3.0.8", "3.0.9", "3.0.10", "3.0.11", "3.0.12", "3.0.13", "3.0.14", "3.0.15", "3.0.16", "3.0.17", "3.0.18", "3.0.19", "3.0.20", "3.0.21", "3.0.22", "3.0.23", "3.0.24", "3.0.25", "3.1.0", "3.1", "3.1.1", "3.1.2", "3.1.3", "3.1.4", "3.1.5", "3.1.6", "3.1.7", "3.1.8", "3.1.9", "3.1.10", "3.1.11", "3.1.12", "3.1.13", "3.1.14", "3.1.15", "3.1.16", "3.1.17", "3.1.18", "3.1.19", "3.1.20", "3.1.21", "3.1.22", "3.1.23", "3.1.24", "3.2.1", "3.2", "3.2.2", "3.2.3", "3.2.4"];
-    readonly generatedAt: "2026-10-15T18:57:32.995Z";
+    readonly generatedAt: "2026-10-16T15:23:10.050Z";
 };
 /**
  * Get the AdCP specification version this library is built for

package/dist/lib/version.d.ts

@@ -1,7 +1,7 @@
 /**
  * AdCP SDK library version
  */
-export declare const LIBRARY_VERSION = "16.0.0-beta.3";
+export declare const LIBRARY_VERSION = "16.0.0-beta.5";
 /**
  * AdCP specification version this library is built for
  */
@@ -33,10 +33,10 @@ export type AdcpVersion = (typeof COMPATIBLE_ADCP_VERSIONS)[number];
  * Full version information
  */
 export declare const VERSION_INFO: {
-    readonly library: "16.0.0-beta.3";
+    readonly library: "16.0.0-beta.5";
     readonly adcp: "3.2.4";
     readonly compatibleVersions: readonly ["v2.5", "v2.6", "v3", "3.0.0", "3.0", "3.0.1", "3.0.2", "3.0.3", "3.0.4", "3.0.5", "3.0.6", "3.0.7", "3.0.8", "3.0.9", "3.0.10", "3.0.11", "3.0.12", "3.0.13", "3.0.14", "3.0.15", "3.0.16", "3.0.17", "3.0.18", "3.0.19", "3.0.20", "3.0.21", "3.0.22", "3.0.23", "3.0.24", "3.0.25", "3.1.0", "3.1", "3.1.1", "3.1.2", "3.1.3", "3.1.4", "3.1.5", "3.1.6", "3.1.7", "3.1.8", "3.1.9", "3.1.10", "3.1.11", "3.1.12", "3.1.13", "3.1.14", "3.1.15", "3.1.16", "3.1.17", "3.1.18", "3.1.19", "3.1.20", "3.1.21", "3.1.22", "3.1.23", "3.1.24", "3.2.1", "3.2", "3.2.2", "3.2.3", "3.2.4"];
-    readonly generatedAt: "2026-10-15T18:57:32.995Z";
+    readonly generatedAt: "2026-10-16T15:23:10.050Z";
 };
 /**
  * Get the AdCP specification version this library is built for

package/dist/lib/version.js

@@ -31,7 +31,7 @@ __export(version_exports, {
   toReleasePrecisionVersion: () => toReleasePrecisionVersion
 });
 module.exports = __toCommonJS(version_exports);
-const LIBRARY_VERSION = "16.0.0-beta.3";
+const LIBRARY_VERSION = "16.0.0-beta.5";
 const ADCP_VERSION = "3.2.4";
 const ADCP_MAJOR_VERSION = 3;
 const COMPATIBLE_ADCP_VERSIONS = [
@@ -98,10 +98,10 @@ const COMPATIBLE_ADCP_VERSIONS = [
   "3.2.4"
 ];
 const VERSION_INFO = {
-  library: "16.0.0-beta.3",
+  library: "16.0.0-beta.5",
   adcp: "3.2.4",
   compatibleVersions: COMPATIBLE_ADCP_VERSIONS,
-  generatedAt: "2026-10-15T18:57:32.995Z"
+  generatedAt: "2026-10-16T15:23:10.050Z"
 };
 function getAdcpVersion() {
   return ADCP_VERSION;

package/dist/lib/version.mjs

@@ -1,4 +1,4 @@
-const LIBRARY_VERSION = "16.0.0-beta.3";
+const LIBRARY_VERSION = "16.0.0-beta.5";
 const ADCP_VERSION = "3.2.4";
 const ADCP_MAJOR_VERSION = 3;
 const COMPATIBLE_ADCP_VERSIONS = [
@@ -65,10 +65,10 @@ const COMPATIBLE_ADCP_VERSIONS = [
   "3.2.4"
 ];
 const VERSION_INFO = {
-  library: "16.0.0-beta.3",
+  library: "16.0.0-beta.5",
   adcp: "3.2.4",
   compatibleVersions: COMPATIBLE_ADCP_VERSIONS,
-  generatedAt: "2026-10-15T18:57:32.995Z"
+  generatedAt: "2026-10-16T15:23:10.050Z"
 };
 function getAdcpVersion() {
   return ADCP_VERSION;

package/docs/TYPE-SUMMARY.md

@@ -1,7 +1,7 @@
 # AdCP Type Summary
 
-> Generated at: 2026-10-15
-> @adcp/sdk v16.0.0-beta.3
+> Generated at: 2026-10-16
+> @adcp/sdk v16.0.0-beta.5
 
 Curated reference of the types that matter for using the AdCP client. For full generated types see `src/lib/types/tools.generated.ts` and `src/lib/types/core.generated.ts`.
 
@@ -2900,9 +2900,23 @@ interface InlineReportingAvailabilityEvidenceV1 {
 
 ## Seller Reporting Ledger
 
-Ledger symbols import from `@adcp/sdk/reporting/ledger`; `createPostgresPersistentNotificationRuntime` is a server symbol and imports from `@adcp/sdk/server`.
+The ledger interface, handlers and producer import from `@adcp/sdk/reporting/ledger`. The PostgreSQL store, its migrations, row storage and maintenance import from `@adcp/reporting-storage`, managed delivery from `@adcp/reporting-storage/managed` and notification activity from `@adcp/reporting-storage/notifications` (install `@adcp/reporting-storage` next to `@adcp/sdk`; it is pre-1.0 and every export is experimental). `createPostgresPersistentNotificationRuntime` is a server symbol and imports from `@adcp/sdk/server`.
 
 ```typescript
+import { Pool } from 'pg';
+import { createPostgresPersistentNotificationRuntime } from '@adcp/sdk/server';
+import {
+  createReportingDeliveryHandler,
+  createReportingProducer,
+  createReportingStatusHandler,
+  createSyncReportingStatusHandler,
+} from '@adcp/sdk/reporting/ledger';
+import { PostgresReportingLedgerStore, REPORTING_LEDGER_MIGRATION } from '@adcp/reporting-storage';
+import {
+  createPostgresReportingNotificationActivityRuntime,
+  createPostgresReportingNotificationAttemptCheckpoint,
+} from '@adcp/reporting-storage/notifications';
+
 // Build the notification path first: the store must be constructed with the
 // activity port, or lifecycle transitions record no activity and notify nobody.
 const attemptCheckpoint = createPostgresReportingNotificationAttemptCheckpoint({
@@ -2965,6 +2979,9 @@ The store freezes configuration lineage and period-end denominators, retains imm
 Import from `@adcp/sdk/reporting/service`. This is the adapter-first lifecycle owner over the source and ledger primitives; it does not introduce another store or transport.
 
 ```typescript
+import { createReliableReportingService } from '@adcp/sdk/reporting/service';
+import { PostgresReportingLedgerStore, reportingLedgerMaintenance } from '@adcp/reporting-storage';
+
 interface ReliableReportingAdapterV1 {
   readonly sourceOffering: ReportingSourceOfferingV1;
   readonly deliveryOffering: ReportingDeliveryOffering;
@@ -2987,9 +3004,10 @@ const reporting = createReliableReportingService({
   resolveCurrency: account => currency,
   resolveCoverage: account => ({ constituents }), // authorized media-buy/package denominator
   resolveConsumerId, // optional; controls consumer-status handler/capability
+  maintenance: reportingLedgerMaintenance({ retention: { enabled: true } }), // optional factory from @adcp/reporting-storage
 });
 
-await pool.query(reporting.setup.migrations[0]);
+for (const sql of reporting.setup.migrations) await pool.query(sql);
 const installedPlatform = reporting.install(platform);
 await reporting.installConfiguration(configuration, { account: ctx.account });
 await reporting.runCycle({ accountId }); // tenant-partitioned
@@ -2999,7 +3017,7 @@ await reporting.stop();
 
 Account identity comes only from the framework-resolved context. Trusted host callbacks derive adapter routing, credential-free `sourceScope`, source timezone, currency, and the authorized constituent denominator. A declaration cannot supply `account`, `sourceScope`, `sourceTimezone`, `contract`, `currency`, `constituents`, or `mediaBuyIds`; `mediaBuyIds` is derived from `resolveCoverage`, so a buyer cannot name another buyer's media buys on a shared upstream network. Currency is frozen into configuration and obligation lineage. Capabilities are Core-only and derived from installed adapters and handlers; managed delivery, reconciled billing, receipts, webhook activity, and notifications are not advertised. Installation requires `platform.accounts.upsert`, which owns the advertised `sync_accounts` configuration path.
 
-For complete seller production assembly, use async `createPostgresReliableReportingProductionService` from `@adcp/sdk/reporting/service`. It owns the PostgreSQL Core/Managed stores, receipts, all three reporting notifications, webhook activity, migrations, probes, recovery, and capability publication. Supply `activity.tenantScopeForAccount`; Reconciled Billing offerings also require a trusted `obligatedConsumers` roster. Its scheduler and `recoverOnce` require explicit `deploymentWide: true` because recovery scans the whole namespace. See `docs/guides/REPORTING-LEDGER.md` and `docs/guides/REPORTING-OPERATIONS.md`.
+For complete seller production assembly, use async `createPostgresReliableReportingProductionService` from `@adcp/reporting-storage/service`. It owns the PostgreSQL Core/Managed stores, receipts, all three reporting notifications, webhook activity, migrations, probes, recovery, and capability publication. Supply `activity.tenantScopeForAccount`; Reconciled Billing offerings also require a trusted `obligatedConsumers` roster. Its scheduler and `recoverOnce` require explicit `deploymentWide: true` because recovery scans the whole namespace. See `docs/guides/REPORTING-LEDGER.md` and `docs/guides/REPORTING-OPERATIONS.md`.
 
 Buyer production processes use `createPostgresReportingConsumerRuntimeV1` with `createReliableReportingConsumerV1` from the package root. Verify webhook signatures before passing authenticated hints, preserve seller/principal scope, and configure `evaluateAdjustment` to authorize integrity-valid post-official corrections; the default defers them. See `docs/guides/REPORTING-RECONCILIATION.md`.
 

package/docs/guides/REPORTING-GCS-FENCE.md

@@ -1,12 +1,12 @@
 # Durable GCS reporting write fence
 
-`@adcp/sdk/reporting/gcs` provides a provider write-fence primitive backed by the existing PostgreSQL destination authority. It is a building block for a managed delivery adapter; it does not advertise Managed Delivery or Reconciled Billing capabilities or implement `ReportingManagedDeliveryAdapterV1`.
+`@adcp/reporting-storage/gcs` provides a provider write-fence primitive backed by the existing PostgreSQL destination authority. It is a building block for a managed delivery adapter; it does not advertise Managed Delivery or Reconciled Billing capabilities or implement `ReportingManagedDeliveryAdapterV1`.
 
-Install the optional official Google client with `npm install @google-cloud/storage@^7.22.0` for Node 20 or Node 22+. Google client `^8.2.0` is also supported on Node 22+. This peer is required when compiling or using the GCS subpath, including its public types; other SDK subpaths remain independent. Apply `REPORTING_LEDGER_MIGRATION`, `REPORTING_MANAGED_DELIVERY_MIGRATION`, then the additive `REPORTING_OBJECT_WRITE_MIGRATION` from `@adcp/sdk/reporting/ledger` in the same isolated tenant schema. Apply the final migration to a fresh object-write schema if experimenting with earlier, unpublished versions of these tables: `CREATE TABLE IF NOT EXISTS` does not upgrade incompatible prerelease tables.
+Install the optional official Google client with `npm install @google-cloud/storage@^7.22.0` for Node 20 or Node 22+. Google client `^8.2.0` is also supported on Node 22+. This peer is required when compiling or using the GCS subpath, including its public types; other subpaths remain independent. Apply `REPORTING_LEDGER_MIGRATION`, `REPORTING_MANAGED_DELIVERY_MIGRATION`, then the additive `REPORTING_OBJECT_WRITE_MIGRATION` from `@adcp/reporting-storage` (and `@adcp/reporting-storage/managed` for the managed-delivery one) in the same isolated tenant schema. Apply the final migration to a fresh object-write schema if experimenting with earlier, unpublished versions of these tables: `CREATE TABLE IF NOT EXISTS` does not upgrade incompatible prerelease tables.
 
 ```typescript
 import { Storage } from '@google-cloud/storage';
-import { createGcsReportingObjectFenceV1 } from '@adcp/sdk/reporting/gcs';
+import { createGcsReportingObjectFenceV1 } from '@adcp/reporting-storage/gcs';
 
 const fence = createGcsReportingObjectFenceV1({
   storage: new Storage({ retryOptions: { totalTimeout: 60, maxRetries: 3 } }), // Host-owned ADC; retry timeout is in seconds.

package/docs/guides/REPORTING-GCS-MANAGED.md

@@ -1,17 +1,17 @@
 # Managed reporting delivery on GCS
 
-`@adcp/sdk/reporting/gcs` supplies a complete `ReportingManagedDeliveryAdapterV1` for private GCS file transfer. It supports `manifest_checksums` and `canonical_digest` by uploading deterministic JSONL and manifest bytes, then inspecting actual provider bytes and digest-pinned private contracts. The managed runtime owns materialization settlement, cleanup leases, retries and capability publication. Verification is attributed to the producer; independent buyer qualification is a separate gate.
+`@adcp/reporting-storage/gcs` supplies a complete `ReportingManagedDeliveryAdapterV1` for private GCS file transfer. It supports `manifest_checksums` and `canonical_digest` by uploading deterministic JSONL and manifest bytes, then inspecting actual provider bytes and digest-pinned private contracts. The managed runtime owns materialization settlement, cleanup leases, retries and capability publication. Verification is attributed to the producer; independent buyer qualification is a separate gate.
 
 Install the optional official `@google-cloud/storage` peer. Use 7.22.x on Node 20.19 or later; Storage 8.2.x requires Node 22 or later. The default SDK import does not load Google Storage. Supply a host-owned official Storage client using ADC, workload identity or short-lived impersonation. Never persist credentials in reporting descriptors, contract URIs, `ctx_metadata`, inventory or error envelopes.
 
-Apply `REPORTING_LEDGER_MIGRATION`, the applicable Core writer-fence migration, `REPORTING_MANAGED_DELIVERY_MIGRATION`, `REPORTING_OBJECT_WRITE_MIGRATION`, then `REPORTING_OBJECT_WRITE_AUTHORITY_MIGRATION` from `@adcp/sdk/reporting/ledger`. The last migration requires PostgreSQL 13 or later and creates one persistent installation UUID per isolated schema. Reapplying it preserves the UUID. Keep that row in backups and restores. **Never run delivery or cleanup from an independently writable clone of live authorization, inventory or materialization tables.** Such a clone would still address the original objects. Start a fresh isolated schema with a distinct deployment namespace and installation UUID, provision new destination grants, and import only the needed immutable Core facts. A restored replica of the same authority keeps its identity. Do not replace an identity while old write plans still exist. The adapter combines the UUID with your stable deployment namespace to avoid collisions between isolated schemas sharing a bucket.
+Apply `REPORTING_LEDGER_MIGRATION`, the applicable Core writer-fence migration, `REPORTING_MANAGED_DELIVERY_MIGRATION`, `REPORTING_OBJECT_WRITE_MIGRATION`, then `REPORTING_OBJECT_WRITE_AUTHORITY_MIGRATION` from `@adcp/reporting-storage` (`REPORTING_MANAGED_DELIVERY_MIGRATION` is on `@adcp/reporting-storage/managed`). The last migration requires PostgreSQL 13 or later and creates one persistent installation UUID per isolated schema. Reapplying it preserves the UUID. Keep that row in backups and restores. **Never run delivery or cleanup from an independently writable clone of live authorization, inventory or materialization tables.** Such a clone would still address the original objects. Start a fresh isolated schema with a distinct deployment namespace and installation UUID, provision new destination grants, and import only the needed immutable Core facts. A restored replica of the same authority keeps its identity. Do not replace an identity while old write plans still exist. The adapter combines the UUID with your stable deployment namespace to avoid collisions between isolated schemas sharing a bucket.
 
 Core and managed stores must share the exact same PostgreSQL pool, and Core must enable `managedDelivery: true`. The factory probes both stores and the provider policy before returning an adapter. Hosts supply pool acquisition/connect timeouts; transactions started with a signal additionally limit lock and statement waits. Readiness is bounded by the operation deadline, at most 60 seconds.
 
 ```typescript
 import { Storage } from '@google-cloud/storage';
-import { createGcsReportingManagedDeliveryAdapterV1 } from '@adcp/sdk/reporting/gcs';
-import { createReportingManagedDeliveryRuntime } from '@adcp/sdk/reporting/ledger';
+import { createGcsReportingManagedDeliveryAdapterV1 } from '@adcp/reporting-storage/gcs';
+import { createReportingManagedDeliveryRuntime } from '@adcp/reporting-storage/managed';
 
 const adapter = await createGcsReportingManagedDeliveryAdapterV1({
   storage: new Storage(), // ADC/workload identity; no keys in reporting state

package/docs/guides/REPORTING-LEDGER-CUTOVER.md

@@ -3,7 +3,7 @@
 This guide is for a seller that already runs its own Reliable Reporting ledger
 (tables for configuration generations, obligations and revisions, row files in
 object storage and a warehouse, status issues and transitions) and wants
-`@adcp/sdk` to own the ledger from now on. Read the
+`@adcp/sdk` and `@adcp/reporting-storage` to own the ledger from now on. Read the
 [ledger guide](REPORTING-LEDGER.md) first for the SDK side, and the
 [operations runbook](REPORTING-OPERATIONS.md) for production practice.
 
@@ -28,7 +28,7 @@ You have two ways to run the SDK's service on top of what you have.
 | Change feed | `changeFeed: true`: `changesAfter`, current-revision reads, consumer cursors | You implement it, or go without host reads and the warehouse sink |
 | Retention | `maintenance.retention`: period-aligned retirement honouring the change-feed hold | You implement `retireExpiredPeriods` and tombstones, or never retire |
 | Maintenance | `maintenance`: snapshot sweep, abandoned-upload sweep, feed pruning | You write all of it |
-| Warehouse | `@adcp/sdk/reporting/bigquery` sink | Not available: it reads the SDK store |
+| Warehouse | `@adcp/reporting-storage/bigquery` sink | Not available: it reads the SDK store |
 | Correctness | Lease fencing, gap-free status checkpoints, immutable generations and the revision binding are enforced in one tested place | Every one of those guarantees is yours to prove |
 | Existing data | Starts empty; old tables stay behind a read-only hook | Old data served natively |
 
@@ -52,8 +52,8 @@ advertise Managed Delivery or Reconciled Billing today, read
 ```ts
 import { Pool } from 'pg';
 import { Storage } from '@google-cloud/storage';
-import { PostgresReportingLedgerStore } from '@adcp/sdk/reporting/ledger';
-import { createGcsReportingRowObjectProviderV1 } from '@adcp/sdk/reporting/gcs';
+import { PostgresReportingLedgerStore, reportingLedgerMaintenance } from '@adcp/reporting-storage';
+import { createGcsReportingRowObjectProviderV1 } from '@adcp/reporting-storage/gcs';
 import { createReliableReportingService } from '@adcp/sdk/reporting/service';
 
 // Apply once, in order, with your migration owner (PostgreSQL 13+):
@@ -86,10 +86,10 @@ const reporting = createReliableReportingService({
   statusRetentionDays: 90, // the commitment advertised to buyers; retention uses it
   // ...adapters, contact, resolveSource, resolveCurrency, resolveCoverage
   legacyRevisionReader, // see "The legacy fallback hook"
-  maintenance: {
+  maintenance: reportingLedgerMaintenance({
     retention: { enabled: true, recordRetentionDays: 120, limit: 100 },
     changeFeed: { changeRetentionDays: 30, maxFeedHoldDays: 7 },
-  },
+  }),
 });
 ```
 
@@ -118,7 +118,7 @@ state. The bytes live in your bucket.
 
 ### Keeping your BigQuery tables fed
 
-`@adcp/sdk/reporting/bigquery` follows the change feed and loads every
+`@adcp/reporting-storage/bigquery` follows the change feed and loads every
 committed revision's verified rows into BigQuery tables you name
 ([sink details](REPORTING-LEDGER.md#bigquery-warehouse-sink)). The warehouse
 copy is derived and never served.