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

package/dist/lib/wholesale-feed-sync/types.d.mts

@@ -1,5 +1,6 @@
 import type { SingleAgentClient } from '../core/SingleAgentClient.mjs';
-import type * as V31Beta from '../types/v3-1-beta/index.mjs';
+import type { AccountReference } from '../types/index.mjs';
+import type { LegacyWholesaleFeedEvent } from './protocol-types.mjs';
 /**
  * Operating mode for a {@link WholesaleFeedSync} instance, resolved from the
  * agent's capability stanza at `start()` time.
@@ -34,7 +35,7 @@ export interface WholesaleFeedSyncClient {
 /**
  * Configuration for a {@link WholesaleFeedSync} instance.
  *
- * The SDK's primary version pin (`ADCP_VERSION`) stays at GA; the wholesale
+ * The SDK's primary version pin (`ADCP_VERSION`) provides the wholesale
  * feed surfaces activate when the agent declares `wholesale_feed_versioning`
  * and/or `wholesale_feed_webhooks` in its `get_adcp_capabilities` response.
  * Against pre-3.1 agents the sync still works in `'manual'` mode — bootstrap
@@ -44,12 +45,12 @@ export interface WholesaleFeedSyncConfig {
     /** Pre-configured client (or stub) for tool calls against the target agent. */
     client: WholesaleFeedSyncClient;
     /**
-     * Account scope for wholesale product/signal reads. Beta 3 wholesale-feed
+     * Account scope for wholesale product/signal reads. Wholesale-feed
      * webhooks are account-anchored; pass the same account used when registering
      * `notification_configs[]` so repair reads reconcile the correct public or
      * account overlay.
      */
-    account?: V31Beta.AccountReference;
+    account?: AccountReference;
     /**
      * Expected inbound webhook subscription scope. Set this when routing a
      * validated webhook receiver into a WholesaleFeedSync instance so misrouted
@@ -155,43 +156,43 @@ export interface WholesaleFeedSyncEvents {
         to: WholesaleFeedSyncState;
     }];
     event: [{
-        event: V31Beta.WholesaleFeedEvent;
+        event: LegacyWholesaleFeedEvent;
         synthetic?: boolean;
     }];
     'product.created': [{
-        event: V31Beta.WholesaleFeedEvent;
+        event: LegacyWholesaleFeedEvent;
         synthetic?: boolean;
     }];
     'product.updated': [{
-        event: V31Beta.WholesaleFeedEvent;
+        event: LegacyWholesaleFeedEvent;
         synthetic?: boolean;
     }];
     'product.priced': [{
-        event: V31Beta.WholesaleFeedEvent;
+        event: LegacyWholesaleFeedEvent;
         synthetic?: boolean;
     }];
     'product.removed': [{
-        event: V31Beta.WholesaleFeedEvent;
+        event: LegacyWholesaleFeedEvent;
         synthetic?: boolean;
     }];
     'signal.created': [{
-        event: V31Beta.WholesaleFeedEvent;
+        event: LegacyWholesaleFeedEvent;
         synthetic?: boolean;
     }];
     'signal.updated': [{
-        event: V31Beta.WholesaleFeedEvent;
+        event: LegacyWholesaleFeedEvent;
         synthetic?: boolean;
     }];
     'signal.priced': [{
-        event: V31Beta.WholesaleFeedEvent;
+        event: LegacyWholesaleFeedEvent;
         synthetic?: boolean;
     }];
     'signal.removed': [{
-        event: V31Beta.WholesaleFeedEvent;
+        event: LegacyWholesaleFeedEvent;
         synthetic?: boolean;
     }];
     'wholesale_feed.bulk_change': [{
-        event: V31Beta.WholesaleFeedEvent;
+        event: LegacyWholesaleFeedEvent;
         synthetic?: boolean;
     }];
 }

package/dist/lib/wholesale-feed-sync/types.d.ts

@@ -1,5 +1,6 @@
 import type { SingleAgentClient } from '../core/SingleAgentClient';
-import type * as V31Beta from '../types/v3-1-beta';
+import type { AccountReference } from '../types';
+import type { LegacyWholesaleFeedEvent } from './protocol-types';
 /**
  * Operating mode for a {@link WholesaleFeedSync} instance, resolved from the
  * agent's capability stanza at `start()` time.
@@ -34,7 +35,7 @@ export interface WholesaleFeedSyncClient {
 /**
  * Configuration for a {@link WholesaleFeedSync} instance.
  *
- * The SDK's primary version pin (`ADCP_VERSION`) stays at GA; the wholesale
+ * The SDK's primary version pin (`ADCP_VERSION`) provides the wholesale
  * feed surfaces activate when the agent declares `wholesale_feed_versioning`
  * and/or `wholesale_feed_webhooks` in its `get_adcp_capabilities` response.
  * Against pre-3.1 agents the sync still works in `'manual'` mode — bootstrap
@@ -44,12 +45,12 @@ export interface WholesaleFeedSyncConfig {
     /** Pre-configured client (or stub) for tool calls against the target agent. */
     client: WholesaleFeedSyncClient;
     /**
-     * Account scope for wholesale product/signal reads. Beta 3 wholesale-feed
+     * Account scope for wholesale product/signal reads. Wholesale-feed
      * webhooks are account-anchored; pass the same account used when registering
      * `notification_configs[]` so repair reads reconcile the correct public or
      * account overlay.
      */
