@adcp/sdk 14.0.0-rc.49 → 14.0.0-rc.51

package/dist/lib/errors/index.d.ts

@@ -72,6 +72,33 @@ export declare class UnsupportedTaskError extends ADCPError {
     readonly code = "UNSUPPORTED_TASK";
     constructor(agentId: string, taskName: string, supportedTasks?: string[] | undefined);
 }
+/** Seller did not declare the requested get_products buying mode. */
+export declare class UnsupportedBuyingModeError extends ADCPError {
+    readonly requestedMode: string | undefined;
+    readonly declaredModes: readonly string[];
+    readonly code = "UNSUPPORTED_BUYING_MODE";
+    constructor(requestedMode: string | undefined, declaredModes: readonly string[]);
+}
+/** A seller requires an account reference before an account-scoped request. */
+export declare class AccountRequiredError extends ADCPError {
+    readonly accountModel: 'explicit' | 'implicit';
+    readonly taskName: string;
+    readonly code = "ACCOUNT_REQUIRED";
+    constructor(accountModel: 'explicit' | 'implicit', taskName: string, reason?: string);
+}
+/** Account provisioning succeeded but the seller has not approved its use. */
+export declare class AccountPendingApprovalError extends ADCPError {
+    readonly account: import('../types').AccountReference;
+    readonly accountId?: string | undefined;
+    readonly code = "ACCOUNT_PENDING_APPROVAL";
+    constructor(account: import('../types').AccountReference, accountId?: string | undefined);
+}
+/** More than one active account matches the caller's selection hints. */
+export declare class AccountAmbiguousError extends ADCPError {
+    readonly candidates: readonly string[];
+    readonly code = "ACCOUNT_AMBIGUOUS";
+    constructor(candidates: readonly string[]);
+}
 /**
  * Error thrown when protocol communication fails
  */

package/dist/lib/errors/index.js

