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

package/dist/lib/core/ResponseValidator.js

@@ -252,7 +252,7 @@ class ResponseValidator {
     if (!schema) {
       return null;
     }
-    const validatePayload = data && typeof data === "object" && !Array.isArray(data) ? (0, import_envelope_status_compat.injectLegacyEnvelopeStatus)(data, { toolName }) : data;
+    const validatePayload = data && typeof data === "object" && !Array.isArray(data) ? (0, import_envelope_status_compat.injectLegacyEnvelopeStatus)(data, { toolName, adcpVersion: responseAdcpVersion }) : data;
     const result = schema.safeParse((0, import_response_schemas.prepareResponseForSchemaValidation)(toolName, validatePayload, responseAdcpVersion));
     return result.success ? null : result.error;
   }

package/dist/lib/core/ResponseValidator.mjs

@@ -228,7 +228,7 @@ class ResponseValidator {
     if (!schema) {
       return null;
     }
-    const validatePayload = data && typeof data === "object" && !Array.isArray(data) ? injectLegacyEnvelopeStatus(data, { toolName }) : data;
+    const validatePayload = data && typeof data === "object" && !Array.isArray(data) ? injectLegacyEnvelopeStatus(data, { toolName, adcpVersion: responseAdcpVersion }) : data;
     const result = schema.safeParse(prepareResponseForSchemaValidation(toolName, validatePayload, responseAdcpVersion));
     return result.success ? null : result.error;
   }

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

@@ -1,3 +1,6 @@
+import type { MediaBuyDeliveryWebhookEnvelope } from '../webhooks/media-buy-delivery.mjs';
+import type * as ToolTypes from '../types/tools.generated.mjs';
+import type * as CoreTypes from '../types/core.generated.mjs';
 import { type ListProductsResponseWithSupplyPath, type ProductSupplyPathOptions } from '../supply-path/products.mjs';
 import type { AccountReference, AgentConfig } from '../types/index.mjs';
 import { type AdcpVersion } from '../version.mjs';
