@adcp/sdk 15.2.2 → 15.4.0

package/dist/lib/core/ConversationTypes.d.mts

@@ -121,6 +121,11 @@ export type WebhookUrlTemplate = string | {
  * Options for task execution
  */
 export interface TaskOptions {
+    /**
+     * Skip inline completion status handlers for this call and its continuations.
+     * Defaults to false. Independently delivered webhook handlers are unaffected.
+     */
+    skipStatusHandlers?: boolean;
     /**
      * Absolute wall-clock deadline for the entire SDK task call (ms), including
      * discovery and capability/version preflight. Unlike `workingTimeout`, this

package/dist/lib/core/ConversationTypes.d.ts

@@ -121,6 +121,11 @@ export type WebhookUrlTemplate = string | {
  * Options for task execution
  */
 export interface TaskOptions {
+    /**
+     * Skip inline completion status handlers for this call and its continuations.
+     * Defaults to false. Independently delivered webhook handlers are unaffected.
+     */
+    skipStatusHandlers?: boolean;
     /**
      * Absolute wall-clock deadline for the entire SDK task call (ms), including
      * discovery and capability/version preflight. Unlike `workingTimeout`, this

package/dist/lib/core/SingleAgentClient.d.mts

@@ -9,7 +9,7 @@ type TaskStatusUpdateEvent = Record<string, any>;
 import type { InputHandler, Message, TaskOptions, TaskResult, ConversationConfig, TaskInfo, TaskState, WebhookUrlTemplate, DirectPauseRecoveryRequest } from './ConversationTypes.mjs';
 import type { AdcpTaskName, TaskRequestFor, TaskResponseTypeMap } from './AgentClient.mjs';
 import type { DeferredTaskStorage } from '../storage/interfaces.mjs';
-import type { Activity, AsyncHandlerConfig } from './AsyncHandler.mjs';
+import type { Activity, AsyncHandlerConfig, WebhookMetadata } from './AsyncHandler.mjs';
 import { type WebhookHeaderValue, type WebhookHeadersLike } from '../webhooks/index.mjs';
 import { type WebhookRegistration, type WebhookRegistrationStore } from './webhook-registration.mjs';
 import { type ReplayStore, type RevocationStore, type JwksResolver, type WebhookSignatureErrorCode, type ResolvedAgentJwksResolverOptions } from '../signing/server.mjs';
@@ -191,6 +191,11 @@ export declare class WebhookDispatchError extends Error {
     readonly cause?: unknown;
     constructor(code: WebhookParseErrorCode, message: string, cause?: unknown);
 }
+/** Context for an isolated inline completion status-handler failure. */
+export interface StatusHandlerErrorContext {
+    handlerName: keyof AsyncHandlerConfig;
+    metadata: WebhookMetadata;
+}
 /**
  * Configuration for SingleAgentClient (and multi-agent client)
  */
@@ -266,8 +271,21 @@ export interface SingleAgentClientConfig extends ConversationConfig {
      * For at-least-once webhook delivery, set `handlers.webhookDedup` to
      * drop duplicate retries by `idempotency_key`. See
      * `docs/guides/PUSH-NOTIFICATION-CONFIG.md#deduplication`.
+     * For per-call skipping and inline error isolation, see
+     * `docs/guides/PUSH-NOTIFICATION-CONFIG.md#inline-completion-handlers`.
      */
     handlers?: AsyncHandlerConfig;
+    /**
+     * Return successful completed results even if an inline status handler throws.
+     * Defaults to false, preserving handler rejection and durable finalization retry.
+     * Does not change webhook error handling or cancellation behavior.
+     */
+    isolateStatusHandlerErrors?: boolean;
+    /**
+     * Reports inline status-handler errors when isolateStatusHandlerErrors is true.
+     * Errors thrown by this observer are recorded as warnings and do not reject the task.
+     */
+    onStatusHandlerError?: (error: unknown, context: StatusHandlerErrorContext) => void | Promise<void>;
     /** Select legacy HMAC-SHA256 push verification. Omit to use RFC 9421. */
     webhookSecret?: string;
     /** Durable provenance for outbound push registrations. Defaults to process-local memory. */

package/dist/lib/core/SingleAgentClient.d.ts

@@ -9,7 +9,7 @@ type TaskStatusUpdateEvent = Record<string, any>;
 import type { InputHandler, Message, TaskOptions, TaskResult, ConversationConfig, TaskInfo, TaskState, WebhookUrlTemplate, DirectPauseRecoveryRequest } from './ConversationTypes';
 import type { AdcpTaskName, TaskRequestFor, TaskResponseTypeMap } from './AgentClient';
 import type { DeferredTaskStorage } from '../storage/interfaces';
-import type { Activity, AsyncHandlerConfig } from './AsyncHandler';
+import type { Activity, AsyncHandlerConfig, WebhookMetadata } from './AsyncHandler';
 import { type WebhookHeaderValue, type WebhookHeadersLike } from '../webhooks';
 import { type WebhookRegistration, type WebhookRegistrationStore } from './webhook-registration';
 import { type ReplayStore, type RevocationStore, type JwksResolver, type WebhookSignatureErrorCode, type ResolvedAgentJwksResolverOptions } from '../signing/server';
@@ -191,6 +191,11 @@ export declare class WebhookDispatchError extends Error {
     readonly cause?: unknown;
     constructor(code: WebhookParseErrorCode, message: string, cause?: unknown);
 }
+/** Context for an isolated inline completion status-handler failure. */
+export interface StatusHandlerErrorContext {
+    handlerName: keyof AsyncHandlerConfig;
+    metadata: WebhookMetadata;
+}
 /**
  * Configuration for SingleAgentClient (and multi-agent client)
  */
@@ -266,8 +271,21 @@ export interface SingleAgentClientConfig extends ConversationConfig {
      * For at-least-once webhook delivery, set `handlers.webhookDedup` to
      * drop duplicate retries by `idempotency_key`. See
      * `docs/guides/PUSH-NOTIFICATION-CONFIG.md#deduplication`.
+     * For per-call skipping and inline error isolation, see
+     * `docs/guides/PUSH-NOTIFICATION-CONFIG.md#inline-completion-handlers`.
      */
     handlers?: AsyncHandlerConfig;
+    /**
+     * Return successful completed results even if an inline status handler throws.
+     * Defaults to false, preserving handler rejection and durable finalization retry.
+     * Does not change webhook error handling or cancellation behavior.
+     */
+    isolateStatusHandlerErrors?: boolean;
+    /**
+     * Reports inline status-handler errors when isolateStatusHandlerErrors is true.
+     * Errors thrown by this observer are recorded as warnings and do not reject the task.
+     */
+    onStatusHandlerError?: (error: unknown, context: StatusHandlerErrorContext) => void | Promise<void>;
     /** Select legacy HMAC-SHA256 push verification. Omit to use RFC 9421. */
     webhookSecret?: string;
     /** Durable provenance for outbound push registrations. Defaults to process-local memory. */

package/dist/lib/core/SingleAgentClient.js

@@ -240,7 +240,7 @@ const WEBHOOK_JWKS_RESOLVER_LIMIT = 1024;
 function isDeferredClientFinalizationContext(value) {
   if (!value || typeof value !== "object" || Array.isArray(value)) return false;
   const context = value;
-  return context.kind === "single-agent" && typeof context.taskType === "string" && typeof context.canonical === "boolean" && !!context.productPolicyRequest && typeof context.productPolicyRequest === "object" && !Array.isArray(context.productPolicyRequest) && (context.serverVersion === void 0 || context.serverVersion === "v2" || context.serverVersion === "v3") && (context.serverVersionSynthetic === void 0 || typeof context.serverVersionSynthetic === "boolean") && (context.projectionCatalogs === void 0 || Array.isArray(context.projectionCatalogs)) && (context.handlerName === void 0 || typeof context.handlerName === "string");
+  return context.kind === "single-agent" && typeof context.taskType === "string" && typeof context.canonical === "boolean" && !!context.productPolicyRequest && typeof context.productPolicyRequest === "object" && !Array.isArray(context.productPolicyRequest) && (context.serverVersion === void 0 || context.serverVersion === "v2" || context.serverVersion === "v3") && (context.serverVersionSynthetic === void 0 || typeof context.serverVersionSynthetic === "boolean") && (context.projectionCatalogs === void 0 || Array.isArray(context.projectionCatalogs)) && (context.handlerName === void 0 || typeof context.handlerName === "string") && (context.skipStatusHandlers === void 0 || typeof context.skipStatusHandlers === "boolean");
 }
 const CANONICAL_PACKAGE_ROUTE_TASKS = /* @__PURE__ */ new Set(["create_media_buy", "update_media_buy", "get_media_buys"]);
 const canonicalCreativeRoutingSnapshots = /* @__PURE__ */ new WeakSet();
@@ -3189,7 +3189,10 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
       ...projectionCatalogs !== void 0 && { projectionCatalogs },
       ...routingSnapshot !== void 0 && { routingSnapshot },
       ...effectiveOptions?.taskId !== void 0 && { optionTaskId: effectiveOptions.taskId },
-      ...effectiveOptions?.contextId !== void 0 && { optionContextId: effectiveOptions.contextId }
+      ...effectiveOptions?.contextId !== void 0 && { optionContextId: effectiveOptions.contextId },
+      ...effectiveOptions?.skipStatusHandlers !== void 0 && {
+        skipStatusHandlers: effectiveOptions.skipStatusHandlers
+      }
     };
     let result = await canonicalCreativeExecutionStorage.run(
       {
@@ -3300,7 +3303,8 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
     const resumedOptions = {
       ...options ?? {},
       ...context.optionTaskId !== void 0 && { taskId: context.optionTaskId },
-      ...context.optionContextId !== void 0 && { contextId: context.optionContextId }
+      ...context.optionContextId !== void 0 && { contextId: context.optionContextId },
+      ...context.skipStatusHandlers !== void 0 && { skipStatusHandlers: context.skipStatusHandlers }
     };
     const rawDeferredResume = result.deferred?.resume;
     const rawSubmittedWaitForCompletion = result.submitted?.waitForCompletion;
@@ -3390,11 +3394,12 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
     return finalized;
   }
   async notifyCompletedStatusHandler(result, taskType, handlerName, options) {
-    if (result.status !== "completed" || !result.success || !this.asyncHandler) return;
+    if (options?.skipStatusHandlers === true || result.status !== "completed" || !result.success || !this.asyncHandler)
+      return;
     const handler = this.config.handlers?.[handlerName];
     if (!handler) return;
     (0, import_abort2.throwIfAborted)(options?.signal);
-    await handler(result.data, {
+    const metadata = {
       operation_id: options?.contextId || "sync",
       context_id: options?.contextId,
       task_id: result.metadata.taskId,
@@ -3402,7 +3407,30 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
       task_type: taskType,
       status: result.status,
       timestamp: (/* @__PURE__ */ new Date()).toISOString()
-    });
+    };
+    try {
+      await handler(result.data, metadata);
+    } catch (error) {
+      if (this.config.isolateStatusHandlerErrors !== true) throw error;
+      (0, import_abort2.throwIfAborted)(options?.signal);
+      result.debug_logs = [
+        ...result.debug_logs ?? [],
+        {
+          level: "warn",
+          timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+          message: "Inline status handler failed. The seller operation completed; reconcile local post-processing."
+        }
+      ];
+      try {
+        await this.config.onStatusHandlerError?.(error, { handlerName, metadata });
+      } catch {
+        result.debug_logs.push({
+          level: "warn",
+          timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+          message: "onStatusHandlerError observer failed. The seller operation completed."
+        });
+      }
+    }
     (0, import_abort2.throwIfAborted)(options?.signal);
   }
   canonicalCreativeInputHandler(taskType, inputHandler, canonical = CANONICAL_CREATIVE_ACTIVITY_TASKS.has(taskType)) {
@@ -5678,7 +5706,10 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
         productPolicyRequest: productPolicyRequestSnapshot(normalizedParams),
         accountRegistry: this.accountRegistryContext(taskName, normalizedParams, effectiveOptions),
         ...effectiveOptions?.taskId !== void 0 && { optionTaskId: effectiveOptions.taskId },
-        ...effectiveOptions?.contextId !== void 0 && { optionContextId: effectiveOptions.contextId }
+        ...effectiveOptions?.contextId !== void 0 && { optionContextId: effectiveOptions.contextId },
+        ...effectiveOptions?.skipStatusHandlers !== void 0 && {
+          skipStatusHandlers: effectiveOptions.skipStatusHandlers
+        }
       };
       let result = await this.executor.executeTask(
         agent,

package/dist/lib/core/SingleAgentClient.mjs

@@ -310,7 +310,7 @@ const WEBHOOK_JWKS_RESOLVER_LIMIT = 1024;
 function isDeferredClientFinalizationContext(value) {
   if (!value || typeof value !== "object" || Array.isArray(value)) return false;
   const context = value;
-  return context.kind === "single-agent" && typeof context.taskType === "string" && typeof context.canonical === "boolean" && !!context.productPolicyRequest && typeof context.productPolicyRequest === "object" && !Array.isArray(context.productPolicyRequest) && (context.serverVersion === void 0 || context.serverVersion === "v2" || context.serverVersion === "v3") && (context.serverVersionSynthetic === void 0 || typeof context.serverVersionSynthetic === "boolean") && (context.projectionCatalogs === void 0 || Array.isArray(context.projectionCatalogs)) && (context.handlerName === void 0 || typeof context.handlerName === "string");
+  return context.kind === "single-agent" && typeof context.taskType === "string" && typeof context.canonical === "boolean" && !!context.productPolicyRequest && typeof context.productPolicyRequest === "object" && !Array.isArray(context.productPolicyRequest) && (context.serverVersion === void 0 || context.serverVersion === "v2" || context.serverVersion === "v3") && (context.serverVersionSynthetic === void 0 || typeof context.serverVersionSynthetic === "boolean") && (context.projectionCatalogs === void 0 || Array.isArray(context.projectionCatalogs)) && (context.handlerName === void 0 || typeof context.handlerName === "string") && (context.skipStatusHandlers === void 0 || typeof context.skipStatusHandlers === "boolean");
 }
 const CANONICAL_PACKAGE_ROUTE_TASKS = /* @__PURE__ */ new Set(["create_media_buy", "update_media_buy", "get_media_buys"]);
 const canonicalCreativeRoutingSnapshots = /* @__PURE__ */ new WeakSet();
@@ -3259,7 +3259,10 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
       ...projectionCatalogs !== void 0 && { projectionCatalogs },
       ...routingSnapshot !== void 0 && { routingSnapshot },
       ...effectiveOptions?.taskId !== void 0 && { optionTaskId: effectiveOptions.taskId },
-      ...effectiveOptions?.contextId !== void 0 && { optionContextId: effectiveOptions.contextId }
+      ...effectiveOptions?.contextId !== void 0 && { optionContextId: effectiveOptions.contextId },
+      ...effectiveOptions?.skipStatusHandlers !== void 0 && {
+        skipStatusHandlers: effectiveOptions.skipStatusHandlers
+      }
     };
     let result = await canonicalCreativeExecutionStorage.run(
       {
@@ -3370,7 +3373,8 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
     const resumedOptions = {
       ...options ?? {},
       ...context.optionTaskId !== void 0 && { taskId: context.optionTaskId },
-      ...context.optionContextId !== void 0 && { contextId: context.optionContextId }
+      ...context.optionContextId !== void 0 && { contextId: context.optionContextId },
+      ...context.skipStatusHandlers !== void 0 && { skipStatusHandlers: context.skipStatusHandlers }
     };
     const rawDeferredResume = result.deferred?.resume;
     const rawSubmittedWaitForCompletion = result.submitted?.waitForCompletion;
@@ -3460,11 +3464,12 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
     return finalized;
   }
   async notifyCompletedStatusHandler(result, taskType, handlerName, options) {
-    if (result.status !== "completed" || !result.success || !this.asyncHandler) return;
+    if (options?.skipStatusHandlers === true || result.status !== "completed" || !result.success || !this.asyncHandler)
+      return;
     const handler = this.config.handlers?.[handlerName];
     if (!handler) return;
     throwIfAborted(options?.signal);
-    await handler(result.data, {
+    const metadata = {
       operation_id: options?.contextId || "sync",
       context_id: options?.contextId,
       task_id: result.metadata.taskId,
@@ -3472,7 +3477,30 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
       task_type: taskType,
       status: result.status,
       timestamp: (/* @__PURE__ */ new Date()).toISOString()
-    });
+    };
+    try {
+      await handler(result.data, metadata);
+    } catch (error) {
+      if (this.config.isolateStatusHandlerErrors !== true) throw error;
+      throwIfAborted(options?.signal);
+      result.debug_logs = [
+        ...result.debug_logs ?? [],
+        {
+          level: "warn",
+          timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+          message: "Inline status handler failed. The seller operation completed; reconcile local post-processing."
+        }
+      ];
+      try {
+        await this.config.onStatusHandlerError?.(error, { handlerName, metadata });
+      } catch {
+        result.debug_logs.push({
+          level: "warn",
+          timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+          message: "onStatusHandlerError observer failed. The seller operation completed."
+        });
+      }
+    }
     throwIfAborted(options?.signal);
   }
   canonicalCreativeInputHandler(taskType, inputHandler, canonical = CANONICAL_CREATIVE_ACTIVITY_TASKS.has(taskType)) {
@@ -5748,7 +5776,10 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
         productPolicyRequest: productPolicyRequestSnapshot(normalizedParams),
         accountRegistry: this.accountRegistryContext(taskName, normalizedParams, effectiveOptions),
         ...effectiveOptions?.taskId !== void 0 && { optionTaskId: effectiveOptions.taskId },
-        ...effectiveOptions?.contextId !== void 0 && { optionContextId: effectiveOptions.contextId }
+        ...effectiveOptions?.contextId !== void 0 && { optionContextId: effectiveOptions.contextId },
+        ...effectiveOptions?.skipStatusHandlers !== void 0 && {
+          skipStatusHandlers: effectiveOptions.skipStatusHandlers
+        }
       };
       let result = await this.executor.executeTask(
         agent,

package/dist/lib/index.d.mts

@@ -14,7 +14,7 @@ export { resolveInlinePublisherProperties, resolveSingularInline, detectInlineFe
 export { fetchAgentAuthorizationsFromDirectory, type AgentAuthorizationsIterator, type FetchAgentAuthorizationsOptions, type DirectoryLookupPage, type DirectoryPublisherEntry, type DirectoryDiscoveryMethod, type DirectoryPublisherStatus, } from './discovery/agent-directory.mjs';
 export { validateAdAgents, parseManagerDomain, type DiscoveryMethod, type AdAgentsValidationResult, type ValidateAdAgentsOptions, } from './discovery/validate-adagents.mjs';
 export { SingleAgentClient, WebhookDispatchError, createSingleAgentClient, UnsupportedFeatureError, } from './core/SingleAgentClient.mjs';
-export type { CapabilityEvidenceScope, CapabilityEvidenceSnapshot, ClientProductPropertyPolicy, CreativeDeliveryTaskOptions, SingleAgentClientConfig, SyncCreativesTaskOptions, VerifyAndParseWebhookOptions, WebhookHandlerAdapter, WebhookHandlerRequest, WebhookRequestContext, WebhookParseErrorCode, WebhookParseFailure, WebhookParseResult, WebhookParseSuccess, WebhookVerificationConfig, } from './core/SingleAgentClient.mjs';
+export type { CapabilityEvidenceScope, CapabilityEvidenceSnapshot, ClientProductPropertyPolicy, CreativeDeliveryTaskOptions, SingleAgentClientConfig, StatusHandlerErrorContext, SyncCreativesTaskOptions, VerifyAndParseWebhookOptions, WebhookHandlerAdapter, WebhookHandlerRequest, WebhookRequestContext, WebhookParseErrorCode, WebhookParseFailure, WebhookParseResult, WebhookParseSuccess, WebhookVerificationConfig, } from './core/SingleAgentClient.mjs';
 export { InMemoryWebhookRegistrationStore, type InMemoryWebhookRegistrationStoreOptions, type WebhookAuthenticationMode, type WebhookRegistration, type WebhookRegistrationStore, } from './core/webhook-registration.mjs';
 export { pgWebhookRegistrationStore, getWebhookRegistrationMigration, WEBHOOK_REGISTRATION_MIGRATION, cleanupExpiredWebhookRegistrations, type PgWebhookRegistrationStoreOptions, type CleanupExpiredWebhookRegistrationsOptions, } from './core/postgres-webhook-registration-store.mjs';
 export { redisWebhookRegistrationStore, type RedisWebhookRegistrationStoreOptions, } from './core/redis-webhook-registration-store.mjs';

package/dist/lib/index.d.ts

@@ -14,7 +14,7 @@ export { resolveInlinePublisherProperties, resolveSingularInline, detectInlineFe
 export { fetchAgentAuthorizationsFromDirectory, type AgentAuthorizationsIterator, type FetchAgentAuthorizationsOptions, type DirectoryLookupPage, type DirectoryPublisherEntry, type DirectoryDiscoveryMethod, type DirectoryPublisherStatus, } from './discovery/agent-directory';
 export { validateAdAgents, parseManagerDomain, type DiscoveryMethod, type AdAgentsValidationResult, type ValidateAdAgentsOptions, } from './discovery/validate-adagents';
 export { SingleAgentClient, WebhookDispatchError, createSingleAgentClient, UnsupportedFeatureError, } from './core/SingleAgentClient';
-export type { CapabilityEvidenceScope, CapabilityEvidenceSnapshot, ClientProductPropertyPolicy, CreativeDeliveryTaskOptions, SingleAgentClientConfig, SyncCreativesTaskOptions, VerifyAndParseWebhookOptions, WebhookHandlerAdapter, WebhookHandlerRequest, WebhookRequestContext, WebhookParseErrorCode, WebhookParseFailure, WebhookParseResult, WebhookParseSuccess, WebhookVerificationConfig, } from './core/SingleAgentClient';
+export type { CapabilityEvidenceScope, CapabilityEvidenceSnapshot, ClientProductPropertyPolicy, CreativeDeliveryTaskOptions, SingleAgentClientConfig, StatusHandlerErrorContext, SyncCreativesTaskOptions, VerifyAndParseWebhookOptions, WebhookHandlerAdapter, WebhookHandlerRequest, WebhookRequestContext, WebhookParseErrorCode, WebhookParseFailure, WebhookParseResult, WebhookParseSuccess, WebhookVerificationConfig, } from './core/SingleAgentClient';
 export { InMemoryWebhookRegistrationStore, type InMemoryWebhookRegistrationStoreOptions, type WebhookAuthenticationMode, type WebhookRegistration, type WebhookRegistrationStore, } from './core/webhook-registration';
 export { pgWebhookRegistrationStore, getWebhookRegistrationMigration, WEBHOOK_REGISTRATION_MIGRATION, cleanupExpiredWebhookRegistrations, type PgWebhookRegistrationStoreOptions, type CleanupExpiredWebhookRegistrationsOptions, } from './core/postgres-webhook-registration-store';
 export { redisWebhookRegistrationStore, type RedisWebhookRegistrationStoreOptions, } from './core/redis-webhook-registration-store';

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

@@ -15,6 +15,12 @@ export interface ReportingStatusConsumerScopeOptionsV1<TContext = unknown> {
 }
 export declare function createReportingStatusHandler(store: ReportingLedgerStore): (request: Parameters<ReportingStatusHandlerV1>[0], context: Pick<Parameters<ReportingStatusHandlerV1>[1], 'account' | 'signal'>) => ReturnType<ReportingStatusHandlerV1>;
 export declare function createReportingStatusHandler<TContext = unknown>(store: ReportingLedgerStore, options?: ReportingStatusConsumerScopeOptionsV1<TContext>): ReportingStatusHandlerV1;
+/**
+ * Largest revision whose rows the `get_reporting_status` `revision` view
+ * returns inline. Larger revisions omit `reporting_rows` there; callers page
+ * them through the exact `get_media_buy_delivery` read.
+ */
+export declare const REPORTING_STATUS_REVISION_VIEW_MAX_ROWS = 10000;
 /** Exact revision reader for createAdcpServer's getMediaBuyDelivery slot. */
 export declare function createReportingDeliveryHandler(store: ReportingLedgerStore): ReportingDeliveryHandlerV1;
 export interface ProjectManagedDeliveryInputV1 {

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

@@ -15,6 +15,12 @@ export interface ReportingStatusConsumerScopeOptionsV1<TContext = unknown> {
 }
 export declare function createReportingStatusHandler(store: ReportingLedgerStore): (request: Parameters<ReportingStatusHandlerV1>[0], context: Pick<Parameters<ReportingStatusHandlerV1>[1], 'account' | 'signal'>) => ReturnType<ReportingStatusHandlerV1>;
 export declare function createReportingStatusHandler<TContext = unknown>(store: ReportingLedgerStore, options?: ReportingStatusConsumerScopeOptionsV1<TContext>): ReportingStatusHandlerV1;
+/**
+ * Largest revision whose rows the `get_reporting_status` `revision` view
+ * returns inline. Larger revisions omit `reporting_rows` there; callers page
+ * them through the exact `get_media_buy_delivery` read.
+ */
+export declare const REPORTING_STATUS_REVISION_VIEW_MAX_ROWS = 10000;
 /** Exact revision reader for createAdcpServer's getMediaBuyDelivery slot. */
 export declare function createReportingDeliveryHandler(store: ReportingLedgerStore): ReportingDeliveryHandlerV1;
 export interface ProjectManagedDeliveryInputV1 {

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

@@ -18,6 +18,7 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var handler_exports = {};
 __export(handler_exports, {
+  REPORTING_STATUS_REVISION_VIEW_MAX_ROWS: () => REPORTING_STATUS_REVISION_VIEW_MAX_ROWS,
   ReportingReadCapacityError: () => ReportingReadCapacityError,
   acquireAccountReadSlot: () => acquireAccountReadSlot,
   aggregateReportingCoverageV1: () => aggregateReportingCoverageV1,
@@ -34,6 +35,7 @@ var import_source = require('../source/index.js');
 var import_coverage = require('./coverage.js');
 var import_health = require('./health.js');
 var import_instant = require('./instant.js');
+var import_revision_metadata = require('./revision-metadata.js');
 var import_schedule = require('./schedule.js');
 var import_types = require('./types.js');
 function createReportingStatusHandler(store, options) {
@@ -248,9 +250,22 @@ function createReportingStatusHandler(store, options) {
         const id = query.reporting_revision_id;
         const inSnapshot = id ? page.snapshot.revisions.some((value) => value.reporting_revision_id === id) : false;
         let revision = null;
+        let revisionRows;
         if (id && inSnapshot) {
           try {
-            revision = await store.getRevision(id, accountId);
+            revision = await (0, import_revision_metadata.getRevisionMetadataFromStore)(store, id, accountId);
+            const rowCount = revision?.binding.rowCount ?? 0;
+            if (revision && rowCount <= REPORTING_STATUS_REVISION_VIEW_MAX_ROWS) {
+              const page2 = rowCount === 0 ? { rows: [], total: 0 } : await (0, import_revision_metadata.readRevisionRowsFromStore)(store, {
+                reporting_revision_id: id,
+                account_id: accountId,
+                offset: 0,
+                limit: rowCount,
+                ...context.signal ? { signal: context.signal } : {}
+              });
+              if (!page2 || page2.total !== rowCount) revision = null;
+              else revisionRows = page2.rows;
+            }
           } catch (error) {
             if (error instanceof ReportingReadCapacityError) return lookupUnavailable(view);
             throw error;
@@ -278,7 +293,7 @@ function createReportingStatusHandler(store, options) {
             revision_content_sha256: revision.wireRevision.revision_content_sha256,
             row_count: revision.binding.rowCount
           },
-          reporting_rows: revision.rows,
+          ...revisionRows ? { reporting_rows: revisionRows } : {},
           adjustments: revisionAdjustments.map((value) => value.wireAdjustment),
           ...consumerId ? { consumer_statuses: (page.consumerStatuses ?? []).map(wireConsumerStatus) } : {},
           materializations: (page.materializations ?? []).filter(
@@ -391,6 +406,7 @@ function createReportingStatusHandler(store, options) {
     }
   };
 }
+const REPORTING_STATUS_REVISION_VIEW_MAX_ROWS = 1e4;
 function createReportingDeliveryHandler(store) {
   const activeReadsByAccount = /* @__PURE__ */ new Map();
   return async (request, context) => {
@@ -411,7 +427,7 @@ function createReportingDeliveryHandler(store) {
       if (typeof raw.reporting_revision_id !== "string" || !raw.reporting_revision_id) {
         throw new Error("Ledger delivery reads require reporting_revision_id");
       }
-      const revision = await store.getRevision(raw.reporting_revision_id, accountId);
+      const revision = await (0, import_revision_metadata.getRevisionMetadataFromStore)(store, raw.reporting_revision_id, accountId);
       if (!revision) throw new Error("Reporting revision is unavailable");
       const obligation = await store.getObligation(revision.reporting_obligation_id);
       if (!obligation || obligation.account.account_id !== accountId) {
@@ -419,11 +435,12 @@ function createReportingDeliveryHandler(store) {
       }
       const pagination = isRecord(raw.pagination) ? raw.pagination : {};
       const maxResults = typeof pagination.max_results === "number" && Number.isFinite(pagination.max_results) ? Math.max(1, Math.min(500, Math.trunc(pagination.max_results))) : 100;
+      const totalCount = revision.binding.rowCount;
       let offset = 0;
       if (typeof pagination.cursor === "string") {
         try {
           const cursor = JSON.parse(Buffer.from(pagination.cursor, "base64url").toString("utf8"));
-          if (cursor.revisionId !== revision.reporting_revision_id || typeof cursor.offset !== "number" || !Number.isSafeInteger(cursor.offset) || cursor.offset < 0 || cursor.offset >= revision.rows.length) {
+          if (cursor.revisionId !== revision.reporting_revision_id || typeof cursor.offset !== "number" || !Number.isSafeInteger(cursor.offset) || cursor.offset < 0 || cursor.offset >= totalCount) {
             throw new Error("invalid");
           }
           offset = cursor.offset;
@@ -431,9 +448,20 @@ function createReportingDeliveryHandler(store) {
           throw new Error("Reporting delivery cursor is invalid");
         }
       }
-      const reportingRows = revision.rows.slice(offset, offset + maxResults);
+      let reportingRows = [];
+      if (totalCount > 0) {
+        const page = await (0, import_revision_metadata.readRevisionRowsFromStore)(store, {
+          reporting_revision_id: revision.reporting_revision_id,
+          account_id: accountId,
+          offset,
+          limit: maxResults,
+          ...context.signal ? { signal: context.signal } : {}
+        });
+        if (!page || page.total !== totalCount) throw new Error("Reporting revision is unavailable");
+        reportingRows = page.rows;
+      }
       const nextOffset = offset + reportingRows.length;
-      const hasMore = nextOffset < revision.rows.length;
+      const hasMore = nextOffset < totalCount;
       return {
         reporting_period: { start: obligation.period.start, end: obligation.period.end },
         media_buy_deliveries: [],
@@ -453,7 +481,7 @@ function createReportingDeliveryHandler(store) {
         errors: [],
         pagination: {
           has_more: hasMore,
-          total_count: revision.rows.length,
+          total_count: totalCount,
           ...hasMore ? {
             cursor: Buffer.from(
               JSON.stringify({ revisionId: revision.reporting_revision_id, offset: nextOffset }),
@@ -966,6 +994,7 @@ function wireSchedule(obligation) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  REPORTING_STATUS_REVISION_VIEW_MAX_ROWS,
   ReportingReadCapacityError,
   acquireAccountReadSlot,
   aggregateReportingCoverageV1,

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

@@ -18,6 +18,7 @@ import {
   projectReportingObligationHealthV1
 } from "./health.mjs";
 import { compareReportingInstants } from "./instant.mjs";
+import { getRevisionMetadataFromStore, readRevisionRowsFromStore } from "./revision-metadata.mjs";
 import { reportingPeriodSchedule } from "./schedule.mjs";
 import { ReportingLedgerSnapshotUnavailableError } from "./types.mjs";
 function createReportingStatusHandler(store, options) {
@@ -232,9 +233,22 @@ function createReportingStatusHandler(store, options) {
         const id = query.reporting_revision_id;
         const inSnapshot = id ? page.snapshot.revisions.some((value) => value.reporting_revision_id === id) : false;
         let revision = null;
+        let revisionRows;
         if (id && inSnapshot) {
           try {
-            revision = await store.getRevision(id, accountId);
+            revision = await getRevisionMetadataFromStore(store, id, accountId);
+            const rowCount = revision?.binding.rowCount ?? 0;
+            if (revision && rowCount <= REPORTING_STATUS_REVISION_VIEW_MAX_ROWS) {
+              const page2 = rowCount === 0 ? { rows: [], total: 0 } : await readRevisionRowsFromStore(store, {
+                reporting_revision_id: id,
+                account_id: accountId,
+                offset: 0,
+                limit: rowCount,
+                ...context.signal ? { signal: context.signal } : {}
+              });
+              if (!page2 || page2.total !== rowCount) revision = null;
+              else revisionRows = page2.rows;
+            }
           } catch (error) {
             if (error instanceof ReportingReadCapacityError) return lookupUnavailable(view);
             throw error;
@@ -262,7 +276,7 @@ function createReportingStatusHandler(store, options) {
             revision_content_sha256: revision.wireRevision.revision_content_sha256,
             row_count: revision.binding.rowCount
           },
-          reporting_rows: revision.rows,
+          ...revisionRows ? { reporting_rows: revisionRows } : {},
           adjustments: revisionAdjustments.map((value) => value.wireAdjustment),
           ...consumerId ? { consumer_statuses: (page.consumerStatuses ?? []).map(wireConsumerStatus) } : {},
           materializations: (page.materializations ?? []).filter(
@@ -375,6 +389,7 @@ function createReportingStatusHandler(store, options) {
     }
   };
 }
+const REPORTING_STATUS_REVISION_VIEW_MAX_ROWS = 1e4;
 function createReportingDeliveryHandler(store) {
   const activeReadsByAccount = /* @__PURE__ */ new Map();
   return async (request, context) => {
@@ -395,7 +410,7 @@ function createReportingDeliveryHandler(store) {
       if (typeof raw.reporting_revision_id !== "string" || !raw.reporting_revision_id) {
         throw new Error("Ledger delivery reads require reporting_revision_id");
       }
-      const revision = await store.getRevision(raw.reporting_revision_id, accountId);
+      const revision = await getRevisionMetadataFromStore(store, raw.reporting_revision_id, accountId);
       if (!revision) throw new Error("Reporting revision is unavailable");
       const obligation = await store.getObligation(revision.reporting_obligation_id);
       if (!obligation || obligation.account.account_id !== accountId) {
@@ -403,11 +418,12 @@ function createReportingDeliveryHandler(store) {
       }
       const pagination = isRecord(raw.pagination) ? raw.pagination : {};
       const maxResults = typeof pagination.max_results === "number" && Number.isFinite(pagination.max_results) ? Math.max(1, Math.min(500, Math.trunc(pagination.max_results))) : 100;
+      const totalCount = revision.binding.rowCount;
       let offset = 0;
       if (typeof pagination.cursor === "string") {
         try {
           const cursor = JSON.parse(Buffer.from(pagination.cursor, "base64url").toString("utf8"));
-          if (cursor.revisionId !== revision.reporting_revision_id || typeof cursor.offset !== "number" || !Number.isSafeInteger(cursor.offset) || cursor.offset < 0 || cursor.offset >= revision.rows.length) {
+          if (cursor.revisionId !== revision.reporting_revision_id || typeof cursor.offset !== "number" || !Number.isSafeInteger(cursor.offset) || cursor.offset < 0 || cursor.offset >= totalCount) {
             throw new Error("invalid");
           }
           offset = cursor.offset;
@@ -415,9 +431,20 @@ function createReportingDeliveryHandler(store) {
           throw new Error("Reporting delivery cursor is invalid");
         }
       }
-      const reportingRows = revision.rows.slice(offset, offset + maxResults);
+      let reportingRows = [];
+      if (totalCount > 0) {
+        const page = await readRevisionRowsFromStore(store, {
+          reporting_revision_id: revision.reporting_revision_id,
+          account_id: accountId,
+          offset,
+          limit: maxResults,
+          ...context.signal ? { signal: context.signal } : {}
+        });
+        if (!page || page.total !== totalCount) throw new Error("Reporting revision is unavailable");
+        reportingRows = page.rows;
+      }
       const nextOffset = offset + reportingRows.length;
-      const hasMore = nextOffset < revision.rows.length;
+      const hasMore = nextOffset < totalCount;
       return {
         reporting_period: { start: obligation.period.start, end: obligation.period.end },
         media_buy_deliveries: [],
@@ -437,7 +464,7 @@ function createReportingDeliveryHandler(store) {
         errors: [],
         pagination: {
           has_more: hasMore,
-          total_count: revision.rows.length,
+          total_count: totalCount,
           ...hasMore ? {
             cursor: Buffer.from(
               JSON.stringify({ revisionId: revision.reporting_revision_id, offset: nextOffset }),
@@ -949,6 +976,7 @@ function wireSchedule(obligation) {
   };
 }
 export {
+  REPORTING_STATUS_REVISION_VIEW_MAX_ROWS,
   ReportingReadCapacityError,
   acquireAccountReadSlot,
   aggregateReportingCoverageV1,

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

@@ -11,3 +11,4 @@ export * from './managed.mjs';
 export * from './managed-postgres.mjs';
 export * from './object-writes.mjs';
 export * from './notification-activity.mjs';
+export * from './row-encoding.mjs';

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

@@ -11,3 +11,4 @@ export * from './managed';
 export * from './managed-postgres';
 export * from './object-writes';
 export * from './notification-activity';
+export * from './row-encoding';

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

@@ -28,6 +28,7 @@ __reExport(ledger_exports, require('./managed.js'), module.exports);
 __reExport(ledger_exports, require('./managed-postgres.js'), module.exports);
 __reExport(ledger_exports, require('./object-writes.js'), module.exports);
 __reExport(ledger_exports, require('./notification-activity.js'), module.exports);
+__reExport(ledger_exports, require('./row-encoding.js'), module.exports);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ...require('./types.js'),
@@ -42,5 +43,6 @@ __reExport(ledger_exports, require('./notification-activity.js'), module.exports
   ...require('./managed.js'),
   ...require('./managed-postgres.js'),
   ...require('./object-writes.js'),
-  ...require('./notification-activity.js')
+  ...require('./notification-activity.js'),
+  ...require('./row-encoding.js')
 });

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

@@ -11,3 +11,4 @@ export * from "./managed.mjs";
 export * from "./managed-postgres.mjs";
 export * from "./object-writes.mjs";
 export * from "./notification-activity.mjs";
+export * from "./row-encoding.mjs";

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

@@ -28,6 +28,7 @@ var import_source = require('../source/index.js');
 var import_handler = require('./handler.js');
 var import_instant = require('./instant.js');
 var import_health = require('./health.js');
+var import_revision_metadata = require('./revision-metadata.js');
 async function resolveLedgerAsOf(input, attempt) {
   const resolved = await input.store.readLedgerInstant?.() ?? (input.now ?? (() => /* @__PURE__ */ new Date()))().toISOString();
   if (input.ledgerAsOf === void 0) return resolved;
@@ -78,7 +79,7 @@ async function reconcileReportingStatusLifecycleV1(input, attempt = 0) {
   const transactionalNotifications = input.store.transactionalNotificationActivity === true;
   assertNotificationModesCompatible(input.store, input.subscribers);
   let ledgerAsOf = await resolveLedgerAsOf(input, attempt);
-  const revisions = await input.store.listRevisions(obligation.reporting_obligation_id);
+  const revisions = await (0, import_revision_metadata.listRevisionMetadataFromStore)(input.store, obligation.reporting_obligation_id);
   let projected = revisions;
   const projectCore = (at) => (0, import_health.projectReportingObligationHealthV1)(
     obligation,
@@ -207,7 +208,7 @@ async function composeManagedLifecycleProjection(input, obligation, revisions, c
     ledgerAsOf: input.ledgerAsOf
   });
   if (!managed) return { projection: coreProjection };
-  const stored = await input.store.listAdjustments(obligation.reporting_obligation_id);
+  const stored = await (0, import_revision_metadata.listAdjustmentMetadataFromStore)(input.store, obligation.reporting_obligation_id);
   const visibleAdjustmentIds = managed.visibleAdjustmentIds;
   const adjustments = visibleAdjustmentIds ? stored.filter((value) => visibleAdjustmentIds.includes(value.reporting_adjustment_id)) : stored.filter((value) => (0, import_instant.compareReportingInstants)(value.createdAt, input.ledgerAsOf) <= 0);
   const rosterAuthoritative = managed.obligatedConsumerRosterComplete === true && managed.receiptEvidenceComplete !== false;