@adcp/sdk 14.1.0 → 14.3.0

package/dist/lib/index.d.mts

@@ -237,7 +237,8 @@ export { resolvePreviewAuthority, type PlacementPreviewCandidate, type PreviewAu
 export { isStatusCompleted, isStatusWorking, isStatusInputRequired, isStatusSubmitted, isStatusFailed, isStatusRejected, isGetProductsCompleted, isGetProductsWorking, isGetProductsInputRequired, isGetProductsSubmitted, isGetProductsFailed, isCreateMediaBuyCompleted, isCreateMediaBuyWorking, isCreateMediaBuyInputRequired, isCreateMediaBuySubmitted, isCreateMediaBuyFailed, isUpdateMediaBuyCompleted, isUpdateMediaBuyWorking, isUpdateMediaBuyInputRequired, isUpdateMediaBuySubmitted, isUpdateMediaBuyFailed, isSyncCreativesCompleted, isSyncCreativesWorking, isSyncCreativesInputRequired, isSyncCreativesSubmitted, isSyncCreativesFailed, } from './utils/typeGuards.mjs';
 export { getAdcpVersion, getLibraryVersion, isCompatibleWith, getCompatibleVersions, parseAdcpMajorVersion, ADCP_VERSION, ADCP_MAJOR_VERSION, LIBRARY_VERSION, COMPATIBLE_ADCP_VERSIONS, VERSION_INFO, } from './version.mjs';
 export type { AdcpVersion } from './version.mjs';
-export { listBundledAdcpVersions, resolveAdcpVersion } from './utils/adcp-version-config.mjs';
+export { listBundledAdcpVersions, resolveAdcpVersion, isAdcpVersionAtLeast, sellerAdvertises31, shouldOmit31Fields, } from './utils/adcp-version-config.mjs';
+export { redactSecrets } from './utils/redact-secrets.mjs';
 export { getTracer, isTracingEnabled, injectTraceHeaders, withSpan, addSpanAttributes, recordSpanException, } from './observability/index.mjs';
 export { Agent as LegacyAgent, AgentCollection as LegacyAgentCollection } from './agents/index.generated.mjs';
 export { LegacyContentStandardsAdapter, type LegacyIContentStandardsAdapter, type LegacyContentEvaluationResult, LegacyContentStandardsErrorCodes, isLegacyContentStandardsError, legacyDefaultContentStandardsAdapter, PropertyListAdapter, type IPropertyListAdapter, type ResolvedProperty, PropertyListErrorCodes, isPropertyListError, defaultPropertyListAdapter, SISessionManager, AISISessionManager, type ISISessionManager, type SISession, SIErrorCodes, defaultSISessionManager, GovernanceAdapter, defaultGovernanceAdapter, type IGovernanceAdapter, type GovernanceAdapterConfig, type GovernanceAdapterErrorCode, type CommittedCheckRequest, type LegacyCommittedCheckRequest, type ModernCommittedCheckRequest, GovernanceAdapterError, GovernanceAdapterErrorCodes, isGovernanceAdapterError, InMemoryImplicitAccountStore, defaultImplicitKeyFn, type ImplicitAccountStoreOptions, createOAuthPassthroughResolver, type OAuthPassthroughResolverOptions, createRosterAccountStore, type RosterAccountStoreOptions, createDerivedAccountStore, type DerivedAccountStoreOptions, type DerivedAccountStoreBaseOptions, type DerivedSingletonAccountStoreOptions, type DerivedRosterAccountStoreOptions, } from './adapters/index.mjs';
@@ -272,5 +273,5 @@ export { mediaBuyActionResolver } from './server/media-buy-action-resolver.mjs';
 export type { SellerActionDecision, SellerActionResolutionOptions, SellerActionResolution, } from './server/media-buy-action-resolver.mjs';
 export * from './supply-path/index.mjs';
 export type { AuthorizationCollectionSelector, ProductCollectionSelector, CollectionDistribution, DiscoveryCollection, } from './discovery/types.mjs';
-export { BuyerAccountRegistry, type AccountPolicy, type BuyerAccountStorage, type BuyerAccountRegistryOptions, type EnsureAccountOptions, type ProvisionedAccount, } from './core/buyer-account-registry.mjs';
+export { BuyerAccountRegistry, type AccountPolicy, type BuyerAccountStorage, type BuyerAccountRegistryOptions, type BuyerAccountDispatch, type BuyerAccountProvisioningDispatch, type EnsureAccountOptions, type ProvisionedAccount, } from './core/buyer-account-registry.mjs';
 export { createProductCache, ProductCache, type ProductCacheOptions } from './core/product-cache.mjs';

package/dist/lib/index.d.ts

@@ -237,7 +237,8 @@ export { resolvePreviewAuthority, type PlacementPreviewCandidate, type PreviewAu
 export { isStatusCompleted, isStatusWorking, isStatusInputRequired, isStatusSubmitted, isStatusFailed, isStatusRejected, isGetProductsCompleted, isGetProductsWorking, isGetProductsInputRequired, isGetProductsSubmitted, isGetProductsFailed, isCreateMediaBuyCompleted, isCreateMediaBuyWorking, isCreateMediaBuyInputRequired, isCreateMediaBuySubmitted, isCreateMediaBuyFailed, isUpdateMediaBuyCompleted, isUpdateMediaBuyWorking, isUpdateMediaBuyInputRequired, isUpdateMediaBuySubmitted, isUpdateMediaBuyFailed, isSyncCreativesCompleted, isSyncCreativesWorking, isSyncCreativesInputRequired, isSyncCreativesSubmitted, isSyncCreativesFailed, } from './utils/typeGuards';
 export { getAdcpVersion, getLibraryVersion, isCompatibleWith, getCompatibleVersions, parseAdcpMajorVersion, ADCP_VERSION, ADCP_MAJOR_VERSION, LIBRARY_VERSION, COMPATIBLE_ADCP_VERSIONS, VERSION_INFO, } from './version';
 export type { AdcpVersion } from './version';
-export { listBundledAdcpVersions, resolveAdcpVersion } from './utils/adcp-version-config';
+export { listBundledAdcpVersions, resolveAdcpVersion, isAdcpVersionAtLeast, sellerAdvertises31, shouldOmit31Fields, } from './utils/adcp-version-config';
+export { redactSecrets } from './utils/redact-secrets';
 export { getTracer, isTracingEnabled, injectTraceHeaders, withSpan, addSpanAttributes, recordSpanException, } from './observability';
 export { Agent as LegacyAgent, AgentCollection as LegacyAgentCollection } from './agents/index.generated';
 export { LegacyContentStandardsAdapter, type LegacyIContentStandardsAdapter, type LegacyContentEvaluationResult, LegacyContentStandardsErrorCodes, isLegacyContentStandardsError, legacyDefaultContentStandardsAdapter, PropertyListAdapter, type IPropertyListAdapter, type ResolvedProperty, PropertyListErrorCodes, isPropertyListError, defaultPropertyListAdapter, SISessionManager, AISISessionManager, type ISISessionManager, type SISession, SIErrorCodes, defaultSISessionManager, GovernanceAdapter, defaultGovernanceAdapter, type IGovernanceAdapter, type GovernanceAdapterConfig, type GovernanceAdapterErrorCode, type CommittedCheckRequest, type LegacyCommittedCheckRequest, type ModernCommittedCheckRequest, GovernanceAdapterError, GovernanceAdapterErrorCodes, isGovernanceAdapterError, InMemoryImplicitAccountStore, defaultImplicitKeyFn, type ImplicitAccountStoreOptions, createOAuthPassthroughResolver, type OAuthPassthroughResolverOptions, createRosterAccountStore, type RosterAccountStoreOptions, createDerivedAccountStore, type DerivedAccountStoreOptions, type DerivedAccountStoreBaseOptions, type DerivedSingletonAccountStoreOptions, type DerivedRosterAccountStoreOptions, } from './adapters';
@@ -272,5 +273,5 @@ export { mediaBuyActionResolver } from './server/media-buy-action-resolver';
 export type { SellerActionDecision, SellerActionResolutionOptions, SellerActionResolution, } from './server/media-buy-action-resolver';
 export * from './supply-path';
 export type { AuthorizationCollectionSelector, ProductCollectionSelector, CollectionDistribution, DiscoveryCollection, } from './discovery/types';
-export { BuyerAccountRegistry, type AccountPolicy, type BuyerAccountStorage, type BuyerAccountRegistryOptions, type EnsureAccountOptions, type ProvisionedAccount, } from './core/buyer-account-registry';
+export { BuyerAccountRegistry, type AccountPolicy, type BuyerAccountStorage, type BuyerAccountRegistryOptions, type BuyerAccountDispatch, type BuyerAccountProvisioningDispatch, type EnsureAccountOptions, type ProvisionedAccount, } from './core/buyer-account-registry';
 export { createProductCache, ProductCache, type ProductCacheOptions } from './core/product-cache';

package/dist/lib/index.js

@@ -453,6 +453,7 @@ __export(index_exports, {
   isADCPError: () => import_errors.isADCPError,
   isAdcpError: () => import_utils.isAdcpError,
   isAdcpSuccess: () => import_utils.isAdcpSuccess,
+  isAdcpVersionAtLeast: () => import_adcp_version_config.isAdcpVersionAtLeast,
   isAgentCardPath: () => import_utils6.isAgentCardPath,
   isAlwaysBlocked: () => import_net.isAlwaysBlocked,
   isCPAPricing: () => import_utils7.isCPAPricing,
@@ -600,6 +601,7 @@ __export(index_exports, {
   recordSpanException: () => import_observability.recordSpanException,
   recoveryForModeMismatch: () => import_media_buy.recoveryForModeMismatch,
   redactIdempotencyKey: () => import_idempotency.redactIdempotencyKey,
+  redactSecrets: () => import_redact_secrets.redactSecrets,
   redisBackend: () => import_server.redisBackend,
   redisWebhookRegistrationStore: () => import_redis_webhook_registration_store.redisWebhookRegistrationStore,
   registerAdcpTaskTool: () => import_server.registerAdcpTaskTool,
@@ -638,7 +640,9 @@ __export(index_exports, {
   scopedStore: () => import_server.scopedStore,
   segmentIdActivationKey: () => import_activation_key_builders.segmentIdActivationKey,
   selectLogoForSlot: () => import_brand.selectLogoForSlot,
+  sellerAdvertises31: () => import_adcp_version_config.sellerAdvertises31,
   serve: () => import_server.serve,
+  shouldOmit31Fields: () => import_adcp_version_config.shouldOmit31Fields,
   signalId: () => import_signal_id_builders.signalId,
   singleBuildCreativeReturn: () => import_build_creative_return_builders.singleBuildCreativeReturn,
   singleEnvelopedBuildCreativeReturn: () => import_build_creative_return_builders.singleEnvelopedBuildCreativeReturn,
@@ -825,6 +829,7 @@ var import_preview_authority = require('./utils/preview-authority.js');
 var import_typeGuards = require('./utils/typeGuards.js');
 var import_version = require('./version.js');
 var import_adcp_version_config = require('./utils/adcp-version-config.js');
+var import_redact_secrets = require('./utils/redact-secrets.js');
 var import_observability = require('./observability/index.js');
 var import_agents = require('./agents/index.generated.js');
 var import_adapters = require('./adapters/index.js');
@@ -1288,6 +1293,7 @@ function createAdCPClientFromEnv() {
   isADCPError,
   isAdcpError,
   isAdcpSuccess,
+  isAdcpVersionAtLeast,
   isAgentCardPath,
   isAlwaysBlocked,
   isCPAPricing,
@@ -1435,6 +1441,7 @@ function createAdCPClientFromEnv() {
   recordSpanException,
   recoveryForModeMismatch,
   redactIdempotencyKey,
+  redactSecrets,
   redisBackend,
   redisWebhookRegistrationStore,
   registerAdcpTaskTool,
@@ -1473,7 +1480,9 @@ function createAdCPClientFromEnv() {
   scopedStore,
   segmentIdActivationKey,
   selectLogoForSlot,
+  sellerAdvertises31,
   serve,
+  shouldOmit31Fields,
   signalId,
   singleBuildCreativeReturn,
   singleEnvelopedBuildCreativeReturn,

package/dist/lib/index.mjs

@@ -708,7 +708,14 @@ import {
   COMPATIBLE_ADCP_VERSIONS,
   VERSION_INFO
 } from "./version.mjs";
-import { listBundledAdcpVersions, resolveAdcpVersion } from "./utils/adcp-version-config.mjs";
+import {
+  listBundledAdcpVersions,
+  resolveAdcpVersion,
+  isAdcpVersionAtLeast,
+  sellerAdvertises31,
+  shouldOmit31Fields
+} from "./utils/adcp-version-config.mjs";
+import { redactSecrets } from "./utils/redact-secrets.mjs";
 import {
   getTracer,
   isTracingEnabled,
@@ -1245,6 +1252,7 @@ export {
   isADCPError,
   isAdcpError,
   isAdcpSuccess,
+  isAdcpVersionAtLeast,
   isAgentCardPath,
   isAlwaysBlocked,
   isCPAPricing,
@@ -1392,6 +1400,7 @@ export {
   recordSpanException,
   recoveryForModeMismatch,
   redactIdempotencyKey,
+  redactSecrets,
   redisBackend,
   redisWebhookRegistrationStore,
   registerAdcpTaskTool,
@@ -1430,7 +1439,9 @@ export {
   scopedStore,
   segmentIdActivationKey,
   selectLogoForSlot,
+  sellerAdvertises31,
   serve,
+  shouldOmit31Fields,
   signalId,
   singleBuildCreativeReturn,
   singleEnvelopedBuildCreativeReturn,

package/dist/lib/net/agent-transport-fetch.d.mts

@@ -1,3 +1,7 @@
+export declare class AgentTransportPolicyError extends TypeError {
+    readonly code = "agent_transport_policy_refused";
+    constructor(message: string);
+}
 type ResolvedAddress = {
     address: string;
     family: number;

package/dist/lib/net/agent-transport-fetch.d.ts

@@ -1,3 +1,7 @@
+export declare class AgentTransportPolicyError extends TypeError {
+    readonly code = "agent_transport_policy_refused";
+    constructor(message: string);
+}
 type ResolvedAddress = {
     address: string;
     family: number;

package/dist/lib/net/agent-transport-fetch.js

@@ -18,6 +18,7 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var agent_transport_fetch_exports = {};
 __export(agent_transport_fetch_exports, {
+  AgentTransportPolicyError: () => AgentTransportPolicyError,
   createAgentTransportFetch: () => createAgentTransportFetch
 });
 module.exports = __toCommonJS(agent_transport_fetch_exports);
@@ -25,14 +26,21 @@ var import_promises = require("node:dns/promises");
 var import_node_net = require("node:net");
 var import_undici = require("undici");
 var import_address_guards = require('./address-guards.js');
+class AgentTransportPolicyError extends TypeError {
+  code = "agent_transport_policy_refused";
+  constructor(message) {
+    super(message);
+    this.name = "AgentTransportPolicyError";
+  }
+}
 const REDIRECT_STATUSES = /* @__PURE__ */ new Set([301, 302, 303, 307, 308]);
 const SENSITIVE_REDIRECT_HEADERS = ["authorization", "cookie", "proxy-authorization", "x-adcp-auth"];
 function createAgentTransportFetch(agentUrl, options = {}) {
   const lookup = options.lookup ?? ((hostname) => (0, import_promises.lookup)(hostname, { all: true }));
   const maxRedirects = options.maxRedirects ?? 5;
   const initialUrl = new URL(agentUrl);
-  const allowPrivateEverywhere = options.allowPrivateIp === true || process.env.ADCP_ALLOW_INTERNAL_PROBES === "1" || process.env.ADCP_ALLOW_PRIVATE_AGENT_URL === "1";
-  const allowPrivateInitialOrigin = (0, import_address_guards.isLikelyPrivateUrl)(initialUrl.toString());
+  const allowPrivateEverywhere = options.allowPrivateIp === true || options.allowPrivateInitialOrigin !== false && (process.env.ADCP_ALLOW_INTERNAL_PROBES === "1" || process.env.ADCP_ALLOW_PRIVATE_AGENT_URL === "1");
+  const allowPrivateInitialOrigin = options.allowPrivateInitialOrigin !== false && (0, import_address_guards.isLikelyPrivateUrl)(initialUrl.toString());
   const dispatchers = /* @__PURE__ */ new Map();
   const privateIpAllowedFor = (url) => allowPrivateEverywhere || allowPrivateInitialOrigin && url.origin === initialUrl.origin;
   const dispatcherFor = (url) => {
@@ -57,6 +65,8 @@ function createAgentTransportFetch(agentUrl, options = {}) {
     const redirectMode = init?.redirect ?? request?.redirect ?? "follow";
     for (let redirects = 0; ; redirects++) {
       assertTransportScheme(url);
+      if (options.requireHttps && url.protocol !== "https:" && !options.allowPrivateIp)
+        throw new AgentTransportPolicyError("Signing discovery requires HTTPS.");
       const hostname = url.hostname.replace(/^\[|\]$/g, "");
       if ((0, import_node_net.isIP)(hostname) !== 0) assertAgentAddressAllowed(hostname, hostname, privateIpAllowedFor(url), false);
       const headerRecord = {};
@@ -124,19 +134,22 @@ async function resolveAndCreateDispatcher(url, lookup, allowPrivateIp) {
 function assertAgentAddressAllowed(address, hostname, allowPrivateIp, resolved) {
   const relationship = resolved ? "resolves to" : "is";
   if ((0, import_address_guards.isAlwaysBlocked)(address)) {
-    throw new Error(`Agent host ${hostname} ${relationship} an always-blocked address`);
+    throw new AgentTransportPolicyError(`Agent host ${hostname} ${relationship} an always-blocked address`);
   }
   if (!allowPrivateIp && (0, import_address_guards.isPrivateIp)(address)) {
     const guidance = resolved ? "set transport.allowPrivateIp=true for an explicitly trusted private agent, or provide a trustedFetchFn that enforces its own hostname address policy" : "set transport.allowPrivateIp=true for an explicitly trusted private agent";
-    throw new Error(`Agent host ${hostname} ${relationship} a private or loopback address; ` + guidance);
+    throw new AgentTransportPolicyError(
+      `Agent host ${hostname} ${relationship} a private or loopback address; ` + guidance
+    );
   }
 }
 function assertTransportScheme(url) {
   if (url.protocol !== "http:" && url.protocol !== "https:") {
-    throw new TypeError(`Agent transport does not allow ${url.protocol} URLs`);
+    throw new AgentTransportPolicyError(`Agent transport does not allow ${url.protocol} URLs`);
   }
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  AgentTransportPolicyError,
   createAgentTransportFetch
 });

package/dist/lib/net/agent-transport-fetch.mjs

@@ -2,14 +2,21 @@ import { lookup as dnsLookup } from "node:dns/promises";
 import { isIP } from "node:net";
 import { Agent, fetch as undiciFetch } from "undici";
 import { isAlwaysBlocked, isLikelyPrivateUrl, isPrivateIp } from "./address-guards.mjs";
+class AgentTransportPolicyError extends TypeError {
+  code = "agent_transport_policy_refused";
+  constructor(message) {
+    super(message);
+    this.name = "AgentTransportPolicyError";
+  }
+}
 const REDIRECT_STATUSES = /* @__PURE__ */ new Set([301, 302, 303, 307, 308]);
 const SENSITIVE_REDIRECT_HEADERS = ["authorization", "cookie", "proxy-authorization", "x-adcp-auth"];
 function createAgentTransportFetch(agentUrl, options = {}) {
   const lookup = options.lookup ?? ((hostname) => dnsLookup(hostname, { all: true }));
   const maxRedirects = options.maxRedirects ?? 5;
   const initialUrl = new URL(agentUrl);
-  const allowPrivateEverywhere = options.allowPrivateIp === true || process.env.ADCP_ALLOW_INTERNAL_PROBES === "1" || process.env.ADCP_ALLOW_PRIVATE_AGENT_URL === "1";
-  const allowPrivateInitialOrigin = isLikelyPrivateUrl(initialUrl.toString());
+  const allowPrivateEverywhere = options.allowPrivateIp === true || options.allowPrivateInitialOrigin !== false && (process.env.ADCP_ALLOW_INTERNAL_PROBES === "1" || process.env.ADCP_ALLOW_PRIVATE_AGENT_URL === "1");
+  const allowPrivateInitialOrigin = options.allowPrivateInitialOrigin !== false && isLikelyPrivateUrl(initialUrl.toString());
   const dispatchers = /* @__PURE__ */ new Map();
   const privateIpAllowedFor = (url) => allowPrivateEverywhere || allowPrivateInitialOrigin && url.origin === initialUrl.origin;
   const dispatcherFor = (url) => {
@@ -34,6 +41,8 @@ function createAgentTransportFetch(agentUrl, options = {}) {
     const redirectMode = init?.redirect ?? request?.redirect ?? "follow";
     for (let redirects = 0; ; redirects++) {
       assertTransportScheme(url);
+      if (options.requireHttps && url.protocol !== "https:" && !options.allowPrivateIp)
+        throw new AgentTransportPolicyError("Signing discovery requires HTTPS.");
       const hostname = url.hostname.replace(/^\[|\]$/g, "");
       if (isIP(hostname) !== 0) assertAgentAddressAllowed(hostname, hostname, privateIpAllowedFor(url), false);
       const headerRecord = {};
@@ -101,18 +110,21 @@ async function resolveAndCreateDispatcher(url, lookup, allowPrivateIp) {
 function assertAgentAddressAllowed(address, hostname, allowPrivateIp, resolved) {
   const relationship = resolved ? "resolves to" : "is";
   if (isAlwaysBlocked(address)) {
-    throw new Error(`Agent host ${hostname} ${relationship} an always-blocked address`);
+    throw new AgentTransportPolicyError(`Agent host ${hostname} ${relationship} an always-blocked address`);
   }
   if (!allowPrivateIp && isPrivateIp(address)) {
     const guidance = resolved ? "set transport.allowPrivateIp=true for an explicitly trusted private agent, or provide a trustedFetchFn that enforces its own hostname address policy" : "set transport.allowPrivateIp=true for an explicitly trusted private agent";
-    throw new Error(`Agent host ${hostname} ${relationship} a private or loopback address; ` + guidance);
+    throw new AgentTransportPolicyError(
+      `Agent host ${hostname} ${relationship} a private or loopback address; ` + guidance
+    );
   }
 }
 function assertTransportScheme(url) {
   if (url.protocol !== "http:" && url.protocol !== "https:") {
-    throw new TypeError(`Agent transport does not allow ${url.protocol} URLs`);
+    throw new AgentTransportPolicyError(`Agent transport does not allow ${url.protocol} URLs`);
   }
 }
 export {
+  AgentTransportPolicyError,
   createAgentTransportFetch
 };

package/dist/lib/reporting/inspection.d.mts

@@ -2,7 +2,7 @@ import { type CanonicalReferenceResolver } from '../canonical-references/index.m
 import { type SsrfFetchOptions } from '../net/ssrf-fetch.mjs';
 import type { ReportingControlTotal } from '../types/tools.generated.mjs';
 import type { ReportingInspectionContext, ReportingObservation } from './reconciliation.mjs';
-export type ReportingInspectionErrorCode = 'UNSUPPORTED_RESOURCE' | 'RESOURCE_READ_FAILED' | 'RESOURCE_NOT_READY' | 'RESOURCE_TOO_LARGE' | 'INSPECTION_TIMEOUT' | 'MANIFEST_DIGEST_MISMATCH' | 'MANIFEST_INVALID' | 'MANIFEST_INCOMPLETE' | 'MANIFEST_IDENTITY_MISMATCH' | 'MANIFEST_TOTAL_MISMATCH' | 'OBJECT_DUPLICATE' | 'OBJECT_SIZE_MISMATCH' | 'OBJECT_DIGEST_MISMATCH' | 'OBJECT_ROW_COUNT_MISMATCH' | 'FORMAT_UNSUPPORTED' | 'COMPRESSION_UNSUPPORTED' | 'ROW_SCHEMA_FETCH_FAILED' | 'ROW_SCHEMA_INVALID' | 'ROW_SCHEMA_VIOLATION' | 'REPORT_DEFINITION_FETCH_FAILED' | 'REPORT_DEFINITION_INVALID' | 'CANONICALIZATION_FETCH_FAILED' | 'CANONICALIZATION_INVALID' | 'ROW_COUNT_MISMATCH' | 'CONTROL_TOTAL_UNSUPPORTED' | 'CONTROL_TOTAL_MISMATCH' | 'CANONICAL_DIGEST_MISMATCH';
+export type ReportingInspectionErrorCode = 'CONSUMER_COMMIT_FAILED' | 'UNSUPPORTED_RESOURCE' | 'RESOURCE_READ_FAILED' | 'RESOURCE_NOT_READY' | 'RESOURCE_TOO_LARGE' | 'INSPECTION_TIMEOUT' | 'MANIFEST_DIGEST_MISMATCH' | 'MANIFEST_INVALID' | 'MANIFEST_INCOMPLETE' | 'MANIFEST_IDENTITY_MISMATCH' | 'MANIFEST_TOTAL_MISMATCH' | 'OBJECT_DUPLICATE' | 'OBJECT_SIZE_MISMATCH' | 'OBJECT_DIGEST_MISMATCH' | 'OBJECT_ROW_COUNT_MISMATCH' | 'FORMAT_UNSUPPORTED' | 'COMPRESSION_UNSUPPORTED' | 'ROW_SCHEMA_FETCH_FAILED' | 'ROW_SCHEMA_INVALID' | 'ROW_SCHEMA_VIOLATION' | 'REPORT_DEFINITION_FETCH_FAILED' | 'REPORT_DEFINITION_INVALID' | 'CANONICALIZATION_FETCH_FAILED' | 'CANONICALIZATION_INVALID' | 'ROW_COUNT_MISMATCH' | 'CONTROL_TOTAL_UNSUPPORTED' | 'CONTROL_TOTAL_MISMATCH' | 'CANONICAL_DIGEST_MISMATCH';
 export declare class ReportingInspectionError extends Error {
     readonly code: ReportingInspectionErrorCode;
     readonly retryable: boolean;
@@ -78,9 +78,9 @@ export interface ReportingManifestInspectorOptions<TCredential = unknown> {
     maxFiles?: number;
     maxRows?: number;
     maxRowBytes?: number;
-    /** Hard wall-clock budget for one inspection attempt, including custom adapters. */
+    /** Aggregate deadline for async work, checked cooperatively during synchronous work. Synchronous callbacks cannot be preempted. */
     maxInspectionMs?: number;
-    /** Maximum wall-clock time permitted for synchronous row-schema compilation. */
+    /** Reject synchronous schema compilation overruns after compilation returns. */
     maxSchemaCompileMs?: number;
 }
 /** Build the SDK-managed manifest/file inspector used by reconcileReporting. */

package/dist/lib/reporting/inspection.d.ts

@@ -2,7 +2,7 @@ import { type CanonicalReferenceResolver } from '../canonical-references';
 import { type SsrfFetchOptions } from '../net/ssrf-fetch';
 import type { ReportingControlTotal } from '../types/tools.generated';
 import type { ReportingInspectionContext, ReportingObservation } from './reconciliation';
-export type ReportingInspectionErrorCode = 'UNSUPPORTED_RESOURCE' | 'RESOURCE_READ_FAILED' | 'RESOURCE_NOT_READY' | 'RESOURCE_TOO_LARGE' | 'INSPECTION_TIMEOUT' | 'MANIFEST_DIGEST_MISMATCH' | 'MANIFEST_INVALID' | 'MANIFEST_INCOMPLETE' | 'MANIFEST_IDENTITY_MISMATCH' | 'MANIFEST_TOTAL_MISMATCH' | 'OBJECT_DUPLICATE' | 'OBJECT_SIZE_MISMATCH' | 'OBJECT_DIGEST_MISMATCH' | 'OBJECT_ROW_COUNT_MISMATCH' | 'FORMAT_UNSUPPORTED' | 'COMPRESSION_UNSUPPORTED' | 'ROW_SCHEMA_FETCH_FAILED' | 'ROW_SCHEMA_INVALID' | 'ROW_SCHEMA_VIOLATION' | 'REPORT_DEFINITION_FETCH_FAILED' | 'REPORT_DEFINITION_INVALID' | 'CANONICALIZATION_FETCH_FAILED' | 'CANONICALIZATION_INVALID' | 'ROW_COUNT_MISMATCH' | 'CONTROL_TOTAL_UNSUPPORTED' | 'CONTROL_TOTAL_MISMATCH' | 'CANONICAL_DIGEST_MISMATCH';
+export type ReportingInspectionErrorCode = 'CONSUMER_COMMIT_FAILED' | 'UNSUPPORTED_RESOURCE' | 'RESOURCE_READ_FAILED' | 'RESOURCE_NOT_READY' | 'RESOURCE_TOO_LARGE' | 'INSPECTION_TIMEOUT' | 'MANIFEST_DIGEST_MISMATCH' | 'MANIFEST_INVALID' | 'MANIFEST_INCOMPLETE' | 'MANIFEST_IDENTITY_MISMATCH' | 'MANIFEST_TOTAL_MISMATCH' | 'OBJECT_DUPLICATE' | 'OBJECT_SIZE_MISMATCH' | 'OBJECT_DIGEST_MISMATCH' | 'OBJECT_ROW_COUNT_MISMATCH' | 'FORMAT_UNSUPPORTED' | 'COMPRESSION_UNSUPPORTED' | 'ROW_SCHEMA_FETCH_FAILED' | 'ROW_SCHEMA_INVALID' | 'ROW_SCHEMA_VIOLATION' | 'REPORT_DEFINITION_FETCH_FAILED' | 'REPORT_DEFINITION_INVALID' | 'CANONICALIZATION_FETCH_FAILED' | 'CANONICALIZATION_INVALID' | 'ROW_COUNT_MISMATCH' | 'CONTROL_TOTAL_UNSUPPORTED' | 'CONTROL_TOTAL_MISMATCH' | 'CANONICAL_DIGEST_MISMATCH';
 export declare class ReportingInspectionError extends Error {
     readonly code: ReportingInspectionErrorCode;
     readonly retryable: boolean;
@@ -78,9 +78,9 @@ export interface ReportingManifestInspectorOptions<TCredential = unknown> {
     maxFiles?: number;
     maxRows?: number;
     maxRowBytes?: number;
-    /** Hard wall-clock budget for one inspection attempt, including custom adapters. */
+    /** Aggregate deadline for async work, checked cooperatively during synchronous work. Synchronous callbacks cannot be preempted. */
     maxInspectionMs?: number;
-    /** Maximum wall-clock time permitted for synchronous row-schema compilation. */
+    /** Reject synchronous schema compilation overruns after compilation returns. */
     maxSchemaCompileMs?: number;
 }
 /** Build the SDK-managed manifest/file inspector used by reconcileReporting. */