@@ -141,6 +144,8 @@ export interface WebhookVerificationConfig {
     fetchCapabilities?: (agentUrl: string, protocol: 'mcp' | 'a2a') => Promise<unknown>;
 }
 export interface VerifyAndParseWebhookOptions {
+    /** Trusted seller/buy release for registered reporting delivery validation; defaults to the client pin. */
+    adcpVersion?: string;
     /** Raw HTTP body bytes captured before JSON parsing. Required when `webhookSecret` is configured. */
     rawBody?: string | Buffer | Uint8Array;
     /** Parsed payload or raw body. When HMAC is configured, verified raw bytes are parsed instead of `payload`. */
@@ -189,7 +194,7 @@ export type WebhookParseResult = WebhookParseSuccess | WebhookParseFailure;
 export interface WebhookParseSuccess {
     ok: true;
     protocol: 'mcp' | 'a2a';
-    envelope: MCPWebhookPayload | A2ATask | TaskStatusUpdateEvent;
+    envelope: MCPWebhookPayload | MediaBuyDeliveryWebhookEnvelope | A2ATask | TaskStatusUpdateEvent;
     result: unknown;
     metadata: {
         taskId: string;
@@ -209,6 +214,8 @@ export interface WebhookParseFailure {
     ok: false;
     code: WebhookParseErrorCode;
     message: string;
+    /** Readable schema paths, when delivery payload validation fails. */
+    errors?: readonly string[];
     cause?: unknown;
 }
 export declare class WebhookDispatchError extends Error {
@@ -674,6 +681,13 @@ export declare class SingleAgentClient {
      * Local observation failures do not publish seller terminal lifecycle events.
      */
     trackTask<T = unknown>(request: TrackTaskRequest): Promise<TrackedTask<T>>;
+    /** Execute the typed AdCP get_task_status tool, including its result and error fields. */
+    getTaskStatus(params: ToolTypes.GetTaskStatusRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.GetTaskStatusResponse>>;
+    /** Poll one task and map its status to TaskInfo. Preserved for existing callers. */
+    getTaskStatus(taskId: string, transport?: import('../protocols/index.mjs').TransportOptions, signal?: AbortSignal, wireOptions?: {
+        wireAdcpVersion?: string;
+        versionEnvelope?: import('../protocols/index.mjs').VersionEnvelopeMode;
+    }): Promise<TaskInfo>;
     /** Recover the current generation of an opt-in direct mutation pause. */
     recoverDirectPauseContinuation<T>(request: DirectPauseRecoveryRequest): Promise<TaskResult<T>>;
     private recoverDurableSettlement;
@@ -726,6 +740,9 @@ export declare class SingleAgentClient {
      * - A validated MCP protected-resource metadata chain yields NeedsAuthorizationError
      * - Otherwise AuthenticationRequiredError carries the advertised challenge
      *
+     * Rate limiting (429, or 503 with Retry-After) stops probing at that URL and
+     * throws AgentRateLimitedError carrying the status and Retry-After.
+     *
      * Note: This is async and called lazily on first agent interaction
      */
     private discoverMCPEndpoint;
@@ -888,11 +905,10 @@ export declare class SingleAgentClient {
      * @returns true if signature is valid
      */
     verifyWebhookSignature(rawBodyOrPayload: string | Buffer | Uint8Array | unknown, signature: WebhookHeaderValue, timestamp: WebhookHeaderValue): boolean;
-    /**
-     * Execute task and call appropriate handler on completion
-     *
-     * Adapts requests for maintained AdCP 3 releases and normalizes product responses.
-     */
+    /** One task owns discovery and dispatch sessions unless the caller already owns reuse. */
+    private withConnectionScope;
+    private withTaskConnectionScope;
+    /** Execute a task, adapt maintained AdCP 3 releases, and call the completion handler. */
     private executeAndHandle;
     private executeAndHandleWithinDeadline;
     private finalizeTaskResult;
@@ -1187,6 +1203,9 @@ export declare class SingleAgentClient {
     getPlanAuditLogs(params: GetPlanAuditLogsRequest, options?: TaskOptions & {
         agent?: AgentConfig;
     }): Promise<TaskResult<GetPlanAuditLogsResponse>>;
+    getPlanAuditLogs(params: GetPlanAuditLogsRequest, inputHandler: InputHandler | undefined, options?: TaskOptions & {
+        agent?: AgentConfig;
+    }): Promise<TaskResult<GetPlanAuditLogsResponse>>;
     /**
      * Report a governance outcome for an async task that has resolved.
      *
@@ -1204,6 +1223,97 @@ export declare class SingleAgentClient {
         signal?: AbortSignal;
     }): Promise<import('./GovernanceTypes.mjs').GovernanceOutcome | undefined>;
     private getGovernanceAgent;
+    private advertisesTool;
+    /** Accept a committed proposal to create or amend a media buy, or apply a negotiated cancellation. */
+    acceptProposal(params: MutatingRequestInput<ToolTypes.AcceptProposalRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.AcceptProposalResponse>>;
+    /** Execute the AdCP acquire_rights tool. */
+    acquireRights(params: MutatingRequestInput<CoreTypes.AcquireRightsRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.AcquireRightsResponse>>;
+    /** Generate, transform, refine, retrieve, or adapt creative manifests for advertised creative capabilities. */
+    buildCreative(params: MutatingRequestInput<ToolTypes.BuildCreativeRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.BuildCreativeResponse>>;
+    /** Create a media buy directly from published seller products and record its accepted commercial snapshot. */
+    buyProducts(params: MutatingRequestInput<ToolTypes.BuyProductsRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.BuyProductsResponse>>;
+    /** Execute the AdCP calibrate_content tool. */
+    calibrateContent(params: MutatingRequestInput<ToolTypes.CalibrateContentRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.CalibrateContentResponse>>;
+    /** Execute the AdCP check_governance tool. */
+    checkGovernance(params: ToolTypes.CheckGovernanceRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.CheckGovernanceResponse>>;
+    /** Control a seller compliance scenario. Intended for conformance testing. */
+    complyTestController(params: ToolTypes.ComplyTestControllerRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ComplyTestControllerResponse>>;
+    /** Rename, pause, resume, cancel, or adjust delivery controls within accepted proposal change rights. */
+    controlMediaBuy(params: MutatingRequestInput<ToolTypes.ControlMediaBuyRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ControlMediaBuyResponse>>;
+    /** Execute the AdCP create_collection_list tool. */
+    createCollectionList(params: MutatingRequestInput<ToolTypes.CreateCollectionListRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.CreateCollectionListResponse>>;
+    /** Execute the AdCP create_content_standards tool. */
+    createContentStandards(params: MutatingRequestInput<ToolTypes.CreateContentStandardsRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.CreateContentStandardsResponse>>;
+    /** Terminally decline one or more proposals and record the buyer's reason. */
+    declineProposals(params: MutatingRequestInput<ToolTypes.DeclineProposalsRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.DeclineProposalsResponse>>;
+    /** Execute the AdCP delete_collection_list tool. */
+    deleteCollectionList(params: MutatingRequestInput<ToolTypes.DeleteCollectionListRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.DeleteCollectionListResponse>>;
+    /** Retrieve spend, credit or balance status, and invoice history for an operator-billed account. */
+    getAccountFinancials(params: ToolTypes.GetAccountFinancialsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.GetAccountFinancialsResponse>>;
+    /** Execute the AdCP get_brand_identity tool. */
+    getBrandIdentity(params: CoreTypes.GetBrandIdentityRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.GetBrandIdentityResponse>>;
+    /** Execute the AdCP get_collection_list tool. */
+    getCollectionList(params: ToolTypes.GetCollectionListRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.GetCollectionListResponse>>;
+    /** Execute the AdCP get_content_standards tool. */
+    getContentStandards(params: ToolTypes.GetContentStandardsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.GetContentStandardsResponse>>;
+    /** Evaluate a creative manifest and return scored safety, content, quality, and governance features. */
+    getCreativeFeatures(params: ToolTypes.GetCreativeFeaturesRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.GetCreativeFeaturesResponse>>;
+    /** Execute the AdCP get_media_buy_artifacts tool. */
+    getMediaBuyArtifacts(params: ToolTypes.GetMediaBuyArtifactsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.GetMediaBuyArtifactsResponse>>;
+    /** Check reporting health, enumerate expected periods and all retained revisions, or resolve one exact reporting revision. */
+    getReportingStatus(params: ToolTypes.GetReportingStatusRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.GetReportingStatusResponse>>;
+    /** Execute the AdCP get_rights tool. */
+    getRights(params: CoreTypes.GetRightsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.GetRightsResponse>>;
+    /** Execute the AdCP list_collection_lists tool. */
+    listCollectionLists(params: ToolTypes.ListCollectionListsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ListCollectionListsResponse>>;
+    /** Execute the AdCP list_content_standards tool. */
+    listContentStandards(params: ToolTypes.ListContentStandardsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ListContentStandardsResponse>>;
+    /** Execute the AdCP list_creative_formats tool. */
+    listCreativeFormats(params: ToolTypes.ListCreativeFormatsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ListCreativeFormatsResponse>>;
+    /** Discover account-scoped creative transformers and their selectable configuration options. */
+    listTransformers(params: ToolTypes.ListTransformersRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ListTransformersResponse>>;
+    /** Log batches of marketing events against a configured event source for measurement and attribution. */
+    logEvent(params: MutatingRequestInput<ToolTypes.LogEventRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.LogEventResponse>>;
+    /** Revise draft proposals, finalize them into committed, inventory-held snapshots, or extend a committed hold. */
+    refineProposals(params: TaskRequestFor<'refine_proposals'>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<TaskResponseTypeMap['refine_proposals']>>;
+    /** Execute the AdCP report_plan_adjustment tool. */
+    reportPlanAdjustment(params: MutatingRequestInput<ToolTypes.ReportPlanAdjustmentRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ReportPlanAdjustmentResponse>>;
+    /** Execute the AdCP report_plan_outcome tool. */
+    reportPlanOutcome(params: MutatingRequestInput<ToolTypes.ReportPlanOutcomeRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ReportPlanOutcomeResponse>>;
+    /** Report vendor-service consumption and final measurements for revenue tracking and billing reconciliation. */
+    reportUsage(params: MutatingRequestInput<ToolTypes.ReportUsageRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ReportUsageResponse>>;
+    /** Ask a seller to create one or more draft media-plan proposals from a campaign brief. */
+    requestProposals(params: MutatingRequestInput<ToolTypes.RequestProposalsRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.RequestProposalsResponse>>;
+    /** Execute the AdCP search_brands tool. */
+    searchBrands(params: CoreTypes.SearchBrandsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.SearchBrandsResponse>>;
+    /** Register, replace, pause, or clear caller-scoped webhooks for agent-level notifications. */
+    syncAgentNotificationConfigs(params: MutatingRequestInput<ToolTypes.SyncAgentNotificationConfigsRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.SyncAgentNotificationConfigsResponse>>;
+    /** List or synchronize buyer-managed account catalog feeds, suppress or restore specific items, and read current availability state. */
+    syncCatalogs(params: MutatingRequestInput<ToolTypes.SyncCatalogsRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.SyncCatalogsResponse>>;
+    /** List or synchronize account event sources with upsert and optional replacement semantics. */
+    syncEventSources(params: MutatingRequestInput<ToolTypes.SyncEventSourcesRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.SyncEventSourcesResponse>>;
+    /** Bind or replace the governance agent used for approval across specific advertiser accounts. */
+    syncGovernance(params: MutatingRequestInput<ToolTypes.SyncGovernanceRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.SyncGovernanceResponse>>;
+    /** Record a consumer's independently verified reporting totals and destination evidence in the seller ledger. */
+    syncReportingReceipts(params: MutatingRequestInput<ToolTypes.SyncReportingReceiptsRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.SyncReportingReceiptsResponse>>;
+    /** Tell a seller whether expected reporting was received, omitted, missing, unreadable, or contradictory. */
+    syncReportingStatus(params: MutatingRequestInput<ToolTypes.SyncReportingStatusRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.SyncReportingStatusResponse>>;
+    /** Execute the AdCP update_collection_list tool. */
+    updateCollectionList(params: MutatingRequestInput<ToolTypes.UpdateCollectionListRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.UpdateCollectionListResponse>>;
+    /** Execute the AdCP update_content_standards tool. */
+    updateContentStandards(params: MutatingRequestInput<ToolTypes.UpdateContentStandardsRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.UpdateContentStandardsResponse>>;
+    /** Execute the AdCP update_rights tool. */
+    updateRights(params: MutatingRequestInput<CoreTypes.UpdateRightsRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.UpdateRightsResponse>>;
+    /** Execute the AdCP validate_content_delivery tool. */
+    validateContentDelivery(params: ToolTypes.ValidateContentDeliveryRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ValidateContentDeliveryResponse>>;
+    /** Preflight a creative manifest against canonical formats, products, third-party formats, or agent capabilities. */
+    validateInput(params: ToolTypes.ValidateInputRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ValidateInputResponse>>;
+    /** Execute the AdCP validate_property_delivery tool. */
+    validatePropertyDelivery(params: CoreTypes.ValidatePropertyDeliveryRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.ValidatePropertyDeliveryResponse>>;
+    /** Execute the AdCP verify_brand_claim tool. */
+    verifyBrandClaim(params: CoreTypes.VerifyBrandClaimRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.VerifyBrandClaimResponse>>;
+    /** Execute the AdCP verify_brand_claims tool. */
+    verifyBrandClaims(params: CoreTypes.VerifyBrandClaimsRequestBulk, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.VerifyBrandClaimsResponseBulk>>;
     /**
      * Get AdCP capabilities
      *
@@ -1322,7 +1432,9 @@ export declare class SingleAgentClient {
      * );
      * ```
      */
-    executeTask<K extends AdcpTaskName>(taskName: K, params: TaskRequestFor<K>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<TaskResponseTypeMap[K]>>;
+    executeTask<K extends AdcpTaskName>(taskName: K, params: TaskRequestFor<K>, inputHandler?: InputHandler, options?: TaskOptions & {
+        agent?: K extends 'sync_plans' | 'get_plan_audit_logs' ? AgentConfig : never;
+    }): Promise<TaskResult<TaskResponseTypeMap[K]>>;
     /**
      * Execute an extension task that is not part of the standard AdCP task set.
      *
@@ -1483,6 +1595,9 @@ export declare class SingleAgentClient {
      * });
      * ```
      */
+    /** Query the seller's typed AdCP list_tasks tool. Pass {} for an unfiltered query. */
+    listTasks(params: ToolTypes.ListTasksRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ListTasksResponse>>;
+    /** List local tasks only. Pass {} to query the seller's list_tasks tool. */
     listTasks(): Promise<TaskInfo[]>;
     /**
      * Get detailed information about a specific task

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

@@ -1,3 +1,6 @@
+import type { MediaBuyDeliveryWebhookEnvelope } from '../webhooks/media-buy-delivery';
+import type * as ToolTypes from '../types/tools.generated';
+import type * as CoreTypes from '../types/core.generated';
 import { type ListProductsResponseWithSupplyPath, type ProductSupplyPathOptions } from '../supply-path/products';
 import type { AccountReference, AgentConfig } from '../types';
 import { type AdcpVersion } from '../version';
@@ -141,6 +144,8 @@ export interface WebhookVerificationConfig {
     fetchCapabilities?: (agentUrl: string, protocol: 'mcp' | 'a2a') => Promise<unknown>;
 }
 export interface VerifyAndParseWebhookOptions {
+    /** Trusted seller/buy release for registered reporting delivery validation; defaults to the client pin. */
+    adcpVersion?: string;
     /** Raw HTTP body bytes captured before JSON parsing. Required when `webhookSecret` is configured. */
     rawBody?: string | Buffer | Uint8Array;
     /** Parsed payload or raw body. When HMAC is configured, verified raw bytes are parsed instead of `payload`. */
@@ -189,7 +194,7 @@ export type WebhookParseResult = WebhookParseSuccess | WebhookParseFailure;
 export interface WebhookParseSuccess {
     ok: true;
     protocol: 'mcp' | 'a2a';
-    envelope: MCPWebhookPayload | A2ATask | TaskStatusUpdateEvent;
+    envelope: MCPWebhookPayload | MediaBuyDeliveryWebhookEnvelope | A2ATask | TaskStatusUpdateEvent;
     result: unknown;
     metadata: {
         taskId: string;
@@ -209,6 +214,8 @@ export interface WebhookParseFailure {
     ok: false;
     code: WebhookParseErrorCode;
     message: string;
+    /** Readable schema paths, when delivery payload validation fails. */
+    errors?: readonly string[];
     cause?: unknown;
 }
 export declare class WebhookDispatchError extends Error {
@@ -674,6 +681,13 @@ export declare class SingleAgentClient {
      * Local observation failures do not publish seller terminal lifecycle events.
      */
     trackTask<T = unknown>(request: TrackTaskRequest): Promise<TrackedTask<T>>;
+    /** Execute the typed AdCP get_task_status tool, including its result and error fields. */
+    getTaskStatus(params: ToolTypes.GetTaskStatusRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.GetTaskStatusResponse>>;
+    /** Poll one task and map its status to TaskInfo. Preserved for existing callers. */
+    getTaskStatus(taskId: string, transport?: import('../protocols').TransportOptions, signal?: AbortSignal, wireOptions?: {
+        wireAdcpVersion?: string;
+        versionEnvelope?: import('../protocols').VersionEnvelopeMode;
+    }): Promise<TaskInfo>;
     /** Recover the current generation of an opt-in direct mutation pause. */
     recoverDirectPauseContinuation<T>(request: DirectPauseRecoveryRequest): Promise<TaskResult<T>>;
     private recoverDurableSettlement;
@@ -726,6 +740,9 @@ export declare class SingleAgentClient {
      * - A validated MCP protected-resource metadata chain yields NeedsAuthorizationError
      * - Otherwise AuthenticationRequiredError carries the advertised challenge
      *
+     * Rate limiting (429, or 503 with Retry-After) stops probing at that URL and
+     * throws AgentRateLimitedError carrying the status and Retry-After.
+     *
      * Note: This is async and called lazily on first agent interaction
      */
     private discoverMCPEndpoint;
@@ -888,11 +905,10 @@ export declare class SingleAgentClient {
      * @returns true if signature is valid
      */
     verifyWebhookSignature(rawBodyOrPayload: string | Buffer | Uint8Array | unknown, signature: WebhookHeaderValue, timestamp: WebhookHeaderValue): boolean;
-    /**
-     * Execute task and call appropriate handler on completion
-     *
-     * Adapts requests for maintained AdCP 3 releases and normalizes product responses.
-     */
+    /** One task owns discovery and dispatch sessions unless the caller already owns reuse. */
+    private withConnectionScope;
+    private withTaskConnectionScope;
+    /** Execute a task, adapt maintained AdCP 3 releases, and call the completion handler. */
     private executeAndHandle;
     private executeAndHandleWithinDeadline;
     private finalizeTaskResult;
@@ -1187,6 +1203,9 @@ export declare class SingleAgentClient {
     getPlanAuditLogs(params: GetPlanAuditLogsRequest, options?: TaskOptions & {
         agent?: AgentConfig;
     }): Promise<TaskResult<GetPlanAuditLogsResponse>>;
+    getPlanAuditLogs(params: GetPlanAuditLogsRequest, inputHandler: InputHandler | undefined, options?: TaskOptions & {
+        agent?: AgentConfig;
+    }): Promise<TaskResult<GetPlanAuditLogsResponse>>;
     /**
      * Report a governance outcome for an async task that has resolved.
      *
@@ -1204,6 +1223,97 @@ export declare class SingleAgentClient {
         signal?: AbortSignal;
     }): Promise<import('./GovernanceTypes').GovernanceOutcome | undefined>;
     private getGovernanceAgent;
+    private advertisesTool;
+    /** Accept a committed proposal to create or amend a media buy, or apply a negotiated cancellation. */
+    acceptProposal(params: MutatingRequestInput<ToolTypes.AcceptProposalRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.AcceptProposalResponse>>;
+    /** Execute the AdCP acquire_rights tool. */
+    acquireRights(params: MutatingRequestInput<CoreTypes.AcquireRightsRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.AcquireRightsResponse>>;
+    /** Generate, transform, refine, retrieve, or adapt creative manifests for advertised creative capabilities. */
+    buildCreative(params: MutatingRequestInput<ToolTypes.BuildCreativeRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.BuildCreativeResponse>>;
+    /** Create a media buy directly from published seller products and record its accepted commercial snapshot. */
+    buyProducts(params: MutatingRequestInput<ToolTypes.BuyProductsRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.BuyProductsResponse>>;
+    /** Execute the AdCP calibrate_content tool. */
+    calibrateContent(params: MutatingRequestInput<ToolTypes.CalibrateContentRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.CalibrateContentResponse>>;
+    /** Execute the AdCP check_governance tool. */
+    checkGovernance(params: ToolTypes.CheckGovernanceRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.CheckGovernanceResponse>>;
+    /** Control a seller compliance scenario. Intended for conformance testing. */
+    complyTestController(params: ToolTypes.ComplyTestControllerRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ComplyTestControllerResponse>>;
+    /** Rename, pause, resume, cancel, or adjust delivery controls within accepted proposal change rights. */
+    controlMediaBuy(params: MutatingRequestInput<ToolTypes.ControlMediaBuyRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ControlMediaBuyResponse>>;
+    /** Execute the AdCP create_collection_list tool. */
+    createCollectionList(params: MutatingRequestInput<ToolTypes.CreateCollectionListRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.CreateCollectionListResponse>>;
+    /** Execute the AdCP create_content_standards tool. */
+    createContentStandards(params: MutatingRequestInput<ToolTypes.CreateContentStandardsRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.CreateContentStandardsResponse>>;
+    /** Terminally decline one or more proposals and record the buyer's reason. */
+    declineProposals(params: MutatingRequestInput<ToolTypes.DeclineProposalsRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.DeclineProposalsResponse>>;
+    /** Execute the AdCP delete_collection_list tool. */
+    deleteCollectionList(params: MutatingRequestInput<ToolTypes.DeleteCollectionListRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.DeleteCollectionListResponse>>;
+    /** Retrieve spend, credit or balance status, and invoice history for an operator-billed account. */
+    getAccountFinancials(params: ToolTypes.GetAccountFinancialsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.GetAccountFinancialsResponse>>;
+    /** Execute the AdCP get_brand_identity tool. */
+    getBrandIdentity(params: CoreTypes.GetBrandIdentityRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.GetBrandIdentityResponse>>;
+    /** Execute the AdCP get_collection_list tool. */
+    getCollectionList(params: ToolTypes.GetCollectionListRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.GetCollectionListResponse>>;
+    /** Execute the AdCP get_content_standards tool. */
+    getContentStandards(params: ToolTypes.GetContentStandardsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.GetContentStandardsResponse>>;
+    /** Evaluate a creative manifest and return scored safety, content, quality, and governance features. */
+    getCreativeFeatures(params: ToolTypes.GetCreativeFeaturesRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.GetCreativeFeaturesResponse>>;
+    /** Execute the AdCP get_media_buy_artifacts tool. */
+    getMediaBuyArtifacts(params: ToolTypes.GetMediaBuyArtifactsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.GetMediaBuyArtifactsResponse>>;
+    /** Check reporting health, enumerate expected periods and all retained revisions, or resolve one exact reporting revision. */
+    getReportingStatus(params: ToolTypes.GetReportingStatusRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.GetReportingStatusResponse>>;
+    /** Execute the AdCP get_rights tool. */
+    getRights(params: CoreTypes.GetRightsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.GetRightsResponse>>;
+    /** Execute the AdCP list_collection_lists tool. */
+    listCollectionLists(params: ToolTypes.ListCollectionListsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ListCollectionListsResponse>>;
+    /** Execute the AdCP list_content_standards tool. */
+    listContentStandards(params: ToolTypes.ListContentStandardsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ListContentStandardsResponse>>;
+    /** Execute the AdCP list_creative_formats tool. */
+    listCreativeFormats(params: ToolTypes.ListCreativeFormatsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ListCreativeFormatsResponse>>;
+    /** Discover account-scoped creative transformers and their selectable configuration options. */
+    listTransformers(params: ToolTypes.ListTransformersRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ListTransformersResponse>>;
+    /** Log batches of marketing events against a configured event source for measurement and attribution. */
+    logEvent(params: MutatingRequestInput<ToolTypes.LogEventRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.LogEventResponse>>;
+    /** Revise draft proposals, finalize them into committed, inventory-held snapshots, or extend a committed hold. */
+    refineProposals(params: TaskRequestFor<'refine_proposals'>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<TaskResponseTypeMap['refine_proposals']>>;
+    /** Execute the AdCP report_plan_adjustment tool. */
+    reportPlanAdjustment(params: MutatingRequestInput<ToolTypes.ReportPlanAdjustmentRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ReportPlanAdjustmentResponse>>;
+    /** Execute the AdCP report_plan_outcome tool. */
+    reportPlanOutcome(params: MutatingRequestInput<ToolTypes.ReportPlanOutcomeRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ReportPlanOutcomeResponse>>;
+    /** Report vendor-service consumption and final measurements for revenue tracking and billing reconciliation. */
+    reportUsage(params: MutatingRequestInput<ToolTypes.ReportUsageRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ReportUsageResponse>>;
+    /** Ask a seller to create one or more draft media-plan proposals from a campaign brief. */
+    requestProposals(params: MutatingRequestInput<ToolTypes.RequestProposalsRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.RequestProposalsResponse>>;
+    /** Execute the AdCP search_brands tool. */
+    searchBrands(params: CoreTypes.SearchBrandsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.SearchBrandsResponse>>;
+    /** Register, replace, pause, or clear caller-scoped webhooks for agent-level notifications. */
+    syncAgentNotificationConfigs(params: MutatingRequestInput<ToolTypes.SyncAgentNotificationConfigsRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.SyncAgentNotificationConfigsResponse>>;
+    /** List or synchronize buyer-managed account catalog feeds, suppress or restore specific items, and read current availability state. */
+    syncCatalogs(params: MutatingRequestInput<ToolTypes.SyncCatalogsRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.SyncCatalogsResponse>>;
+    /** List or synchronize account event sources with upsert and optional replacement semantics. */
+    syncEventSources(params: MutatingRequestInput<ToolTypes.SyncEventSourcesRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.SyncEventSourcesResponse>>;
+    /** Bind or replace the governance agent used for approval across specific advertiser accounts. */
+    syncGovernance(params: MutatingRequestInput<ToolTypes.SyncGovernanceRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.SyncGovernanceResponse>>;
+    /** Record a consumer's independently verified reporting totals and destination evidence in the seller ledger. */
+    syncReportingReceipts(params: MutatingRequestInput<ToolTypes.SyncReportingReceiptsRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.SyncReportingReceiptsResponse>>;
+    /** Tell a seller whether expected reporting was received, omitted, missing, unreadable, or contradictory. */
+    syncReportingStatus(params: MutatingRequestInput<ToolTypes.SyncReportingStatusRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.SyncReportingStatusResponse>>;
+    /** Execute the AdCP update_collection_list tool. */
+    updateCollectionList(params: MutatingRequestInput<ToolTypes.UpdateCollectionListRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.UpdateCollectionListResponse>>;
+    /** Execute the AdCP update_content_standards tool. */
+    updateContentStandards(params: MutatingRequestInput<ToolTypes.UpdateContentStandardsRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.UpdateContentStandardsResponse>>;
+    /** Execute the AdCP update_rights tool. */
+    updateRights(params: MutatingRequestInput<CoreTypes.UpdateRightsRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.UpdateRightsResponse>>;
+    /** Execute the AdCP validate_content_delivery tool. */
+    validateContentDelivery(params: ToolTypes.ValidateContentDeliveryRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ValidateContentDeliveryResponse>>;
+    /** Preflight a creative manifest against canonical formats, products, third-party formats, or agent capabilities. */
+    validateInput(params: ToolTypes.ValidateInputRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ValidateInputResponse>>;
+    /** Execute the AdCP validate_property_delivery tool. */
+    validatePropertyDelivery(params: CoreTypes.ValidatePropertyDeliveryRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.ValidatePropertyDeliveryResponse>>;
+    /** Execute the AdCP verify_brand_claim tool. */
+    verifyBrandClaim(params: CoreTypes.VerifyBrandClaimRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.VerifyBrandClaimResponse>>;
+    /** Execute the AdCP verify_brand_claims tool. */
+    verifyBrandClaims(params: CoreTypes.VerifyBrandClaimsRequestBulk, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.VerifyBrandClaimsResponseBulk>>;
     /**
      * Get AdCP capabilities
      *
@@ -1322,7 +1432,9 @@ export declare class SingleAgentClient {
      * );
      * ```
      */
-    executeTask<K extends AdcpTaskName>(taskName: K, params: TaskRequestFor<K>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<TaskResponseTypeMap[K]>>;
+    executeTask<K extends AdcpTaskName>(taskName: K, params: TaskRequestFor<K>, inputHandler?: InputHandler, options?: TaskOptions & {
+        agent?: K extends 'sync_plans' | 'get_plan_audit_logs' ? AgentConfig : never;
+    }): Promise<TaskResult<TaskResponseTypeMap[K]>>;
     /**
      * Execute an extension task that is not part of the standard AdCP task set.
      *
@@ -1483,6 +1595,9 @@ export declare class SingleAgentClient {
      * });
      * ```
      */
+    /** Query the seller's typed AdCP list_tasks tool. Pass {} for an unfiltered query. */
+    listTasks(params: ToolTypes.ListTasksRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ListTasksResponse>>;
+    /** List local tasks only. Pass {} to query the seller's list_tasks tool. */
     listTasks(): Promise<TaskInfo[]>;
     /**
      * Get detailed information about a specific task