-    account?: V31Beta.AccountReference;
+    account?: AccountReference;
     /**
      * Expected inbound webhook subscription scope. Set this when routing a
      * validated webhook receiver into a WholesaleFeedSync instance so misrouted
@@ -155,43 +156,43 @@ export interface WholesaleFeedSyncEvents {
         to: WholesaleFeedSyncState;
     }];
     event: [{
-        event: V31Beta.WholesaleFeedEvent;
+        event: LegacyWholesaleFeedEvent;
         synthetic?: boolean;
     }];
     'product.created': [{
-        event: V31Beta.WholesaleFeedEvent;
+        event: LegacyWholesaleFeedEvent;
         synthetic?: boolean;
     }];
     'product.updated': [{
-        event: V31Beta.WholesaleFeedEvent;
+        event: LegacyWholesaleFeedEvent;
         synthetic?: boolean;
     }];
     'product.priced': [{
-        event: V31Beta.WholesaleFeedEvent;
+        event: LegacyWholesaleFeedEvent;
         synthetic?: boolean;
     }];
     'product.removed': [{
-        event: V31Beta.WholesaleFeedEvent;
+        event: LegacyWholesaleFeedEvent;
         synthetic?: boolean;
     }];
     'signal.created': [{
-        event: V31Beta.WholesaleFeedEvent;
+        event: LegacyWholesaleFeedEvent;
         synthetic?: boolean;
     }];
     'signal.updated': [{
-        event: V31Beta.WholesaleFeedEvent;
+        event: LegacyWholesaleFeedEvent;
         synthetic?: boolean;
     }];
     'signal.priced': [{
-        event: V31Beta.WholesaleFeedEvent;
+        event: LegacyWholesaleFeedEvent;
         synthetic?: boolean;
     }];
     'signal.removed': [{
-        event: V31Beta.WholesaleFeedEvent;
+        event: LegacyWholesaleFeedEvent;
         synthetic?: boolean;
     }];
     'wholesale_feed.bulk_change': [{
-        event: V31Beta.WholesaleFeedEvent;
+        event: LegacyWholesaleFeedEvent;
         synthetic?: boolean;
     }];
 }

package/dist/lib/wholesale-feed-sync/webhook-notification.d.mts

@@ -1,8 +1,8 @@
 import { ADCPError } from '../errors/index.mjs';
-import type * as V31Beta from '../types/v3-1-beta/index.mjs';
-export type WholesaleFeedWebhookNotificationType = V31Beta.WholesaleFeedWebhook['notification_type'];
+import type { LegacyWholesaleFeedEvent, LegacyWholesaleFeedWebhook } from './protocol-types.mjs';
+export type WholesaleFeedWebhookNotificationType = LegacyWholesaleFeedWebhook['notification_type'];
 export type WholesaleFeedWebhookAffectedEntityType = 'product' | 'signal';
-export type WholesaleFeedWebhookCacheScope = V31Beta.WholesaleFeedWebhook['cache_scope'];
+export type WholesaleFeedWebhookCacheScope = LegacyWholesaleFeedWebhook['cache_scope'];
 export type WholesaleFeedWebhookNotificationErrorCode = 'wholesale_feed_webhook_body_malformed' | 'wholesale_feed_webhook_field_missing' | 'wholesale_feed_webhook_field_invalid' | 'wholesale_feed_webhook_notification_type_mismatch' | 'wholesale_feed_webhook_entity_type_mismatch' | 'wholesale_feed_webhook_cache_scope_mismatch' | 'wholesale_feed_webhook_bulk_change_invalid';
 export interface WholesaleFeedWebhookNotificationErrorDetails {
     field?: string;
@@ -38,8 +38,8 @@ export interface NormalizedWholesaleFeedWebhookNotification {
     eventCreatedAt: string;
     /** Present for `wholesale_feed.bulk_change` notifications. */
     affectedEntityType?: WholesaleFeedWebhookAffectedEntityType;