@@ -19,6 +19,9 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var errors_exports = {};
 __export(errors_exports, {
   ADCPError: () => ADCPError,
+  AccountAmbiguousError: () => AccountAmbiguousError,
+  AccountPendingApprovalError: () => AccountPendingApprovalError,
+  AccountRequiredError: () => AccountRequiredError,
   ActionNotAllowedError: () => ActionNotAllowedError,
   AgentNotFoundError: () => AgentNotFoundError,
   AuthenticationCredentialsRejectedError: () => AuthenticationCredentialsRejectedError,
@@ -37,6 +40,7 @@ __export(errors_exports, {
   SDK_ERROR_TO_PROTOCOL_ERROR_CODE: () => SDK_ERROR_TO_PROTOCOL_ERROR_CODE,
   TaskAbortedError: () => TaskAbortedError,
   TaskTimeoutError: () => TaskTimeoutError,
+  UnsupportedBuyingModeError: () => UnsupportedBuyingModeError,
   UnsupportedTaskError: () => UnsupportedTaskError,
   ValidationError: () => ValidationError,
   VersionUnsupportedError: () => VersionUnsupportedError,
@@ -129,6 +133,54 @@ class UnsupportedTaskError extends ADCPError {
   supportedTasks;
   code = "UNSUPPORTED_TASK";
 }
+class UnsupportedBuyingModeError extends ADCPError {
+  constructor(requestedMode, declaredModes) {
+    const requested = requestedMode ?? "an inferred wholesale mode";
+    const declared = declaredModes.length ? declaredModes.join(", ") : "(unknown)";
+    super(
+      `Seller does not support ${requested} buying mode. Declared modes: ${declared}. Supply a brief or choose a declared buying_mode after probing get_adcp_capabilities.`
+    );
+    this.requestedMode = requestedMode;
+    this.declaredModes = declaredModes;
+    this.details = { requested_mode: requestedMode, declared_modes: [...declaredModes] };
+  }
+  requestedMode;
+  declaredModes;
+  code = "UNSUPPORTED_BUYING_MODE";
+}
+class AccountRequiredError extends ADCPError {
+  constructor(accountModel, taskName, reason) {
+    super(
+      reason ?? `${taskName} requires an account for this ${accountModel}-account seller. ` + (accountModel === "explicit" ? "Call resolveAccount() to discover an account_id, then pass account: { account_id }." : "Call resolveAccount({ brand, operator }) to sync the account, then pass its natural key.")
+    );
+    this.accountModel = accountModel;
+    this.taskName = taskName;
+    this.details = { account_model: accountModel, task_name: taskName };
+  }
+  accountModel;
+  taskName;
+  code = "ACCOUNT_REQUIRED";
+}
+class AccountPendingApprovalError extends ADCPError {
+  constructor(account, accountId) {
+    super("The seller is reviewing this account. Wait for approval before making account-scoped requests.");
+    this.account = account;
+    this.accountId = accountId;
+    this.details = { status: "pending_approval", account_id: accountId, account };
+  }
+  account;
+  accountId;
+  code = "ACCOUNT_PENDING_APPROVAL";
+}
+class AccountAmbiguousError extends ADCPError {
+  constructor(candidates) {
+    super("Multiple eligible accounts. Supply brand/operator or a select callback.");
+    this.candidates = candidates;
+    this.details = { candidate_count: candidates.length };
+  }
+  candidates;
+  code = "ACCOUNT_AMBIGUOUS";
+}
 class ProtocolError extends ADCPError {
   constructor(protocol, message, originalError) {
     super(`${protocol.toUpperCase()} protocol error: ${message}`);
@@ -543,6 +595,9 @@ function extractErrorInfo(error) {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ADCPError,
+  AccountAmbiguousError,
+  AccountPendingApprovalError,
+  AccountRequiredError,
   ActionNotAllowedError,
   AgentNotFoundError,
   AuthenticationCredentialsRejectedError,
@@ -561,6 +616,7 @@ function extractErrorInfo(error) {
   SDK_ERROR_TO_PROTOCOL_ERROR_CODE,
   TaskAbortedError,
   TaskTimeoutError,
+  UnsupportedBuyingModeError,
   UnsupportedTaskError,
   ValidationError,
   VersionUnsupportedError,

package/dist/lib/errors/index.mjs

@@ -78,6 +78,54 @@ class UnsupportedTaskError extends ADCPError {
   supportedTasks;
   code = "UNSUPPORTED_TASK";
 }
+class UnsupportedBuyingModeError extends ADCPError {
+  constructor(requestedMode, declaredModes) {
+    const requested = requestedMode ?? "an inferred wholesale mode";
+    const declared = declaredModes.length ? declaredModes.join(", ") : "(unknown)";
+    super(
+      `Seller does not support ${requested} buying mode. Declared modes: ${declared}. Supply a brief or choose a declared buying_mode after probing get_adcp_capabilities.`
+    );
+    this.requestedMode = requestedMode;
+    this.declaredModes = declaredModes;
+    this.details = { requested_mode: requestedMode, declared_modes: [...declaredModes] };
+  }
+  requestedMode;
+  declaredModes;
+  code = "UNSUPPORTED_BUYING_MODE";
+}
+class AccountRequiredError extends ADCPError {
+  constructor(accountModel, taskName, reason) {
+    super(
+      reason ?? `${taskName} requires an account for this ${accountModel}-account seller. ` + (accountModel === "explicit" ? "Call resolveAccount() to discover an account_id, then pass account: { account_id }." : "Call resolveAccount({ brand, operator }) to sync the account, then pass its natural key.")
+    );
+    this.accountModel = accountModel;
+    this.taskName = taskName;
+    this.details = { account_model: accountModel, task_name: taskName };
+  }
+  accountModel;
+  taskName;
+  code = "ACCOUNT_REQUIRED";
+}
+class AccountPendingApprovalError extends ADCPError {
+  constructor(account, accountId) {
+    super("The seller is reviewing this account. Wait for approval before making account-scoped requests.");
+    this.account = account;
+    this.accountId = accountId;
+    this.details = { status: "pending_approval", account_id: accountId, account };
+  }
+  account;
+  accountId;
+  code = "ACCOUNT_PENDING_APPROVAL";
+}
+class AccountAmbiguousError extends ADCPError {
+  constructor(candidates) {
+    super("Multiple eligible accounts. Supply brand/operator or a select callback.");
+    this.candidates = candidates;
+    this.details = { candidate_count: candidates.length };
+  }
+  candidates;
+  code = "ACCOUNT_AMBIGUOUS";
+}
 class ProtocolError extends ADCPError {
   constructor(protocol, message, originalError) {
     super(`${protocol.toUpperCase()} protocol error: ${message}`);
@@ -491,6 +539,9 @@ function extractErrorInfo(error) {
 }
 export {
   ADCPError,
+  AccountAmbiguousError,
+  AccountPendingApprovalError,
+  AccountRequiredError,
   ActionNotAllowedError,
   AgentNotFoundError,
   AuthenticationCredentialsRejectedError,
@@ -509,6 +560,7 @@ export {
   SDK_ERROR_TO_PROTOCOL_ERROR_CODE,
   TaskAbortedError,
   TaskTimeoutError,
+  UnsupportedBuyingModeError,
   UnsupportedTaskError,
   ValidationError,
   VersionUnsupportedError,

package/dist/lib/index.d.mts

@@ -53,7 +53,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, SDK_ERROR_TO_PROTOCOL_ERROR_CODE, VersionUnsupportedError, IdempotencyConflictError, IdempotencyExpiredError, ResponseTooLargeError, ActionNotAllowedError, adcpErrorToTypedError, getClientPreflightAdcpError, isADCPError, isErrorOfType, extractErrorInfo, is401Error, mapSdkErrorCodeToProtocolErrorCode, } from './errors/index.mjs';
+MissingInputHandlerError, InvalidContextError, ConfigurationError, AuthenticationCredentialsRejectedError, AuthenticationRequiredError, FeatureUnsupportedError, ProtocolFeatureUnsupportedError, UnsupportedBuyingModeError, AccountRequiredError, AccountPendingApprovalError, AccountAmbiguousError, SDK_ERROR_TO_PROTOCOL_ERROR_CODE, VersionUnsupportedError, IdempotencyConflictError, IdempotencyExpiredError, ResponseTooLargeError, ActionNotAllowedError, 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, 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';
@@ -222,8 +222,9 @@ export type { BuildActivateSignalRequestOptions, DiscoveredSignal, NormalizedDis
 export { buildCreativeReturn, singleBuildCreativeReturn, multiBuildCreativeReturn, singleEnvelopedBuildCreativeReturn, multiEnvelopedBuildCreativeReturn, variantEnvelopedBuildCreativeReturn, } from './utils/build-creative-return-builders.mjs';
 export { previewCreative, singlePreviewCreativeResponse, batchPreviewCreativeResponse, variantPreviewCreativeResponse, } from './utils/preview-creative-builders.mjs';
 export { mediaBuyDeliveryNotification, scheduledMediaBuyDeliveryNotification, finalMediaBuyDeliveryNotification, delayedMediaBuyDeliveryNotification, adjustedMediaBuyDeliveryNotification, windowUpdateMediaBuyDeliveryNotification, } from './utils/media-buy-delivery-notification-builders.mjs';
-export { buildSyntheticCapabilities, buildSyntheticV3Capabilities, parseCapabilitiesResponse, supportsV3, supportsProtocol, supportsPropertyListFiltering, supportsContentStandards, supportsSyncCreatives, requiresOperatorAuth, requiresAccountForProducts, supportsSandbox, supportsExperimentalFeature, resolveFeature, listDeclaredFeatures, MEDIA_BUY_TOOLS, SIGNALS_TOOLS, GOVERNANCE_TOOLS, CREATIVE_TOOLS, EVENT_TRACKING_TOOLS, ACCOUNT_TOOLS, PROTOCOL_TOOLS, BRAND_RIGHTS_TOOLS, TASK_FEATURE_MAP, } from './utils/capabilities.mjs';
-export type { AdcpCapabilities, AdcpMajorVersion, AdcpProtocol, AccountCapabilities, MediaBuyFeatures, ToolInfo, FeatureName, } from './utils/capabilities.mjs';
+export { buildSyntheticCapabilities, buildSyntheticV3Capabilities, parseCapabilitiesResponse, supportsV3, supportsProtocol, supportsPropertyListFiltering, supportsContentStandards, supportsSyncCreatives, supportsBuyingMode, requiresOperatorAuth, requiresAccountForProducts, supportsSandbox, supportsExperimentalFeature, resolveFeature, listDeclaredFeatures, MEDIA_BUY_TOOLS, SIGNALS_TOOLS, GOVERNANCE_TOOLS, CREATIVE_TOOLS, EVENT_TRACKING_TOOLS, ACCOUNT_TOOLS, PROTOCOL_TOOLS, BRAND_RIGHTS_TOOLS, TASK_FEATURE_MAP, } from './utils/capabilities.mjs';
+export type { AdcpCapabilities, AdcpMajorVersion, AdcpProtocol, AccountCapabilities, BuyingMode, MediaBuyFeatures, ToolInfo, FeatureName, } from './utils/capabilities.mjs';
+export type { ResolveAccountOptions, ListedAccount } from './core/account-resolution.mjs';
 export { inlineCreativesForPackages, inlineCreativesForPackagesLegacy } from './utils/creative-delivery.mjs';
 export type { InlineCreativeAssignment, InlineCreativePackage, InlineCreativePackagePatch, InlineCreativesForPackagesOptions, InlineCreativesForPackagesLegacyOptions, LegacyInlineCreativePackage, } from './utils/creative-delivery.mjs';
 export { adaptPackageRequestForV2, adaptCreateMediaBuyRequestForV2, adaptUpdateMediaBuyRequestForV2, normalizePackageResponse, normalizeMediaBuyResponse, usesV2CreativeIds, usesV3CreativeAssignments, getCreativeIds, getCreativeAssignments, } from './utils/creative-adapter.mjs';

package/dist/lib/index.d.ts

@@ -53,7 +53,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, SDK_ERROR_TO_PROTOCOL_ERROR_CODE, VersionUnsupportedError, IdempotencyConflictError, IdempotencyExpiredError, ResponseTooLargeError, ActionNotAllowedError, adcpErrorToTypedError, getClientPreflightAdcpError, isADCPError, isErrorOfType, extractErrorInfo, is401Error, mapSdkErrorCodeToProtocolErrorCode, } from './errors';
+MissingInputHandlerError, InvalidContextError, ConfigurationError, AuthenticationCredentialsRejectedError, AuthenticationRequiredError, FeatureUnsupportedError, ProtocolFeatureUnsupportedError, UnsupportedBuyingModeError, AccountRequiredError, AccountPendingApprovalError, AccountAmbiguousError, SDK_ERROR_TO_PROTOCOL_ERROR_CODE, VersionUnsupportedError, IdempotencyConflictError, IdempotencyExpiredError, ResponseTooLargeError, ActionNotAllowedError, 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, 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';
@@ -222,8 +222,9 @@ export type { BuildActivateSignalRequestOptions, DiscoveredSignal, NormalizedDis
 export { buildCreativeReturn, singleBuildCreativeReturn, multiBuildCreativeReturn, singleEnvelopedBuildCreativeReturn, multiEnvelopedBuildCreativeReturn, variantEnvelopedBuildCreativeReturn, } from './utils/build-creative-return-builders';
 export { previewCreative, singlePreviewCreativeResponse, batchPreviewCreativeResponse, variantPreviewCreativeResponse, } from './utils/preview-creative-builders';
 export { mediaBuyDeliveryNotification, scheduledMediaBuyDeliveryNotification, finalMediaBuyDeliveryNotification, delayedMediaBuyDeliveryNotification, adjustedMediaBuyDeliveryNotification, windowUpdateMediaBuyDeliveryNotification, } from './utils/media-buy-delivery-notification-builders';
-export { buildSyntheticCapabilities, buildSyntheticV3Capabilities, parseCapabilitiesResponse, supportsV3, supportsProtocol, supportsPropertyListFiltering, supportsContentStandards, supportsSyncCreatives, requiresOperatorAuth, requiresAccountForProducts, supportsSandbox, supportsExperimentalFeature, resolveFeature, listDeclaredFeatures, MEDIA_BUY_TOOLS, SIGNALS_TOOLS, GOVERNANCE_TOOLS, CREATIVE_TOOLS, EVENT_TRACKING_TOOLS, ACCOUNT_TOOLS, PROTOCOL_TOOLS, BRAND_RIGHTS_TOOLS, TASK_FEATURE_MAP, } from './utils/capabilities';
-export type { AdcpCapabilities, AdcpMajorVersion, AdcpProtocol, AccountCapabilities, MediaBuyFeatures, ToolInfo, FeatureName, } from './utils/capabilities';
+export { buildSyntheticCapabilities, buildSyntheticV3Capabilities, parseCapabilitiesResponse, supportsV3, supportsProtocol, supportsPropertyListFiltering, supportsContentStandards, supportsSyncCreatives, supportsBuyingMode, requiresOperatorAuth, requiresAccountForProducts, supportsSandbox, supportsExperimentalFeature, resolveFeature, listDeclaredFeatures, MEDIA_BUY_TOOLS, SIGNALS_TOOLS, GOVERNANCE_TOOLS, CREATIVE_TOOLS, EVENT_TRACKING_TOOLS, ACCOUNT_TOOLS, PROTOCOL_TOOLS, BRAND_RIGHTS_TOOLS, TASK_FEATURE_MAP, } from './utils/capabilities';
+export type { AdcpCapabilities, AdcpMajorVersion, AdcpProtocol, AccountCapabilities, BuyingMode, MediaBuyFeatures, ToolInfo, FeatureName, } from './utils/capabilities';
+export type { ResolveAccountOptions, ListedAccount } from './core/account-resolution';
 export { inlineCreativesForPackages, inlineCreativesForPackagesLegacy } from './utils/creative-delivery';
 export type { InlineCreativeAssignment, InlineCreativePackage, InlineCreativePackagePatch, InlineCreativesForPackagesOptions, InlineCreativesForPackagesLegacyOptions, LegacyInlineCreativePackage, } from './utils/creative-delivery';
 export { adaptPackageRequestForV2, adaptCreateMediaBuyRequestForV2, adaptUpdateMediaBuyRequestForV2, normalizePackageResponse, normalizeMediaBuyResponse, usesV2CreativeIds, usesV3CreativeAssignments, getCreativeIds, getCreativeAssignments, } from './utils/creative-adapter';

package/dist/lib/index.js

@@ -36,6 +36,9 @@ __export(index_exports, {
   AISISessionManager: () => import_adapters.AISISessionManager,
   ANNEX_III_POLICY_IDS: () => import_governance.ANNEX_III_POLICY_IDS,
   AUTH_DIAGNOSIS_SCHEMA_VERSION: () => import_oauth2.AUTH_DIAGNOSIS_SCHEMA_VERSION,
+  AccountAmbiguousError: () => import_errors.AccountAmbiguousError,
+  AccountPendingApprovalError: () => import_errors.AccountPendingApprovalError,
+  AccountRequiredError: () => import_errors.AccountRequiredError,
   ActionNotAllowedError: () => import_errors.ActionNotAllowedError,
   AdCPClient: () => AdCPClient,
   AdagentsJsonSchema: () => import_wellknown_schemas.AdagentsJsonSchema,
@@ -195,6 +198,7 @@ __export(index_exports, {
   UPDATE_FIELDS_BY_ACTION: () => import_media_buy.UPDATE_FIELDS_BY_ACTION,
   UnknownHostError: () => import_server.UnknownHostError,
   UnsafeNativeMappingError: () => import_substitution.UnsafeNativeMappingError,
+  UnsupportedBuyingModeError: () => import_errors.UnsupportedBuyingModeError,
   UnsupportedFeatureError: () => import_SingleAgentClient.UnsupportedFeatureError,
   UnsupportedTaskError: () => import_errors.UnsupportedTaskError,
   VERSION_INFO: () => import_version.VERSION_INFO,
@@ -634,6 +638,7 @@ __export(index_exports, {
   stripAgentCardPath: () => import_utils6.stripAgentCardPath,
   structuredDeserialize: () => import_server.structuredDeserialize,
   structuredSerialize: () => import_server.structuredSerialize,
+  supportsBuyingMode: () => import_capabilities.supportsBuyingMode,
   supportsContentStandards: () => import_capabilities.supportsContentStandards,
   supportsExperimentalFeature: () => import_capabilities.supportsExperimentalFeature,
   supportsPropertyListFiltering: () => import_capabilities.supportsPropertyListFiltering,
@@ -855,6 +860,9 @@ function createAdCPClientFromEnv() {
   AISISessionManager,
   ANNEX_III_POLICY_IDS,
   AUTH_DIAGNOSIS_SCHEMA_VERSION,
+  AccountAmbiguousError,
+  AccountPendingApprovalError,
+  AccountRequiredError,
   ActionNotAllowedError,
   AdCPClient,
   AdagentsJsonSchema,
@@ -1014,6 +1022,7 @@ function createAdCPClientFromEnv() {
   UPDATE_FIELDS_BY_ACTION,
   UnknownHostError,
   UnsafeNativeMappingError,
+  UnsupportedBuyingModeError,
   UnsupportedFeatureError,
   UnsupportedTaskError,
   VERSION_INFO,
@@ -1453,6 +1462,7 @@ function createAdCPClientFromEnv() {
   stripAgentCardPath,
   structuredDeserialize,
   structuredSerialize,
+  supportsBuyingMode,
   supportsContentStandards,
   supportsExperimentalFeature,
   supportsPropertyListFiltering,

package/dist/lib/index.mjs

@@ -216,6 +216,10 @@ import {
   AuthenticationRequiredError,
   FeatureUnsupportedError,
   ProtocolFeatureUnsupportedError,
+  UnsupportedBuyingModeError,
+  AccountRequiredError,
+  AccountPendingApprovalError,
+  AccountAmbiguousError,
   SDK_ERROR_TO_PROTOCOL_ERROR_CODE,
   VersionUnsupportedError,
   IdempotencyConflictError,
@@ -603,6 +607,7 @@ import {
   supportsPropertyListFiltering,
   supportsContentStandards,
   supportsSyncCreatives,
+  supportsBuyingMode,
   requiresOperatorAuth,
   requiresAccountForProducts,
   supportsSandbox,
@@ -813,6 +818,9 @@ export {
   AISISessionManager,
   ANNEX_III_POLICY_IDS,
   AUTH_DIAGNOSIS_SCHEMA_VERSION,
+  AccountAmbiguousError,
+  AccountPendingApprovalError,
+  AccountRequiredError,
   ActionNotAllowedError,
   AdCPClient,
   AdagentsJsonSchema,
@@ -972,6 +980,7 @@ export {
   UPDATE_FIELDS_BY_ACTION,
   UnknownHostError,
   UnsafeNativeMappingError,
+  UnsupportedBuyingModeError,
   UnsupportedFeatureError,
   UnsupportedTaskError,
   VERSION_INFO,
@@ -1411,6 +1420,7 @@ export {
   stripAgentCardPath,
   structuredDeserialize,
   structuredSerialize,
+  supportsBuyingMode,
   supportsContentStandards,
   supportsExperimentalFeature,
   supportsPropertyListFiltering,

package/dist/lib/schemas-data/3.1/a2ui/bound-value.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.18/a2ui/bound-value.json",
+  "$id": "/schemas/3.1.24/a2ui/bound-value.json",
   "title": "A2UI Bound Value",
   "description": "A value that can be a literal or bound to a path in the data model",
   "oneOf": [

package/dist/lib/schemas-data/3.1/a2ui/component.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.18/a2ui/component.json",
+  "$id": "/schemas/3.1.24/a2ui/component.json",
   "title": "A2UI Component",
   "description": "A component in an A2UI surface",
   "type": "object",

package/dist/lib/schemas-data/3.1/a2ui/si-catalog.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.18/a2ui/si-catalog.json",
+  "$id": "/schemas/3.1.24/a2ui/si-catalog.json",
   "title": "SI Component Catalog",
   "description": "A2UI component catalog for Sponsored Intelligence",
   "definitions": {
@@ -9,7 +9,7 @@
       "description": "Text display component",
       "properties": {
         "text": {
-          "$ref": "/schemas/3.1.18/a2ui/bound-value.json",
+          "$ref": "/schemas/3.1.24/a2ui/bound-value.json",
           "description": "Text content to display"
         },
         "variant": {
@@ -32,7 +32,7 @@
       "description": "Interactive button component",
       "properties": {
         "label": {
-          "$ref": "/schemas/3.1.18/a2ui/bound-value.json",
+          "$ref": "/schemas/3.1.24/a2ui/bound-value.json",
           "description": "Button label text"
         },
         "action": {
@@ -47,7 +47,7 @@
               "type": "object",
               "description": "Context data to include with action",
               "additionalProperties": {
-                "$ref": "/schemas/3.1.18/a2ui/bound-value.json"
+                "$ref": "/schemas/3.1.24/a2ui/bound-value.json"
               }
             }
           },
@@ -65,7 +65,7 @@
           "default": "primary"
         },
         "disabled": {
-          "$ref": "/schemas/3.1.18/a2ui/bound-value.json"
+          "$ref": "/schemas/3.1.24/a2ui/bound-value.json"
         }
       },
       "required": [
@@ -78,11 +78,11 @@
       "description": "Hyperlink component",
       "properties": {
         "label": {
-          "$ref": "/schemas/3.1.18/a2ui/bound-value.json",
+          "$ref": "/schemas/3.1.24/a2ui/bound-value.json",
           "description": "Link text"
         },
         "url": {
-          "$ref": "/schemas/3.1.18/a2ui/bound-value.json",
+          "$ref": "/schemas/3.1.24/a2ui/bound-value.json",
           "description": "URL to navigate to"
         },
         "external": {
@@ -101,11 +101,11 @@
       "description": "Image display component",
       "properties": {
         "src": {
-          "$ref": "/schemas/3.1.18/a2ui/bound-value.json",
+          "$ref": "/schemas/3.1.24/a2ui/bound-value.json",
           "description": "Image source URL"
         },
         "alt": {
-          "$ref": "/schemas/3.1.18/a2ui/bound-value.json",
+          "$ref": "/schemas/3.1.24/a2ui/bound-value.json",
           "description": "Alt text for accessibility"
         },
         "width": {
@@ -127,19 +127,19 @@
       "description": "Card container for grouped content",
       "properties": {
         "title": {
-          "$ref": "/schemas/3.1.18/a2ui/bound-value.json",
+          "$ref": "/schemas/3.1.24/a2ui/bound-value.json",
           "description": "Card title"
         },
         "subtitle": {
-          "$ref": "/schemas/3.1.18/a2ui/bound-value.json",
+          "$ref": "/schemas/3.1.24/a2ui/bound-value.json",
           "description": "Card subtitle"
         },
         "image": {
-          "$ref": "/schemas/3.1.18/a2ui/bound-value.json",
+          "$ref": "/schemas/3.1.24/a2ui/bound-value.json",
           "description": "Card image URL"
         },
         "badge": {
-          "$ref": "/schemas/3.1.18/a2ui/bound-value.json",
+          "$ref": "/schemas/3.1.24/a2ui/bound-value.json",
           "description": "Badge text (e.g., 'New', 'Sale')"
         },
         "action": {
@@ -152,7 +152,7 @@
             "context": {
               "type": "object",
               "additionalProperties": {
-                "$ref": "/schemas/3.1.18/a2ui/bound-value.json"
+                "$ref": "/schemas/3.1.24/a2ui/bound-value.json"
               }
             }
           },
@@ -177,27 +177,27 @@
       "description": "Product display card (SI-specific)",
       "properties": {
         "title": {
-          "$ref": "/schemas/3.1.18/a2ui/bound-value.json",
+          "$ref": "/schemas/3.1.24/a2ui/bound-value.json",
           "description": "Product name"
         },
         "price": {
-          "$ref": "/schemas/3.1.18/a2ui/bound-value.json",
+          "$ref": "/schemas/3.1.24/a2ui/bound-value.json",
           "description": "Price display string"
         },
         "image": {
-          "$ref": "/schemas/3.1.18/a2ui/bound-value.json",
+          "$ref": "/schemas/3.1.24/a2ui/bound-value.json",
           "description": "Product image URL"
         },
         "description": {
-          "$ref": "/schemas/3.1.18/a2ui/bound-value.json",
+          "$ref": "/schemas/3.1.24/a2ui/bound-value.json",
           "description": "Product description"
         },
         "badge": {
-          "$ref": "/schemas/3.1.18/a2ui/bound-value.json",
+          "$ref": "/schemas/3.1.24/a2ui/bound-value.json",
           "description": "Badge text (e.g., 'Best Seller')"
         },
         "ctaLabel": {
-          "$ref": "/schemas/3.1.18/a2ui/bound-value.json",
+          "$ref": "/schemas/3.1.24/a2ui/bound-value.json",
           "description": "CTA button label"
         },
         "action": {
@@ -209,7 +209,7 @@
             "context": {
               "type": "object",
               "additionalProperties": {
-                "$ref": "/schemas/3.1.18/a2ui/bound-value.json"
+                "$ref": "/schemas/3.1.24/a2ui/bound-value.json"
               }
             }
           },
@@ -228,7 +228,7 @@
       "description": "Data-bound list component",
       "properties": {
         "items": {
-          "$ref": "/schemas/3.1.18/a2ui/bound-value.json",
+          "$ref": "/schemas/3.1.24/a2ui/bound-value.json",
           "description": "Path to array in data model"
         },
         "template": {
@@ -245,7 +245,7 @@
           ]
         },
         "emptyMessage": {
-          "$ref": "/schemas/3.1.18/a2ui/bound-value.json",
+          "$ref": "/schemas/3.1.24/a2ui/bound-value.json",
           "description": "Message to show when list is empty"
         },
         "layout": {
@@ -349,11 +349,11 @@
           "description": "Integration type"
         },
         "label": {
-          "$ref": "/schemas/3.1.18/a2ui/bound-value.json",
+          "$ref": "/schemas/3.1.24/a2ui/bound-value.json",
           "description": "Button label"
         },
         "url": {
-          "$ref": "/schemas/3.1.18/a2ui/bound-value.json",
+          "$ref": "/schemas/3.1.24/a2ui/bound-value.json",
           "description": "Integration endpoint URL"
         },
         "highlighted": {

package/dist/lib/schemas-data/3.1/a2ui/surface.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.18/a2ui/surface.json",
+  "$id": "/schemas/3.1.24/a2ui/surface.json",
   "title": "A2UI Surface",
   "description": "A contiguous UI region containing components",
   "type": "object",
@@ -18,7 +18,7 @@
       "type": "array",
       "description": "Flat list of components (adjacency list structure)",
       "items": {
-        "$ref": "/schemas/3.1.18/a2ui/component.json"
+        "$ref": "/schemas/3.1.24/a2ui/component.json"
       }
     },
     "rootId": {

package/dist/lib/schemas-data/3.1/a2ui/user-action.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.18/a2ui/user-action.json",
+  "$id": "/schemas/3.1.24/a2ui/user-action.json",
   "title": "A2UI User Action",
   "description": "User interaction event sent from client to agent",
   "type": "object",

package/dist/lib/schemas-data/3.1/aao/agent-publishers.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.18/aao/agent-publishers.json",
+  "$id": "/schemas/3.1.24/aao/agent-publishers.json",
   "title": "AAO Directory: Agent → Publishers Inverse Lookup Response",
   "description": "Response envelope for `GET /v1/agents/{agent_url}/publishers` against an AAO-compatible directory. Returns the set of publishers whose adagents.json authorizes the given agent_url, with provenance (discovery_method, manager_domain), per-publisher property counts, and lifecycle status. The publisher's own adagents.json remains the trust root; this endpoint is discovery, not authorization. Each `publisher_domain` row tells the operator which publishers to verify directly via the SDK's per-domain primitives.",
   "type": "object",

package/dist/lib/schemas-data/3.1/account/get-account-financials-request.json

@@ -1,28 +1,28 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.18/account/get-account-financials-request.json",
+  "$id": "/schemas/3.1.24/account/get-account-financials-request.json",
   "title": "Get Account Financials Request",
   "description": "Request financial status for an operator-billed account. Returns spend summary, credit/balance status, and invoice history. Only applicable when the seller declares account_financials capability.",
   "type": "object",
   "allOf": [
     {
-      "$ref": "/schemas/3.1.18/core/version-envelope.json"
+      "$ref": "/schemas/3.1.24/core/version-envelope.json"
     }
   ],
   "properties": {
     "account": {
-      "$ref": "/schemas/3.1.18/core/account-ref.json",
+      "$ref": "/schemas/3.1.24/core/account-ref.json",
       "description": "Account to query financials for. Must be an operator-billed account."
     },
     "period": {
-      "$ref": "/schemas/3.1.18/core/date-range.json",
+      "$ref": "/schemas/3.1.24/core/date-range.json",
       "description": "Date range for the spend summary. Defaults to the current billing cycle if omitted."
     },
     "context": {
-      "$ref": "/schemas/3.1.18/core/context.json"
+      "$ref": "/schemas/3.1.24/core/context.json"
     },
     "ext": {
-      "$ref": "/schemas/3.1.18/core/ext.json"
+      "$ref": "/schemas/3.1.24/core/ext.json"
     }
   },
   "required": [