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

package/dist/lib/identity-3.3/trust.mjs

@@ -6,7 +6,7 @@ import { eTldPlusOne } from "../signing/agent-resolver/etld.mjs";
 import { parseStrictJson } from "../signing/agent-resolver/strict-json.mjs";
 import { parse as parseDomain } from "tldts";
 import schemas from "./schemas.draft.mjs";
-const ajv = new Ajv({ strict: false, allErrors: false });
+const ajv = new Ajv({ inlineRefs: false, strict: false, allErrors: false });
 addFormats(ajv);
 for (const schema of schemas) ajv.addSchema(schema);
 function validateIdentity33Schema(id, value) {
@@ -294,13 +294,16 @@ function authorityGroup(operator) {
   const provider = parseDomain(operator).domain;
   return `private:${provider ?? operator}`;
 }
+const INTERMEDIARY_FETCH_CONCURRENCY = 8;
 function grantsScope(grant, scope) {
   return grant.scopes.some(
     (granted) => granted === "*" || granted === scope || granted === "adcp:all" && scope.startsWith("adcp:")
   );
 }
 function grantMatches(grant, target, claim, now) {
-  if (registrableGrantee(grant.grantee) !== target) return false;
+  return registrableGrantee(grant.grantee) === target && grantCovers(grant, claim, now);
+}
+function grantCovers(grant, claim, now) {
   if (!grantsScope(grant, claim.scope)) return false;
   if (grant.agents && !grant.agents.some((agent) => grantAgentOrigin(agent.url) === canonicalAgentOrigin(claim.signerOrigin)))
     return false;
@@ -326,7 +329,6 @@ async function authorizeDemandGrant(claim, options) {
     ...grants.some((g) => g.valid_until) ? { expiresAt: Math.min(...grants.map((g) => g.valid_until ? Date.parse(g.valid_until) / 1e3 : Infinity)) } : {}
   });
   if (brand === operator && account === operator) return result("implicit", [brand]);
-  if (brand === operator && account !== operator) throw new IdentityAuthorizationError("grant_absent");
   let house;
   try {
     house = await options.resolveBrandHouse?.(claim.brand);
@@ -336,33 +338,44 @@ async function authorizeDemandGrant(claim, options) {
     unavailable(cause);
   }
   const authoritativeBrand = house ? eTldPlusOne(house.domain) : brand;
-  if (authoritativeBrand === operator && account === operator) return result("implicit", [brand, operator]);
+  const self = /* @__PURE__ */ new Set([brand, authoritativeBrand]);
+  if (self.has(account) && self.has(operator)) return result("implicit", [.../* @__PURE__ */ new Set([brand, account, operator])]);
   const grantClaim = house ? { ...claim, brand: { ...claim.brand, brand_id: house.brand_id } } : claim;
   const record = await options.evaluator.get(authoritativeBrand);
   if (record.status === "absent") {
     if (await options.legacyAuthorization?.(claim)) return result("legacy", [brand, account, operator]);
     throw new IdentityAuthorizationError("grant_absent");
   }
-  const first = (record.record.grants ?? []).filter((g) => grantMatches(g, account, grantClaim, now));
-  if (account === operator && first.length) return result("trust", [brand, operator], [first[0]]);
-  const selfOperated = account === brand || account === authoritativeBrand;
-  if (selfOperated && account !== operator) {
-    const direct = (record.record.grants ?? []).find((g) => grantMatches(g, operator, grantClaim, now));
-    if (direct) return result("trust", [brand, operator], [direct]);
+  const firsts = [];
+  for (const grant of record.record.grants ?? []) {
+    const grantee = registrableGrantee(grant.grantee);
+    if (grantee === void 0 || !grantCovers(grant, grantClaim, now)) continue;
+    if (!self.has(account) && account !== grantee) continue;
+    if (grantee === operator) return result("trust", [brand, operator], [grant]);
+    firsts.push({ grant, grantee });
+  }
+  const grantees = [...new Set(firsts.map((f) => f.grantee))];
+  const records = /* @__PURE__ */ new Map();
+  for (let i = 0; i < grantees.length; i += INTERMEDIARY_FETCH_CONCURRENCY) {
+    const batch = grantees.slice(i, i + INTERMEDIARY_FETCH_CONCURRENCY);
+    const settled = await Promise.allSettled(batch.map((grantee) => options.evaluator.get(grantee)));
+    settled.forEach(
+      (outcome, j) => records.set(batch[j], outcome.status === "fulfilled" ? outcome.value : { failed: outcome.reason })
+    );
   }
-  if (account !== operator && account !== brand && first.length) {
-    const intermediary = await options.evaluator.get(account);
-    if (intermediary.status === "present") {
-      const second = (intermediary.record.grants ?? []).find((g) => grantMatches(g, operator, grantClaim, now));
-      if (second) return result("trust", [brand, account, operator], [first[0], second]);
+  let outage;
+  for (const { grant: first, grantee } of firsts) {
+    const intermediary = records.get(grantee);
+    if ("failed" in intermediary) {
+      outage ??= intermediary.failed;
+      continue;
     }
+    if (intermediary.status !== "present") continue;
+    const second = (intermediary.record.grants ?? []).find((g) => grantMatches(g, operator, grantClaim, now));
+    if (second) return result("trust", [brand, grantee, operator], [first, second]);
   }
-  const covered = (record.record.grants ?? []).some((g) => {
-    const grantee = registrableGrantee(g.grantee);
-    return grantee !== void 0 && (grantee === account || selfOperated && grantee === operator) && grantsScope(g, claim.scope);
-  });
-  const exclusive = record.record.exclusive_grants === true && (record.record.grants ?? []).some((g) => grantsScope(g, claim.scope));
-  if (!covered && !exclusive && await options.sellerAuthorization?.(claim))
+  if (outage !== void 0) throw outage;
+  if (record.record.exclusive_grants !== true && await options.sellerAuthorization?.(claim))
     return result("seller", [brand, account, operator]);
   throw new IdentityAuthorizationError("grant_absent");
 }

package/dist/lib/identity-3.3/validation.js

@@ -34,6 +34,7 @@ module.exports = __toCommonJS(validation_exports);
 var import_ajv = __toESM(require("ajv"));
 var import_ajv_formats = __toESM(require("ajv-formats"));
 var import_schema_loader = require('../validation/schema-loader.js');
+var import_compact_schema = require('../validation/compact-schema.js');
 var import_schemas = __toESM(require('./schemas.draft.js'));
 const validators = /* @__PURE__ */ new WeakMap();
 function validateIdentity33Payload(tool, direction, payload, version) {
@@ -79,14 +80,15 @@ function validateIdentity33Payload(tool, direction, payload, version) {
       for (const [k, value] of Object.entries(object)) if (k !== "$id") walk2(value, k);
     };
     var walk = walk2;
-    const schema = structuredClone(stable.schema);
+    const document = (0, import_schema_loader.getToolSchemaDocument)(tool, direction === "request" ? "request" : "sync", version)?.schema ?? stable.schema;
+    const schema = structuredClone(direction === "response" ? (0, import_schema_loader.relaxResponseRoot)(document) : document);
     const relationship = import_schemas.default.find((s) => s.$id === "/schemas/core/principal-relationship.json");
     const onboarding = import_schemas.default.find((s) => s.$id === "/schemas/core/agent-onboarding.json");
     walk2(schema);
-    const ajv = new import_ajv.default({ strict: false, allErrors: true });
+    const ajv = new import_ajv.default({ inlineRefs: false, strict: false, allErrors: true });
     (0, import_ajv_formats.default)(ajv);
     for (const draft of import_schemas.default) ajv.addSchema({ ...draft, $id: "https://adcontextprotocol.org" + draft.$id });
-    validator = ajv.compile(schema);
+    validator = ajv.compile((0, import_compact_schema.compactSchemaForValidation)(schema));
     cache.set(key, validator);
   }
   let valid = validator(payload) === true;

package/dist/lib/identity-3.3/validation.mjs

@@ -1,6 +1,7 @@
 import Ajv from "ajv";
 import addFormats from "ajv-formats";
-import { getValidator } from "../validation/schema-loader.mjs";
+import { getValidator, getToolSchemaDocument, relaxResponseRoot } from "../validation/schema-loader.mjs";
+import { compactSchemaForValidation } from "../validation/compact-schema.mjs";
 import schemas from "./schemas.draft.mjs";
 const validators = /* @__PURE__ */ new WeakMap();
 function validateIdentity33Payload(tool, direction, payload, version) {
@@ -46,14 +47,15 @@ function validateIdentity33Payload(tool, direction, payload, version) {
       for (const [k, value] of Object.entries(object)) if (k !== "$id") walk2(value, k);
     };
     var walk = walk2;
-    const schema = structuredClone(stable.schema);
+    const document = getToolSchemaDocument(tool, direction === "request" ? "request" : "sync", version)?.schema ?? stable.schema;
+    const schema = structuredClone(direction === "response" ? relaxResponseRoot(document) : document);
     const relationship = schemas.find((s) => s.$id === "/schemas/core/principal-relationship.json");
     const onboarding = schemas.find((s) => s.$id === "/schemas/core/agent-onboarding.json");
     walk2(schema);
-    const ajv = new Ajv({ strict: false, allErrors: true });
+    const ajv = new Ajv({ inlineRefs: false, strict: false, allErrors: true });
     addFormats(ajv);
     for (const draft of schemas) ajv.addSchema({ ...draft, $id: "https://adcontextprotocol.org" + draft.$id });
-    validator = ajv.compile(schema);
+    validator = ajv.compile(compactSchemaForValidation(schema));
     cache.set(key, validator);
   }
   let valid = validator(payload) === true;

package/dist/lib/index.d.mts

@@ -57,7 +57,7 @@ export * from './handlers/types.mjs';
 export type { Storage, AtomicTakeStorage, DeferredTaskStorage, BatchStorage, PatternStorage, AgentCapabilities, ConversationState, DeferredTaskState, StorageConfig, StorageFactory, StorageMiddleware, } from './storage/interfaces.mjs';
 export { MemoryStorage, createMemoryStorage, createMemoryStorageConfig } from './storage/MemoryStorage.mjs';
 export { ADCPError, TaskTimeoutError, MaxClarificationError, DeferredTaskError, TaskAbortedError, AgentNotFoundError, UnsupportedTaskError, ProtocolError, ValidationError as ADCPValidationError, // Rename to avoid conflict
-MissingInputHandlerError, InvalidContextError, ConfigurationError, AuthenticationCredentialsRejectedError, AuthenticationRequiredError, FeatureUnsupportedError, ProtocolFeatureUnsupportedError, UnsupportedBuyingModeError, AccountRequiredError, AccountPendingApprovalError, AccountAmbiguousError, BuyerSetupError, AccountNotFoundError, AccountSetupRequiredError, AccountPaymentRequiredError, AccountNotProvisionedError, SDK_ERROR_TO_PROTOCOL_ERROR_CODE, VersionUnsupportedError, IdempotencyConflictError, IdempotencyExpiredError, ResponseTooLargeError, ActionNotAllowedError, PreparedFixturesDeniedError, adcpErrorToTypedError, getClientPreflightAdcpError, isADCPError, isErrorOfType, extractErrorInfo, is401Error, mapSdkErrorCodeToProtocolErrorCode, } from './errors/index.mjs';
+MissingInputHandlerError, InvalidContextError, ConfigurationError, AuthenticationCredentialsRejectedError, AuthenticationRequiredError, FeatureUnsupportedError, ProtocolFeatureUnsupportedError, UnsupportedBuyingModeError, AccountRequiredError, AccountPendingApprovalError, AccountAmbiguousError, BuyerSetupError, AccountNotFoundError, AccountSetupRequiredError, AccountPaymentRequiredError, AccountNotProvisionedError, SDK_ERROR_TO_PROTOCOL_ERROR_CODE, VersionUnsupportedError, IdempotencyConflictError, IdempotencyExpiredError, ResponseTooLargeError, AgentRateLimitedError, ActionNotAllowedError, PreparedFixturesDeniedError, adcpErrorToTypedError, getClientPreflightAdcpError, isADCPError, isErrorOfType, extractErrorInfo, is401Error, mapSdkErrorCodeToProtocolErrorCode, } from './errors/index.mjs';
 export type { OAuthMetadataInfo, ClientPreflightAdcpErrorInfo, ClientPreflightAdcpErrorRecovery, FeatureUnsupportedErrorOptions, ProtocolFeatureUnsupportedErrorOptions, ActionNotAllowedErrorDetails, ActionNotAllowedReasonValue, ActionNotAllowedAttemptedAction, ActionNotAllowedAvailableAction, ActionNotAllowedRecovery, } from './errors/index.mjs';
 export type { ActionNotAllowedDetails, ActionNotAllowedReason, AvailableActionsResult, AvailableActionsSource, DecomposedUpdateMediaBuy, DecomposedUpdateMediaBuyMutation, LegacyCoarseAction, MediaBuyActionContext, MediaBuyActionId, MediaBuyActionMode, MediaBuyAvailableAction, MediaBuyMutationDirection, MediaBuyMutationScope, MediaBuyUpdateFieldAction, MediaBuyValidAction, ModeMismatchRecovery, PreflightAllowed, PreflightDenial, PreflightDenied, BuyerPropertyPolicy, NormalizedPolicyDomain, ProductPolicyProductLike, ProductPolicyResolvedProperty, ProductPropertyPolicyIdentifier, ProductPropertyPolicyDiagnostic, ProductPropertyPolicyDiagnosticCode, ProductPropertyPolicyDiagnosticSeverity, ProductPropertyPolicyMode, ProductPropertyPolicySelectorBehavior, ProductPropertyPolicyValidationResult, PreflightResult, ResolvedAction, SLAWindow, SlaWindow, StructuredOnlyMediaBuyAction, ResolvedTargetingInput, TargetingInputFor, ValidateProductsAgainstPropertyPolicyOptions, UpdateFieldEntry, UpdateMediaBuyRequestLike, } from './media-buy/index.mjs';
 export { ACTIONS_BY_FIELD, LEGACY_COARSE_ACTIONS, STRUCTURED_ONLY_MEDIA_BUY_ACTIONS, UPDATE_FIELDS_BY_ACTION, applyTargetingInput, hasTargetingClears, resolveTargetingInput, canAddPackages, canCancel, canDecreaseBudget, canExtendFlight, canIncreaseBudget, canPause, canReallocateBudget, canRemoveCreative, canRemovePackages, canReplaceCreative, canResume, canShortenFlight, canUpdateCreativeAssignments, canUpdateFlightDates, canUpdateFrequencyCaps, canUpdatePacing, canUpdateTargeting, decomposeUpdateMediaBuy, findAvailableAction, getActionForMutation, getAvailableActions, getRollupParent, ProductPropertyPolicyError, normalizeDomainForPropertyPolicy, preflightUpdateMediaBuy, recoveryForModeMismatch, validateProductsAgainstPropertyPolicy, } from './media-buy/index.mjs';
@@ -75,27 +75,15 @@ export type { GetProductsRequest as LegacyGetProductsRequest, GetProductsRespons
 CreativeAsset as LegacyCompatibleCreativeAsset, CreativePolicy, BrandReference, BrandID, AccountReference, CPAPricingOption, EventType, ActionSource, OptimizationGoal, ReachUnit, TargetingOverlay, OutcomeMeasurementDeprecated, OutcomeMeasurementDeprecated as OutcomeMeasurement, Duration, DeviceType, DigitalSourceType, FrequencyCap, GeographicBreakdownSupport, Catalog, CatalogType, FeedFormat, UpdateFrequency, ContentIDType, CatalogFieldMapping, SyncCatalogsRequest, SyncCatalogsResponse, SyncCatalogsSuccess, SyncCatalogsError, Overlay, Placement as LegacyPlacement, CreativeManifest as LegacyCreativeManifest, CreativeVariable, BuildCreativeRequest as LegacyBuildCreativeRequest, BuildCreativeResponse as LegacyBuildCreativeResponse, BuildCreativeSuccess as LegacyBuildCreativeSuccess, BuildCreativeMultiSuccess as LegacyBuildCreativeMultiSuccess, BuildCreativeVariantSuccess as LegacyBuildCreativeVariantSuccess, BuildCreativeError as LegacyBuildCreativeError, PreviewCreativeRequest as LegacyPreviewCreativeRequest, PreviewCreativeResponse as LegacyPreviewCreativeResponse, GetMediaBuysRequest, GetMediaBuysResponse as LegacyGetMediaBuysResponse, ImageAsset, VideoAsset, AudioAsset, TextAsset, URLAsset, HTMLAsset, VASTAsset, DAASTAsset, JavaScriptAsset, WebhookAsset, CSSAsset, MarkdownAsset, CatalogAsset, BriefAsset, ReferenceAsset, Provenance, PreviewOutputFormat, DisclosurePosition, EventCustomData, GetCreativeDeliveryRequest, GetCreativeDeliveryResponse as LegacyGetCreativeDeliveryResponse, Account, AccountChange, ListAccountChangesRequest, ListAccountChangesResponse, ListAccountsRequest, ListAccountsResponse, SyncAccountsRequest, SyncAccountsResponse, SyncAccountsSuccess, SyncAccountsError, GetAccountFinancialsRequest, GetAccountFinancialsResponse, GetAccountFinancialsSuccess, GetAccountFinancialsError, PaginationRequest, PaginationResponse, PackageUpdate as LegacyPackageUpdate, Package as LegacyPackage, Destination, SignalFilters, PricingOption, PriceGuidance, } from './types/tools.generated.mjs';
 export type { GetMediaBuyArtifactsRequest as LegacyGetMediaBuyArtifactsRequest, GetMediaBuyArtifactsResponse as LegacyGetMediaBuyArtifactsResponse, } from './types/tools.generated.mjs';
 export type { GetRightsRequest as LegacyGetRightsRequest, GetRightsResponse as LegacyGetRightsResponse, AcquireRightsRequest as LegacyAcquireRightsRequest, AcquireRightsResponse as LegacyAcquireRightsResponse, UpdateRightsRequest as LegacyUpdateRightsRequest, UpdateRightsResponse as LegacyUpdateRightsResponse, } from './types/core.generated.mjs';
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type GetMediaBuyArtifactsRequest = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type GetMediaBuyArtifactsResponse = never;
 export type { FormatReferenceStructuredObject as LegacyFormatReferenceStructuredObject, FormatReferenceStructuredObject as LegacyFormatID, } from './types/core.generated.mjs';
 /** @deprecated Legacy creative routing identity is available as `LegacyFormatReferenceStructuredObject`. */
 export type FormatReferenceStructuredObject = never;
 /** @deprecated Legacy creative routing identity is available as `LegacyFormatID`. */
 export type FormatID = never;
-/** @deprecated Use `LegacyBuildCreativeRequest`; canonical build support awaits a canonical protocol request. */
-export type BuildCreativeRequest = never;
-/** @deprecated Use `LegacyBuildCreativeResponse`. */
-export type BuildCreativeResponse = never;
 /** @deprecated Use `LegacyBuildCreativePayload`. */
 export type BuildCreativePayload = never;
 /** @deprecated Use `LegacyBuildCreativeMultiPayload`. */
 export type BuildCreativeMultiPayload = never;
-/** @deprecated Use `LegacyListCreativeFormatsRequest`. */
-export type ListCreativeFormatsRequest = never;
-/** @deprecated Use `LegacyListCreativeFormatsResponse`. */
-export type ListCreativeFormatsResponse = never;
 /** @deprecated Use `LegacyListCreativeFormatsPayload`. */
 export type ListCreativeFormatsPayload = never;
 /** @deprecated Use `LegacyListCreativeFormatsResponsePayload`. */
@@ -118,49 +106,9 @@ export type UpdateMediaBuyAsyncResponseData = never;
 /** @deprecated Use `LegacySyncCreativesAsyncResponseData`. */
 export type SyncCreativesAsyncResponseData = never;
 /** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type ListContentStandardsRequest = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type ListContentStandardsResponse = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type GetContentStandardsRequest = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type GetContentStandardsResponse = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type CreateContentStandardsRequest = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type CreateContentStandardsResponse = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type UpdateContentStandardsRequest = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type UpdateContentStandardsResponse = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type CalibrateContentRequest = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type CalibrateContentResponse = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type ValidateContentDeliveryRequest = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type ValidateContentDeliveryResponse = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type GetCreativeFeaturesRequest = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type GetCreativeFeaturesResponse = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
 export type ContentStandards = never;
 /** @deprecated Use `LegacyArtifact` from the migration surface. */
 export type Artifact = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type GetRightsRequest = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type GetRightsResponse = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type AcquireRightsRequest = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type AcquireRightsResponse = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type UpdateRightsRequest = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type UpdateRightsResponse = never;
 export type { AccountStatus, CreativeStatus, DelegationAuthority, CatalogAction, CatalogItemStatus, MediaBuyStatus, CreativeBrief, CompatibilityPurchaseCoordinatorInput, } from './types/core.generated.mjs';
 export type { BrandJson, AdagentsJson } from './types/wellknown-schemas.generated.mjs';
 export { BrandJsonSchema, AdagentsJsonSchema } from './types/wellknown-schemas.generated.mjs';
@@ -279,3 +227,9 @@ 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 BuyerAccountDispatch, type BuyerAccountProvisioningDispatch, type EnsureAccountOptions, type ProvisionedAccount, } from './core/buyer-account-registry.mjs';
 export { createProductCache, ProductCache, type ProductCacheOptions } from './core/product-cache.mjs';
+export type { AssetVariant, DaypartTarget, TargetingOverlaySupport } from './types/core.generated.mjs';
+export { TargetingOverlayKeys, TargetingOverlaySupportKeys } from './types/targeting-keys.generated.mjs';
+export { parseMediaBuyDeliveryWebhook } from './webhooks/media-buy-delivery.mjs';
+export type { ParseMediaBuyDeliveryWebhookOptions, MediaBuyDeliveryWebhookEnvelope, MediaBuyDeliveryWebhookParseErrorCode, MediaBuyDeliveryWebhookParseResult, } from './webhooks/media-buy-delivery.mjs';
+export type { MediaBuyDeliveryReport } from './types/media-buy-delivery-report.mjs';
+export { MediaBuyDeliveryReportSchema } from './validation/media-buy-delivery-report.mjs';

package/dist/lib/index.d.ts

@@ -57,7 +57,7 @@ export * from './handlers/types';
 export type { Storage, AtomicTakeStorage, DeferredTaskStorage, BatchStorage, PatternStorage, AgentCapabilities, ConversationState, DeferredTaskState, StorageConfig, StorageFactory, StorageMiddleware, } from './storage/interfaces';
 export { MemoryStorage, createMemoryStorage, createMemoryStorageConfig } from './storage/MemoryStorage';
 export { ADCPError, TaskTimeoutError, MaxClarificationError, DeferredTaskError, TaskAbortedError, AgentNotFoundError, UnsupportedTaskError, ProtocolError, ValidationError as ADCPValidationError, // Rename to avoid conflict
-MissingInputHandlerError, InvalidContextError, ConfigurationError, AuthenticationCredentialsRejectedError, AuthenticationRequiredError, FeatureUnsupportedError, ProtocolFeatureUnsupportedError, UnsupportedBuyingModeError, AccountRequiredError, AccountPendingApprovalError, AccountAmbiguousError, BuyerSetupError, AccountNotFoundError, AccountSetupRequiredError, AccountPaymentRequiredError, AccountNotProvisionedError, SDK_ERROR_TO_PROTOCOL_ERROR_CODE, VersionUnsupportedError, IdempotencyConflictError, IdempotencyExpiredError, ResponseTooLargeError, ActionNotAllowedError, PreparedFixturesDeniedError, adcpErrorToTypedError, getClientPreflightAdcpError, isADCPError, isErrorOfType, extractErrorInfo, is401Error, mapSdkErrorCodeToProtocolErrorCode, } from './errors';
+MissingInputHandlerError, InvalidContextError, ConfigurationError, AuthenticationCredentialsRejectedError, AuthenticationRequiredError, FeatureUnsupportedError, ProtocolFeatureUnsupportedError, UnsupportedBuyingModeError, AccountRequiredError, AccountPendingApprovalError, AccountAmbiguousError, BuyerSetupError, AccountNotFoundError, AccountSetupRequiredError, AccountPaymentRequiredError, AccountNotProvisionedError, SDK_ERROR_TO_PROTOCOL_ERROR_CODE, VersionUnsupportedError, IdempotencyConflictError, IdempotencyExpiredError, ResponseTooLargeError, AgentRateLimitedError, ActionNotAllowedError, PreparedFixturesDeniedError, adcpErrorToTypedError, getClientPreflightAdcpError, isADCPError, isErrorOfType, extractErrorInfo, is401Error, mapSdkErrorCodeToProtocolErrorCode, } from './errors';
 export type { OAuthMetadataInfo, ClientPreflightAdcpErrorInfo, ClientPreflightAdcpErrorRecovery, FeatureUnsupportedErrorOptions, ProtocolFeatureUnsupportedErrorOptions, ActionNotAllowedErrorDetails, ActionNotAllowedReasonValue, ActionNotAllowedAttemptedAction, ActionNotAllowedAvailableAction, ActionNotAllowedRecovery, } from './errors';
 export type { ActionNotAllowedDetails, ActionNotAllowedReason, AvailableActionsResult, AvailableActionsSource, DecomposedUpdateMediaBuy, DecomposedUpdateMediaBuyMutation, LegacyCoarseAction, MediaBuyActionContext, MediaBuyActionId, MediaBuyActionMode, MediaBuyAvailableAction, MediaBuyMutationDirection, MediaBuyMutationScope, MediaBuyUpdateFieldAction, MediaBuyValidAction, ModeMismatchRecovery, PreflightAllowed, PreflightDenial, PreflightDenied, BuyerPropertyPolicy, NormalizedPolicyDomain, ProductPolicyProductLike, ProductPolicyResolvedProperty, ProductPropertyPolicyIdentifier, ProductPropertyPolicyDiagnostic, ProductPropertyPolicyDiagnosticCode, ProductPropertyPolicyDiagnosticSeverity, ProductPropertyPolicyMode, ProductPropertyPolicySelectorBehavior, ProductPropertyPolicyValidationResult, PreflightResult, ResolvedAction, SLAWindow, SlaWindow, StructuredOnlyMediaBuyAction, ResolvedTargetingInput, TargetingInputFor, ValidateProductsAgainstPropertyPolicyOptions, UpdateFieldEntry, UpdateMediaBuyRequestLike, } from './media-buy';
 export { ACTIONS_BY_FIELD, LEGACY_COARSE_ACTIONS, STRUCTURED_ONLY_MEDIA_BUY_ACTIONS, UPDATE_FIELDS_BY_ACTION, applyTargetingInput, hasTargetingClears, resolveTargetingInput, canAddPackages, canCancel, canDecreaseBudget, canExtendFlight, canIncreaseBudget, canPause, canReallocateBudget, canRemoveCreative, canRemovePackages, canReplaceCreative, canResume, canShortenFlight, canUpdateCreativeAssignments, canUpdateFlightDates, canUpdateFrequencyCaps, canUpdatePacing, canUpdateTargeting, decomposeUpdateMediaBuy, findAvailableAction, getActionForMutation, getAvailableActions, getRollupParent, ProductPropertyPolicyError, normalizeDomainForPropertyPolicy, preflightUpdateMediaBuy, recoveryForModeMismatch, validateProductsAgainstPropertyPolicy, } from './media-buy';
@@ -75,27 +75,15 @@ export type { GetProductsRequest as LegacyGetProductsRequest, GetProductsRespons
 CreativeAsset as LegacyCompatibleCreativeAsset, CreativePolicy, BrandReference, BrandID, AccountReference, CPAPricingOption, EventType, ActionSource, OptimizationGoal, ReachUnit, TargetingOverlay, OutcomeMeasurementDeprecated, OutcomeMeasurementDeprecated as OutcomeMeasurement, Duration, DeviceType, DigitalSourceType, FrequencyCap, GeographicBreakdownSupport, Catalog, CatalogType, FeedFormat, UpdateFrequency, ContentIDType, CatalogFieldMapping, SyncCatalogsRequest, SyncCatalogsResponse, SyncCatalogsSuccess, SyncCatalogsError, Overlay, Placement as LegacyPlacement, CreativeManifest as LegacyCreativeManifest, CreativeVariable, BuildCreativeRequest as LegacyBuildCreativeRequest, BuildCreativeResponse as LegacyBuildCreativeResponse, BuildCreativeSuccess as LegacyBuildCreativeSuccess, BuildCreativeMultiSuccess as LegacyBuildCreativeMultiSuccess, BuildCreativeVariantSuccess as LegacyBuildCreativeVariantSuccess, BuildCreativeError as LegacyBuildCreativeError, PreviewCreativeRequest as LegacyPreviewCreativeRequest, PreviewCreativeResponse as LegacyPreviewCreativeResponse, GetMediaBuysRequest, GetMediaBuysResponse as LegacyGetMediaBuysResponse, ImageAsset, VideoAsset, AudioAsset, TextAsset, URLAsset, HTMLAsset, VASTAsset, DAASTAsset, JavaScriptAsset, WebhookAsset, CSSAsset, MarkdownAsset, CatalogAsset, BriefAsset, ReferenceAsset, Provenance, PreviewOutputFormat, DisclosurePosition, EventCustomData, GetCreativeDeliveryRequest, GetCreativeDeliveryResponse as LegacyGetCreativeDeliveryResponse, Account, AccountChange, ListAccountChangesRequest, ListAccountChangesResponse, ListAccountsRequest, ListAccountsResponse, SyncAccountsRequest, SyncAccountsResponse, SyncAccountsSuccess, SyncAccountsError, GetAccountFinancialsRequest, GetAccountFinancialsResponse, GetAccountFinancialsSuccess, GetAccountFinancialsError, PaginationRequest, PaginationResponse, PackageUpdate as LegacyPackageUpdate, Package as LegacyPackage, Destination, SignalFilters, PricingOption, PriceGuidance, } from './types/tools.generated';
 export type { GetMediaBuyArtifactsRequest as LegacyGetMediaBuyArtifactsRequest, GetMediaBuyArtifactsResponse as LegacyGetMediaBuyArtifactsResponse, } from './types/tools.generated';
 export type { GetRightsRequest as LegacyGetRightsRequest, GetRightsResponse as LegacyGetRightsResponse, AcquireRightsRequest as LegacyAcquireRightsRequest, AcquireRightsResponse as LegacyAcquireRightsResponse, UpdateRightsRequest as LegacyUpdateRightsRequest, UpdateRightsResponse as LegacyUpdateRightsResponse, } from './types/core.generated';
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type GetMediaBuyArtifactsRequest = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type GetMediaBuyArtifactsResponse = never;
 export type { FormatReferenceStructuredObject as LegacyFormatReferenceStructuredObject, FormatReferenceStructuredObject as LegacyFormatID, } from './types/core.generated';
 /** @deprecated Legacy creative routing identity is available as `LegacyFormatReferenceStructuredObject`. */
 export type FormatReferenceStructuredObject = never;
 /** @deprecated Legacy creative routing identity is available as `LegacyFormatID`. */
 export type FormatID = never;
-/** @deprecated Use `LegacyBuildCreativeRequest`; canonical build support awaits a canonical protocol request. */
-export type BuildCreativeRequest = never;
-/** @deprecated Use `LegacyBuildCreativeResponse`. */
-export type BuildCreativeResponse = never;
 /** @deprecated Use `LegacyBuildCreativePayload`. */
 export type BuildCreativePayload = never;
 /** @deprecated Use `LegacyBuildCreativeMultiPayload`. */
 export type BuildCreativeMultiPayload = never;
-/** @deprecated Use `LegacyListCreativeFormatsRequest`. */
-export type ListCreativeFormatsRequest = never;
-/** @deprecated Use `LegacyListCreativeFormatsResponse`. */
-export type ListCreativeFormatsResponse = never;
 /** @deprecated Use `LegacyListCreativeFormatsPayload`. */
 export type ListCreativeFormatsPayload = never;
 /** @deprecated Use `LegacyListCreativeFormatsResponsePayload`. */
@@ -118,49 +106,9 @@ export type UpdateMediaBuyAsyncResponseData = never;
 /** @deprecated Use `LegacySyncCreativesAsyncResponseData`. */
 export type SyncCreativesAsyncResponseData = never;
 /** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type ListContentStandardsRequest = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type ListContentStandardsResponse = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type GetContentStandardsRequest = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type GetContentStandardsResponse = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type CreateContentStandardsRequest = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type CreateContentStandardsResponse = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type UpdateContentStandardsRequest = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type UpdateContentStandardsResponse = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type CalibrateContentRequest = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type CalibrateContentResponse = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type ValidateContentDeliveryRequest = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type ValidateContentDeliveryResponse = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type GetCreativeFeaturesRequest = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type GetCreativeFeaturesResponse = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
 export type ContentStandards = never;
 /** @deprecated Use `LegacyArtifact` from the migration surface. */
 export type Artifact = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type GetRightsRequest = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type GetRightsResponse = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type AcquireRightsRequest = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type AcquireRightsResponse = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type UpdateRightsRequest = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type UpdateRightsResponse = never;
 export type { AccountStatus, CreativeStatus, DelegationAuthority, CatalogAction, CatalogItemStatus, MediaBuyStatus, CreativeBrief, CompatibilityPurchaseCoordinatorInput, } from './types/core.generated';
 export type { BrandJson, AdagentsJson } from './types/wellknown-schemas.generated';
 export { BrandJsonSchema, AdagentsJsonSchema } from './types/wellknown-schemas.generated';
@@ -279,3 +227,9 @@ export * from './supply-path';
 export type { AuthorizationCollectionSelector, ProductCollectionSelector, CollectionDistribution, DiscoveryCollection, } from './discovery/types';
 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';
+export type { AssetVariant, DaypartTarget, TargetingOverlaySupport } from './types/core.generated';
+export { TargetingOverlayKeys, TargetingOverlaySupportKeys } from './types/targeting-keys.generated';
+export { parseMediaBuyDeliveryWebhook } from './webhooks/media-buy-delivery';
+export type { ParseMediaBuyDeliveryWebhookOptions, MediaBuyDeliveryWebhookEnvelope, MediaBuyDeliveryWebhookParseErrorCode, MediaBuyDeliveryWebhookParseResult, } from './webhooks/media-buy-delivery';
+export type { MediaBuyDeliveryReport } from './types/media-buy-delivery-report';
+export { MediaBuyDeliveryReportSchema } from './validation/media-buy-delivery-report';

package/dist/lib/index.js

@@ -49,6 +49,7 @@ __export(index_exports, {
   AgentClient: () => import_AgentClient.AgentClient,
   AgentNotFoundError: () => import_errors.AgentNotFoundError,
   AgentOAuthClientCredentialsSchema: () => import_oauth4.AgentOAuthClientCredentialsSchema,
+  AgentRateLimitedError: () => import_errors.AgentRateLimitedError,
   Asset: () => import_asset_builders.Asset,
   AsyncHandler: () => import_AsyncHandler.AsyncHandler,
   AuthenticationCredentialsRejectedError: () => import_errors.AuthenticationCredentialsRejectedError,
@@ -138,6 +139,7 @@ __export(index_exports, {
   MUTATING_TASKS: () => import_idempotency.MUTATING_TASKS,
   MacroInRawValueError: () => import_substitution.MacroInRawValueError,
   MaxClarificationError: () => import_errors.MaxClarificationError,
+  MediaBuyDeliveryReportSchema: () => import_media_buy_delivery_report.MediaBuyDeliveryReportSchema,
   MediaBuyLifecycleCompatibilityError: () => import_compatibility.MediaBuyLifecycleCompatibilityError,
   MediaBuyLifecycleCoordinator: () => import_compatibility.MediaBuyLifecycleCoordinator,
   MemoryStorage: () => import_MemoryStorage.MemoryStorage,
@@ -204,6 +206,8 @@ __export(index_exports, {
   TEST_AGENT_NO_AUTH_MCP_CONFIG: () => import_testing.TEST_AGENT_NO_AUTH_MCP_CONFIG,
   TEST_AGENT_TOKEN: () => import_testing.TEST_AGENT_TOKEN,
   TOOL_INPUT_SHAPE: () => import_server.TOOL_INPUT_SHAPE,
+  TargetingOverlayKeys: () => import_targeting_keys.TargetingOverlayKeys,
+  TargetingOverlaySupportKeys: () => import_targeting_keys.TargetingOverlaySupportKeys,
   TaskAbortedError: () => import_errors.TaskAbortedError,
   TaskExecutor: () => import_TaskExecutor.TaskExecutor,
   TaskTimeoutError: () => import_errors.TaskTimeoutError,
@@ -591,6 +595,7 @@ __export(index_exports, {
   parseAdcpMajorVersion: () => import_version.parseAdcpMajorVersion,
   parseCapabilitiesResponse: () => import_capabilities.parseCapabilitiesResponse,
   parseManagerDomain: () => import_validate_adagents.parseManagerDomain,
+  parseMediaBuyDeliveryWebhook: () => import_media_buy_delivery.parseMediaBuyDeliveryWebhook,
   parsePublisherPropertySelector: () => import_publisher_property_selector.parsePublisherPropertySelector,
   parseSseStream: () => import_registry2.parseSseStream,
   parseWWWAuthenticate: () => import_oauth.parseWWWAuthenticate,
@@ -852,6 +857,9 @@ var import_media_buy_action_resolver = require('./server/media-buy-action-resolv
 __reExport(index_exports, require('./supply-path/index.js'), module.exports);
 var import_buyer_account_registry = require('./core/buyer-account-registry.js');
 var import_product_cache = require('./core/product-cache.js');
+var import_targeting_keys = require('./types/targeting-keys.generated.js');
+var import_media_buy_delivery = require('./webhooks/media-buy-delivery.js');
+var import_media_buy_delivery_report = require('./validation/media-buy-delivery-report.js');
 const wireVersion = {
   isSupported: import_protocols2.bundleSupportsAdcpVersionField,
   normalize: import_schema_loader2.toReleasePrecisionWire,
@@ -896,6 +904,7 @@ function createAdCPClientFromEnv() {
   AgentClient,
   AgentNotFoundError,
   AgentOAuthClientCredentialsSchema,
+  AgentRateLimitedError,
   Asset,
   AsyncHandler,
   AuthenticationCredentialsRejectedError,
@@ -985,6 +994,7 @@ function createAdCPClientFromEnv() {
   MUTATING_TASKS,
   MacroInRawValueError,
   MaxClarificationError,
+  MediaBuyDeliveryReportSchema,
   MediaBuyLifecycleCompatibilityError,
   MediaBuyLifecycleCoordinator,
   MemoryStorage,
@@ -1051,6 +1061,8 @@ function createAdCPClientFromEnv() {
   TEST_AGENT_NO_AUTH_MCP_CONFIG,
   TEST_AGENT_TOKEN,
   TOOL_INPUT_SHAPE,
+  TargetingOverlayKeys,
+  TargetingOverlaySupportKeys,
   TaskAbortedError,
   TaskExecutor,
   TaskTimeoutError,
@@ -1438,6 +1450,7 @@ function createAdCPClientFromEnv() {
   parseAdcpMajorVersion,
   parseCapabilitiesResponse,
   parseManagerDomain,
+  parseMediaBuyDeliveryWebhook,
   parsePublisherPropertySelector,
   parseSseStream,
   parseWWWAuthenticate,

package/dist/lib/index.mjs

@@ -234,6 +234,7 @@ import {
   IdempotencyConflictError,
   IdempotencyExpiredError,
   ResponseTooLargeError,
+  AgentRateLimitedError,
   ActionNotAllowedError,
   PreparedFixturesDeniedError,
   adcpErrorToTypedError,
@@ -827,6 +828,9 @@ import {
   BuyerAccountRegistry
 } from "./core/buyer-account-registry.mjs";
 import { createProductCache, ProductCache } from "./core/product-cache.mjs";
+import { TargetingOverlayKeys, TargetingOverlaySupportKeys } from "./types/targeting-keys.generated.mjs";
+import { parseMediaBuyDeliveryWebhook } from "./webhooks/media-buy-delivery.mjs";
+import { MediaBuyDeliveryReportSchema } from "./validation/media-buy-delivery-report.mjs";
 export {
   A2AInvocationError,
   A2A_CARD_PATHS,
@@ -858,6 +862,7 @@ export {
   AgentClient,
   AgentNotFoundError,
   AgentOAuthClientCredentialsSchema,
+  AgentRateLimitedError,
   Asset,
   AsyncHandler,
   AuthenticationCredentialsRejectedError,
@@ -947,6 +952,7 @@ export {
   MUTATING_TASKS,
   MacroInRawValueError,
   MaxClarificationError,
+  MediaBuyDeliveryReportSchema,
   MediaBuyLifecycleCompatibilityError,
   MediaBuyLifecycleCoordinator,
   MemoryStorage,
@@ -1013,6 +1019,8 @@ export {
   TEST_AGENT_NO_AUTH_MCP_CONFIG,
   TEST_AGENT_TOKEN,
   TOOL_INPUT_SHAPE,
+  TargetingOverlayKeys,
+  TargetingOverlaySupportKeys,
   TaskAbortedError,
   TaskExecutor,
   TaskTimeoutError,
@@ -1400,6 +1408,7 @@ export {
   parseAdcpMajorVersion,
   parseCapabilitiesResponse,
   parseManagerDomain,
+  parseMediaBuyDeliveryWebhook,
   parsePublisherPropertySelector,
   parseSseStream,
   parseWWWAuthenticate,

package/dist/lib/media-buy/compatibility.js

@@ -6132,7 +6132,12 @@ class MediaBuyLifecycleCoordinator {
         });
         void new Promise((resolve) => setTimeout(resolve, 0)).then(async () => {
           while (!watchSignal.aborted) {
-            const task = await this.agent.getTaskStatus(sellerTaskId, settlementTransport, watchSignal, wireOptions);
+            const task = await this.agent.getTaskStatus(
+              sellerTaskId,
+              settlementTransport,
+              watchSignal,
+              wireOptions
+            );
             if (task.taskId !== sellerTaskId || task.taskType !== "create_media_buy") {
               throw this.legacyPurchaseAmbiguousError(
                 "The polled working seller task does not match the durably recorded create_media_buy task."

package/dist/lib/media-buy/compatibility.mjs

@@ -6120,7 +6120,12 @@ class MediaBuyLifecycleCoordinator {
         });
         void new Promise((resolve) => setTimeout(resolve, 0)).then(async () => {
           while (!watchSignal.aborted) {
-            const task = await this.agent.getTaskStatus(sellerTaskId, settlementTransport, watchSignal, wireOptions);
+            const task = await this.agent.getTaskStatus(
+              sellerTaskId,
+              settlementTransport,
+              watchSignal,
+              wireOptions
+            );
             if (task.taskId !== sellerTaskId || task.taskType !== "create_media_buy") {
               throw this.legacyPurchaseAmbiguousError(
                 "The polled working seller task does not match the durably recorded create_media_buy task."

package/dist/lib/protocols/mcp-modern.d.mts

@@ -41,6 +41,8 @@ export interface ModernMCPConnectionOptions {
     /** Use the v2 SDK's negotiated legacy client instead of handing off to v1. */
     handleLegacy?: boolean;
 }
+/** `Retry-After` recorded on an MCP connect error by {@link withRetryAfter}, if any. */
+export declare function retryAfterOf(error: unknown): string | undefined;
 /**
  * Try a tool call using the MCP 2026-07-28 protocol era.
  *

package/dist/lib/protocols/mcp-modern.d.ts

@@ -41,6 +41,8 @@ export interface ModernMCPConnectionOptions {
     /** Use the v2 SDK's negotiated legacy client instead of handing off to v1. */
     handleLegacy?: boolean;
 }
+/** `Retry-After` recorded on an MCP connect error by {@link withRetryAfter}, if any. */
+export declare function retryAfterOf(error: unknown): string | undefined;
 /**
  * Try a tool call using the MCP 2026-07-28 protocol era.
  *

package/dist/lib/protocols/mcp-modern.js

@@ -20,6 +20,7 @@ var mcp_modern_exports = {};
 __export(mcp_modern_exports, {
   closeModernMCPConnections: () => closeModernMCPConnections,
   probeModernMCPConnection: () => probeModernMCPConnection,
+  retryAfterOf: () => retryAfterOf,
   tryCallModernMCPTool: () => tryCallModernMCPTool,
   tryListModernMCPTools: () => tryListModernMCPTools
 });
@@ -248,9 +249,15 @@ async function createNegotiatedClient(cacheKey, options, authHeaders, useCachedD
     getCapability: options.signingContext.getCapability,
     adcpVersion: options.signingContext.adcpVersion
   }) : diagnosticFetch;
+  const transportFetch = (0, import_rawResponseCapture.wrapFetchWithCapture)(withPerRequestTraceHeaders(signedFetch));
+  let throttleRetryAfter;
   const transport = new import_client.StreamableHTTPClientTransport(new URL(options.agentUrl), {
     requestInit: { headers: (0, import_mcp_call_context.splitConnectionHeaders)(authHeaders).identity, redirect: "manual" },
-    fetch: (0, import_rawResponseCapture.wrapFetchWithCapture)(withPerRequestTraceHeaders(signedFetch)),
+    fetch: async (input, init) => {
+      const response = await transportFetch(input, init);
+      throttleRetryAfter = response.status === 429 || response.status === 503 ? response.headers.get("retry-after") ?? void 0 : void 0;
+      return response;
+    },
     ...options.authProvider && {
       authProvider: options.authProvider
     }
@@ -293,8 +300,22 @@ async function createNegotiatedClient(cacheKey, options, authHeaders, useCachedD
     if (isNegotiationAuthFailure(error) && !skipProbe && presentedStaticCredential(authHeaders, options.authProvider)) {
       return createNegotiatedClient(cacheKey, options, authHeaders, useCachedDiscovery, true);
     }
-    throw error;
+    throw withRetryAfter(error, throttleRetryAfter);
+  }
+}
+function withRetryAfter(error, retryAfter) {
+  if (retryAfter === void 0 || !error || typeof error !== "object") return error;
+  const status = httpStatusOf(error);
+  if (status !== 429 && status !== 503) return error;
+  try {
+    Object.defineProperty(error, "retryAfter", { value: retryAfter, enumerable: false, configurable: true });
+  } catch {
   }
+  return error;
+}
+function retryAfterOf(error) {
+  const value = error && typeof error === "object" ? error.retryAfter : void 0;
+  return typeof value === "string" ? value : void 0;
 }
 async function getOrCreateModernConnection(cacheKey, options, authHeaders) {
   for (let attempt = 0; ; attempt++) {
@@ -314,12 +335,12 @@ function createSharedModernConnection(cacheKey, options, authHeaders) {
   const promise = createNegotiatedClient(cacheKey, options, authHeaders).then(async (client) => {
     if ((client.getProtocolEra() === "modern" || options.handleLegacy === true) && generation === connectionGeneration) {
       modernConnections.set(cacheKey, client);
-      (0, import_mcp_scope.registerMCPConnectionScopeCleanup)("modern", cacheKey, async () => {
+      (0, import_mcp_scope.registerMCPConnectionScopeCleanup)("modern", cacheKey, async (terminateSession) => {
         if (modernConnections.get(cacheKey) !== client) return;
         modernConnections.delete(cacheKey);
         legacyConnectionExpiresAt.delete(cacheKey);
         modernDiscoveries.delete(cacheKey);
-        await closeModernClient(client);
+        await closeModernClient(client, terminateSession);
       });
       if (client.getProtocolEra() === "legacy") {
         legacyConnectionExpiresAt.set(cacheKey, Date.now() + LEGACY_CLASSIFICATION_TTL_MS);
@@ -341,7 +362,10 @@ function createSharedModernConnection(cacheKey, options, authHeaders) {
   return promise;
 }
 async function retireFailedConnection(cacheKey, client, error) {
-  if ((0, import_abort.isAbortOrTimeoutError)(error)) return;
+  if ((0, import_abort.isAbortOrTimeoutError)(error)) {
+    (0, import_mcp_scope.markMCPConnectionScopeInterrupted)();
+    return;
+  }
   if (modernConnections.get(cacheKey) === client) {
     modernConnections.delete(cacheKey);
     legacyConnectionExpiresAt.delete(cacheKey);
@@ -510,6 +534,7 @@ async function probeModernMCPConnection(agentUrl, authToken, customHeaders, opti
     options.allowPrivateIp
   );
   const scoped = (0, import_mcp_connection_policy.shouldReuseMCPConnection)(options.fetchFn !== void 0);
+  if (isKnownLegacy(cacheKey)) return { connected: false };
   let client;
   return (0, import_mcp_call_context.runWithMCPCallContext)(
     callContextFor({ customHeaders, requestTimeoutMs: options.requestTimeoutMs }),
@@ -650,6 +675,7 @@ async function closeModernMCPConnections() {
 0 && (module.exports = {
   closeModernMCPConnections,
   probeModernMCPConnection,
+  retryAfterOf,
   tryCallModernMCPTool,
   tryListModernMCPTools
 });