-    event: V31Beta.WholesaleFeedEvent;
-    webhook: V31Beta.WholesaleFeedWebhook;
+    event: LegacyWholesaleFeedEvent;
+    webhook: LegacyWholesaleFeedWebhook;
 }
 /**
  * Parse and normalize a canonical wholesale-feed webhook notification.
@@ -51,3 +51,5 @@ export interface NormalizedWholesaleFeedWebhookNotification {
  */
 export declare function parseWholesaleFeedWebhookNotification(input: unknown): NormalizedWholesaleFeedWebhookNotification;
 export declare const normalizeWholesaleFeedWebhookNotification: typeof parseWholesaleFeedWebhookNotification;
+/** Validate only the product representation contract, without consuming dedupe state. */
+export declare function assertLegacyWholesaleFeedRepresentation(webhook: Record<string, unknown>): void;

package/dist/lib/wholesale-feed-sync/webhook-notification.d.ts

@@ -1,8 +1,8 @@
 import { ADCPError } from '../errors';
-import type * as V31Beta from '../types/v3-1-beta';
-export type WholesaleFeedWebhookNotificationType = V31Beta.WholesaleFeedWebhook['notification_type'];
+import type { LegacyWholesaleFeedEvent, LegacyWholesaleFeedWebhook } from './protocol-types';
+export type WholesaleFeedWebhookNotificationType = LegacyWholesaleFeedWebhook['notification_type'];
 export type WholesaleFeedWebhookAffectedEntityType = 'product' | 'signal';
-export type WholesaleFeedWebhookCacheScope = V31Beta.WholesaleFeedWebhook['cache_scope'];
+export type WholesaleFeedWebhookCacheScope = LegacyWholesaleFeedWebhook['cache_scope'];
 export type WholesaleFeedWebhookNotificationErrorCode = 'wholesale_feed_webhook_body_malformed' | 'wholesale_feed_webhook_field_missing' | 'wholesale_feed_webhook_field_invalid' | 'wholesale_feed_webhook_notification_type_mismatch' | 'wholesale_feed_webhook_entity_type_mismatch' | 'wholesale_feed_webhook_cache_scope_mismatch' | 'wholesale_feed_webhook_bulk_change_invalid';
 export interface WholesaleFeedWebhookNotificationErrorDetails {
     field?: string;
@@ -38,8 +38,8 @@ export interface NormalizedWholesaleFeedWebhookNotification {
     eventCreatedAt: string;
     /** Present for `wholesale_feed.bulk_change` notifications. */
     affectedEntityType?: WholesaleFeedWebhookAffectedEntityType;
-    event: V31Beta.WholesaleFeedEvent;
-    webhook: V31Beta.WholesaleFeedWebhook;
+    event: LegacyWholesaleFeedEvent;
+    webhook: LegacyWholesaleFeedWebhook;
 }
 /**
  * Parse and normalize a canonical wholesale-feed webhook notification.
@@ -51,3 +51,5 @@ export interface NormalizedWholesaleFeedWebhookNotification {
  */
 export declare function parseWholesaleFeedWebhookNotification(input: unknown): NormalizedWholesaleFeedWebhookNotification;
 export declare const normalizeWholesaleFeedWebhookNotification: typeof parseWholesaleFeedWebhookNotification;
+/** Validate only the product representation contract, without consuming dedupe state. */
+export declare function assertLegacyWholesaleFeedRepresentation(webhook: Record<string, unknown>): void;

package/dist/lib/wholesale-feed-sync/webhook-notification.js

@@ -19,6 +19,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var webhook_notification_exports = {};
 __export(webhook_notification_exports, {
   WholesaleFeedWebhookNotificationError: () => WholesaleFeedWebhookNotificationError,
+  assertLegacyWholesaleFeedRepresentation: () => assertLegacyWholesaleFeedRepresentation,
   normalizeWholesaleFeedWebhookNotification: () => normalizeWholesaleFeedWebhookNotification,
   parseWholesaleFeedWebhookNotification: () => parseWholesaleFeedWebhookNotification
 });
@@ -57,6 +58,7 @@ function parseWholesaleFeedWebhookNotification(input) {
   const wholesaleFeedVersion = readRequiredString(webhook, "wholesale_feed_version");
   const previousWholesaleFeedVersion = readOptionalString(webhook, "previous_wholesale_feed_version");
   const cacheScope = readCacheScope(readRequiredString(webhook, "cache_scope"), "cache_scope");
+  assertLegacyWholesaleFeedRepresentation(webhook);
   const eventId = readRequiredString(event, "event.event_id");
   if (notificationId !== eventId) {
     throw new WholesaleFeedWebhookNotificationError(
@@ -225,11 +227,13 @@ function validatePayloadForEvent(notificationType, entityId, payload) {
     case "product.created":
     case "product.updated": {
       assertEntityIdMatchesPayload(entityId, readRequiredString(payload, "event.payload.product_id"), "product_id");
+      rejectCanonicalPayloadField(payload, "canonical_product");
       readRequiredRecord(payload, "event.payload.product");
       return void 0;
     }
     case "product.priced": {
       assertEntityIdMatchesPayload(entityId, readRequiredString(payload, "event.payload.product_id"), "product_id");
+      rejectCanonicalPayloadField(payload, "canonical_pricing_options");
       readRequiredNonEmptyArray(payload, "event.payload.pricing_options");
       return void 0;
     }
@@ -270,6 +274,46 @@ function validatePayloadForEvent(notificationType, entityId, payload) {
       return readBulkChangeAffectedEntityType(payload);
   }
 }
+function assertLegacyProductPayloadView(notificationType, productPayloadView) {
+  const isProductEvent = notificationType.startsWith("product.");
+  if (isProductEvent && (productPayloadView === void 0 || productPayloadView === "legacy")) return;
+  if (!isProductEvent && productPayloadView === void 0) return;
+  throw new WholesaleFeedWebhookNotificationError(
+    "wholesale_feed_webhook_field_invalid",
+    isProductEvent ? 'WholesaleFeedSync supports only product_payload_view "legacy".' : "Non-product wholesale-feed webhooks must omit product_payload_view.",
+    {
+      field: "product_payload_view",
+      expected: isProductEvent ? ["legacy"] : ["absent"],
+      actual: productPayloadView
+    }
+  );
+}
+function assertLegacyWholesaleFeedRepresentation(webhook) {
+  const notificationType = webhook.notification_type;
+  if (typeof notificationType !== "string" || !WHOLESALE_FEED_NOTIFICATION_TYPES.has(notificationType))
+    return;
+  const productPayloadView = readOptionalString(webhook, "product_payload_view");
+  assertLegacyProductPayloadView(notificationType, productPayloadView);
+  if (!notificationType.startsWith("product.")) return;
+  const event = webhook.event;
+  if (!event || typeof event !== "object" || Array.isArray(event)) return;
+  const payload = event.payload;
+  if (!payload || typeof payload !== "object" || Array.isArray(payload)) return;
+  const payloadRecord = payload;
+  if (notificationType === "product.created" || notificationType === "product.updated") {
+    rejectCanonicalPayloadField(payloadRecord, "canonical_product");
+  } else if (notificationType === "product.priced") {
+    rejectCanonicalPayloadField(payloadRecord, "canonical_pricing_options");
+  }
+}
+function rejectCanonicalPayloadField(payload, field) {
+  if (!Object.prototype.hasOwnProperty.call(payload, field)) return;
+  throw new WholesaleFeedWebhookNotificationError(
+    "wholesale_feed_webhook_field_invalid",
+    `WholesaleFeedSync legacy product view does not accept event.payload.${field}.`,
+    { field: `event.payload.${field}`, expected: "absent", actual: payload[field] }
+  );
+}
 function assertEntityIdMatchesPayload(entityId, payloadEntityId, payloadField) {
   if (entityId === payloadEntityId) return;
   throw new WholesaleFeedWebhookNotificationError(
@@ -302,6 +346,7 @@ function describeValue(value) {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   WholesaleFeedWebhookNotificationError,
+  assertLegacyWholesaleFeedRepresentation,
   normalizeWholesaleFeedWebhookNotification,
   parseWholesaleFeedWebhookNotification
 });

package/dist/lib/wholesale-feed-sync/webhook-notification.mjs

@@ -32,6 +32,7 @@ function parseWholesaleFeedWebhookNotification(input) {
   const wholesaleFeedVersion = readRequiredString(webhook, "wholesale_feed_version");
   const previousWholesaleFeedVersion = readOptionalString(webhook, "previous_wholesale_feed_version");
   const cacheScope = readCacheScope(readRequiredString(webhook, "cache_scope"), "cache_scope");
+  assertLegacyWholesaleFeedRepresentation(webhook);
   const eventId = readRequiredString(event, "event.event_id");
   if (notificationId !== eventId) {
     throw new WholesaleFeedWebhookNotificationError(
@@ -200,11 +201,13 @@ function validatePayloadForEvent(notificationType, entityId, payload) {
     case "product.created":
     case "product.updated": {
       assertEntityIdMatchesPayload(entityId, readRequiredString(payload, "event.payload.product_id"), "product_id");
+      rejectCanonicalPayloadField(payload, "canonical_product");
       readRequiredRecord(payload, "event.payload.product");
       return void 0;
     }
     case "product.priced": {
       assertEntityIdMatchesPayload(entityId, readRequiredString(payload, "event.payload.product_id"), "product_id");
+      rejectCanonicalPayloadField(payload, "canonical_pricing_options");
       readRequiredNonEmptyArray(payload, "event.payload.pricing_options");
       return void 0;
     }
@@ -245,6 +248,46 @@ function validatePayloadForEvent(notificationType, entityId, payload) {
       return readBulkChangeAffectedEntityType(payload);
   }
 }
+function assertLegacyProductPayloadView(notificationType, productPayloadView) {
+  const isProductEvent = notificationType.startsWith("product.");
+  if (isProductEvent && (productPayloadView === void 0 || productPayloadView === "legacy")) return;
+  if (!isProductEvent && productPayloadView === void 0) return;
+  throw new WholesaleFeedWebhookNotificationError(
+    "wholesale_feed_webhook_field_invalid",
+    isProductEvent ? 'WholesaleFeedSync supports only product_payload_view "legacy".' : "Non-product wholesale-feed webhooks must omit product_payload_view.",
+    {
+      field: "product_payload_view",
+      expected: isProductEvent ? ["legacy"] : ["absent"],
+      actual: productPayloadView
+    }
+  );
+}
+function assertLegacyWholesaleFeedRepresentation(webhook) {
+  const notificationType = webhook.notification_type;
+  if (typeof notificationType !== "string" || !WHOLESALE_FEED_NOTIFICATION_TYPES.has(notificationType))
+    return;
+  const productPayloadView = readOptionalString(webhook, "product_payload_view");
+  assertLegacyProductPayloadView(notificationType, productPayloadView);
+  if (!notificationType.startsWith("product.")) return;
+  const event = webhook.event;
+  if (!event || typeof event !== "object" || Array.isArray(event)) return;
+  const payload = event.payload;
+  if (!payload || typeof payload !== "object" || Array.isArray(payload)) return;
+  const payloadRecord = payload;
+  if (notificationType === "product.created" || notificationType === "product.updated") {
+    rejectCanonicalPayloadField(payloadRecord, "canonical_product");
+  } else if (notificationType === "product.priced") {
+    rejectCanonicalPayloadField(payloadRecord, "canonical_pricing_options");
+  }
+}
+function rejectCanonicalPayloadField(payload, field) {
+  if (!Object.prototype.hasOwnProperty.call(payload, field)) return;
+  throw new WholesaleFeedWebhookNotificationError(
+    "wholesale_feed_webhook_field_invalid",
+    `WholesaleFeedSync legacy product view does not accept event.payload.${field}.`,
+    { field: `event.payload.${field}`, expected: "absent", actual: payload[field] }
+  );
+}
 function assertEntityIdMatchesPayload(entityId, payloadEntityId, payloadField) {
   if (entityId === payloadEntityId) return;
   throw new WholesaleFeedWebhookNotificationError(
@@ -276,6 +319,7 @@ function describeValue(value) {
 }
 export {
   WholesaleFeedWebhookNotificationError,
+  assertLegacyWholesaleFeedRepresentation,
   normalizeWholesaleFeedWebhookNotification,
   parseWholesaleFeedWebhookNotification
 };

package/docs/CLI.md

@@ -320,7 +320,7 @@ Useful flags:
 
 - `--storyboards ID,...`: Run specific storyboard or bundle IDs instead of capability-driven selection
 - `--tracks core,products,...`: Restrict the run to specific tracks
-- `--compliance-version VERSION`: Select the compliance cache/spec line, for example `3.0.12` or `3.1.0-beta.7`; use the same flag with `storyboard list`, `show`, and `step` when reproducing a pinned run
+- `--compliance-version VERSION`: Select a packaged compliance cache/spec line, for example `3.1.18` or `3.2.0-rc.3`; use the same flag with `storyboard list`, `show`, and `step` when reproducing a pinned run
 - `--compliance-dir PATH`: Use a specific compliance cache directory, mainly for local protocol/cache development
 - `--brief TEXT`: Override the default sample discovery brief
 - `--dry-run`: Preview steps without executing

package/docs/TYPE-SUMMARY.md

@@ -1,10 +1,24 @@
 # AdCP Type Summary
 
-> Generated at: 2026-09-15
-> @adcp/sdk v14.0.0-rc.37
+> Generated at: 2026-09-18
+> @adcp/sdk v14.0.0-rc.39
 
 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`.
 
+## MediaBuy Action Assessment Types
+
+Use `@adcp/sdk/media-buy/actions` for pure buyer assessment and `@adcp/sdk/server` for `mediaBuyActionResolver`. See [action assessment guide](guides/MEDIA-BUY-ACTION-ASSESSMENT.md).
+
+| Type | Use |
+| --- | --- |
+| `MediaBuyTask` | Narrow routing union: `update_media_buy`, `control_media_buy`, `refine_proposals`, `sync_creatives`. |
+| `ActionAvailability` | `available_now` with optional `nonDefaultRoute`, mode and authority; or `currently_unavailable` with reason, certainty and optional compatibility/constraint detail. |
+| `ActionBuy`, `ActionProduct`, `ActionProposal` | Structural inputs for joining current accepted terms with live actions and advisory products. |
+| `LiveMediaBuyAction` | Readable canonical or legacy entry for assessment, projection and existing preflight helpers, including rc.3 package scope. |
+| `MediaBuyAvailableAction`, `MediaBuyValidAction` | Generated legacy wire entry / deprecated flat vocabulary; distinct from canonical helper entries. |
+| `MediaBuyAction`, `MediaBuyActionId` | Action identifiers accepted by assessment / mutation helpers; runtime validation preserves unknown future data. |
+| `ProposalChangeTerm`, `ChangeTermConstraints` | Negotiated term view and portable discriminated budget / flight / package-count / effective-timing constraints. |
+
 ## Client Types
 
 ```typescript
@@ -41,12 +55,24 @@ interface TransportOptions {
 interface TaskOptions {
   timeout?: number;             // Absolute whole-task deadline
   signal?: AbortSignal;         // Caller cancellation
+  // Direct A2A mutation route, bound to authenticated principal + account scope.
+  durableContinuationRecovery?: { ownerScope: string };
   // Trusted local receiver policy; snapshotted and persisted with generated
   // webhook registrations, never inferred from or sent in task arguments.
   delegatedOperatorAuthorization?: DelegatedOperatorAuthorizationContext;
   // ...deadline, cancellation, transport, and conversation options...
 }
 
+interface DeferredContinuation<T> {
+  token: string;
+  question?: string;
+  resume(input: unknown): Promise<TaskResult<T>>;
+  recovery?: { operationId: string; recoveryKey: string }; // Host-only, persist once
+}
+
+// AgentClient public direct-mutation route recovery
+agent.recoverDirectPauseContinuation<T>({ operationId, recoveryKey, ownerScope });
+
 interface ValidateAdAgentsOptions {
   timeoutMs?: number;           // Per-request ceiling
   signal?: AbortSignal;         // One signal/deadline across the complete discovery flow
@@ -2799,6 +2825,14 @@ interface ReportingSourceStagedObjectReaderV1 {
 type ReportingSourceExecutorResultV1 =
   | { ok: true; response: ReportingSourceExecutionResponseV1; manifestBytes: Uint8Array }
   | { ok: false; error: ReportingSourceErrorV1 };
+type InlineReportingMetricEvidenceV1 =
+  | { constituent_id: string; metric: string; status: 'present' | 'explicit_zero'; data_through: string }
+  | { constituent_id: string; metric: string; status: 'unsupported' | 'delayed' | 'partial' | 'stale' | 'missing'; reason: string; data_through?: string };
+interface InlineReportingAvailabilityEvidenceV1 {
+  version: '1.0';
+  cells: readonly InlineReportingMetricEvidenceV1[];
+}
+// Inline callback requests include constituents: { constituent_id, media_buy_id }[]; evidence-bearing responses add availability_evidence.
 // validateReportingSourceExecutionV1({ level, capabilities, request, result, objectReader })
 // runReportingSourceReplayConformanceV1({ level, executor, request, objectReader })
 // validateReportingRevisionSequenceV1(manifests, { crossFinalityBridge })
@@ -2809,11 +2843,41 @@ type ReportingSourceExecutorResultV1 =
 
 ## Seller Reporting Ledger
 
-Import from `@adcp/sdk/reporting/ledger`.
+Ledger symbols import from `@adcp/sdk/reporting/ledger`; `createPostgresPersistentNotificationRuntime` is a server symbol and imports from `@adcp/sdk/server`.
 
 ```typescript
-const store = new PostgresReportingLedgerStore(pool, { acknowledgeIsolatedDatabase: true });
+// 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({
+  db: pool,
+  namespace: 'seller-production',
+});
+const notifications = createPostgresPersistentNotificationRuntime({
+  db: pool,
+  publisherScope: 'seller-production',
+  checkpointDeliveryAttempt: attemptCheckpoint,
+  subscriptions: { acknowledgeIsolatedDatabase: true },
+  ...notificationOptions,
+});
+const reportingActivity = createPostgresReportingNotificationActivityRuntime({
+  db: pool,
+  notifications,
+  namespace: 'seller-production',
+  attemptCheckpoint,
+  tenantScopeForAccount: accountId => trustedTenantDirectory.tenantFor(accountId),
+});
+
+// One store, wired to the activity port, used by every participant below.
+const store = new PostgresReportingLedgerStore(pool, {
+  acknowledgeIsolatedDatabase: true,
+  notificationActivityPort: reportingActivity.port,
+});
+
+// Every migration this wiring needs, before probing.
 await pool.query(REPORTING_LEDGER_MIGRATION);
+for (const sql of notifications.migrations.all) await pool.query(sql);
+for (const sql of reportingActivity.migrations.all) await pool.query(sql);
+
 const producer = createReportingProducer({ store, source, offerings, contact });
 await producer.planObligations();
 await producer.runWorker();
@@ -2824,10 +2888,60 @@ const getMediaBuyDelivery = createReportingDeliveryHandler(store); // exact repo
 const syncReportingStatus = createSyncReportingStatusHandler(store, {
   resolveConsumerId: context => context.agent.agent_url,
 });
+
+await reportingActivity.probe();
+// Run repeatedly from a durable scheduler; this call is bounded.
+await reportingActivity.recoverOnce({ ownerToken: stableWorkerId });
+const activityPage = await reportingActivity.listActivity({
+  tenantId: trustedTenant,
+  accountId: resolvedAccountId,
+  limit: 100,
+});
 ```
 
 The store freezes configuration lineage and period-end denominators, retains immutable RFC 8785 JCS/SHA-256-bound revisions, atomically fences lifecycle projections against their revision evidence, and provides leased production plus snapshot-stable status pagination. `projectReportingObligationHealthV1` implements waiting, healthy, delayed, action_required, and complete without I/O.
 
+`ReportingLedgerNotificationActivityPortV1<TTransaction>` is the custom-store seam. Invoke it inside the authoritative transition transaction and fence both predecessor health and finality. The bundled PostgreSQL runtime persists exactly-once intent plus paginatable account activity, then projects health changes through `PersistentNotificationRuntime`; finality-only changes remain internal activity. It never owns subscriber credentials or sends webhooks itself. `listActivity()` is adopter-facing only because no public AdCP account-activity read task exists.
+
+## Reliable Reporting Service
+
+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
+interface ReliableReportingAdapterV1 {
+  readonly sourceOffering: ReportingSourceOfferingV1;
+  readonly deliveryOffering: ReportingDeliveryOffering;
+  // Exactly one of fetchSlice or executor.
+  readonly fetchSlice?: InlineReportingDeliveryFetchV1;
+  readonly executor?: ReportingSourceWithReaderV1;
+  // Opt-in bounded replay window for the inline executor; never applied
+  // silently. A feed that outlives its replay ceiling needs this or a
+  // durable executor.
+  readonly inlineReplayRetention?: InlineReportingReplayRetentionV1;
+}
+
+const reporting = createReliableReportingService({
+  store,
+  adapters,
+  contact,
+  automatedRecoveryWindowSeconds,
+  statusRetentionDays, // enforce this commitment in the ledger database
+  resolveSource: account => ({ adapterId, sourceScope, sourceTimezone }),
+  resolveCurrency: account => currency,
+  resolveCoverage: account => ({ constituents }), // authorized media-buy/package denominator
+  resolveConsumerId, // optional; controls consumer-status handler/capability
+});
+
+await pool.query(reporting.setup.migrations[0]);
+const installedPlatform = reporting.install(platform);
+await reporting.installConfiguration(configuration, { account: ctx.account });
+await reporting.runCycle({ accountId }); // tenant-partitioned
+reporting.start({ intervalMilliseconds, deploymentWide: true }); // explicit full-ledger scan
+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.
+
 ## Key Enums
 
 | Enum | Values |