@adcp/sdk 12.1.0 → 13.0.0-rc.0

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

@@ -1,16 +1,36 @@
 import type { AgentConfig } from '../types/index.mjs';
 import { type AdcpVersion } from '../version.mjs';
-import type { GetProductsRequest, GetProductsResponse, ListCreativeFormatsRequest, ListCreativeFormatsResponse, CreateMediaBuyRequest, UpdateMediaBuyRequest, UpdateMediaBuyResponse, SyncCreativesRequest, SyncCreativesResponse, ListCreativesRequest, ListCreativesResponse, GetMediaBuysRequest, GetMediaBuysResponse, GetMediaBuyDeliveryRequest, GetMediaBuyDeliveryResponse, ProvidePerformanceFeedbackRequest, ProvidePerformanceFeedbackResponse, GetSignalsRequest, GetSignalsResponse, ActivateSignalRequest, ActivateSignalResponse, PreviewCreativeRequest, PreviewCreativeResponse, BuildCreativeRequest, BuildCreativeResponse, Format, GetAdCPCapabilitiesRequest, GetAdCPCapabilitiesResponse, ListAccountsRequest, ListAccountsResponse, SyncAccountsRequest, SyncAccountsResponse, SyncAudiencesRequest, SyncAudiencesResponse, CreatePropertyListRequest, CreatePropertyListResponse, GetPropertyListRequest, GetPropertyListResponse, UpdatePropertyListRequest, UpdatePropertyListResponse, ListPropertyListsRequest, ListPropertyListsResponse, DeletePropertyListRequest, DeletePropertyListResponse, ListContentStandardsRequest, ListContentStandardsResponse, GetContentStandardsRequest, GetContentStandardsResponse, CalibrateContentRequest, CalibrateContentResponse, ValidateContentDeliveryRequest, ValidateContentDeliveryResponse, SIGetOfferingRequest, SIGetOfferingResponse, SIInitiateSessionRequest, SIInitiateSessionResponse, SISendMessageRequest, SISendMessageResponse, SITerminateSessionRequest, SITerminateSessionResponse, SyncPlansRequest, SyncPlansResponse, GetPlanAuditLogsRequest, GetPlanAuditLogsResponse, OutcomeType } from '../types/tools.generated.mjs';
+import type { GetProductsRequest, GetProductsResponse, ListCreativeFormatsRequest, ListCreativeFormatsResponse, ListTransformersRequest, ListTransformersResponse, CreateMediaBuyRequest, UpdateMediaBuyRequest, UpdateMediaBuyResponse, SyncCreativesRequest, SyncCreativesResponse, ListCreativesRequest, ListCreativesResponse, GetMediaBuysRequest, GetMediaBuysResponse, GetMediaBuyDeliveryRequest, GetMediaBuyDeliveryResponse, GetCreativeDeliveryRequest, GetCreativeDeliveryResponse, ProvidePerformanceFeedbackRequest, ProvidePerformanceFeedbackResponse, GetSignalsRequest, GetSignalsResponse, ActivateSignalRequest, ActivateSignalResponse, PreviewCreativeRequest, PreviewCreativeResponse, BuildCreativeRequest, BuildCreativeResponse, Format, GetAdCPCapabilitiesRequest, GetAdCPCapabilitiesResponse, ListAccountsRequest, ListAccountsResponse, SyncAccountsRequest, SyncAccountsResponse, SyncAudiencesRequest, SyncAudiencesResponse, CreatePropertyListRequest, CreatePropertyListResponse, GetPropertyListRequest, GetPropertyListResponse, UpdatePropertyListRequest, UpdatePropertyListResponse, ListPropertyListsRequest, ListPropertyListsResponse, DeletePropertyListRequest, DeletePropertyListResponse, ListContentStandardsRequest, ListContentStandardsResponse, GetContentStandardsRequest, GetContentStandardsResponse, CalibrateContentRequest, CalibrateContentResponse, ValidateContentDeliveryRequest, ValidateContentDeliveryResponse, SIGetOfferingRequest, SIGetOfferingResponse, SIInitiateSessionRequest, SIInitiateSessionResponse, SISendMessageRequest, SISendMessageResponse, SITerminateSessionRequest, SITerminateSessionResponse, SyncPlansRequest, SyncPlansResponse, GetPlanAuditLogsRequest, GetPlanAuditLogsResponse, OutcomeType } from '../types/tools.generated.mjs';
 import { type MutatingRequestInput } from '../utils/idempotency.mjs';
 import type { MCPWebhookPayload, TaskStatus, CreateMediaBuyResponse } from '../types/core.generated.mjs';
 import type { Task as A2ATask, TaskStatusUpdateEvent } from '@a2a-js/sdk';
-import type { InputHandler, TaskOptions, TaskResult, ConversationConfig, TaskInfo, WebhookUrlTemplate } from './ConversationTypes.mjs';
+import type { InputHandler, Message, TaskOptions, TaskResult, ConversationConfig, TaskInfo, TaskState, WebhookUrlTemplate } from './ConversationTypes.mjs';
+import type { AdcpTaskName, TaskRequestFor, TaskResponseTypeMap } from './AgentClient.mjs';
 import type { Activity, AsyncHandlerConfig } from './AsyncHandler.mjs';
 import { type WebhookHeaderValue, type WebhookHeadersLike } from '../webhooks/index.mjs';
 import type { AdcpCapabilities, FeatureName } from '../utils/capabilities.mjs';
 import { type BuyerPropertyPolicy, type ProductPropertyPolicyMode } from '../media-buy/property-policy.mjs';
 import { type ResolveListOptions } from '../server/targeting-helpers.mjs';
+import { type CanonicalCreateMediaBuyRequest, type CanonicalCreativeResponse, type CanonicalGetProductsRequest, type CanonicalGetProductsResponse, type CanonicalListCreativesRequest, type CanonicalListCreativesResponse, type CanonicalSyncCreativesRequest, type CanonicalUpdateMediaBuyRequest, type SyncCreativeFormatProjection } from '../v2/projection/creative-delivery.mjs';
+import type { LegacyFormatConverter } from '../v2/projection/v1-to-v2.mjs';
+import { type ProjectionCatalogSnapshot } from '../v2/projection/catalog-snapshot.mjs';
+import type { CanonicalFormatLegacyResolver } from '../v2/projection/v2-to-v1.mjs';
 type ReadRequestOptions = Pick<TaskOptions, 'signal' | 'transport'>;
+export type CreativeDeliveryTaskOptions = TaskOptions & {
+    legacyFormatConverter?: LegacyFormatConverter;
+    /** Pre-resolved exact-owner publisher/community catalogs, highest precedence first. */
+    projectionCatalogs?: readonly ProjectionCatalogSnapshot[];
+    /** Resolver for persisted canonical selections that need a seller-specific legacy wire identity. */
+    canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver;
+};
+export type CanonicalReadTaskOptions = TaskOptions & {
+    legacyFormatConverter?: LegacyFormatConverter;
+    /** Pre-resolved exact-owner publisher/community catalogs, highest precedence first. */
+    projectionCatalogs?: readonly ProjectionCatalogSnapshot[];
+};
+export type SyncCreativesTaskOptions = CreativeDeliveryTaskOptions & {
+    creativeFormatProjection?: SyncCreativeFormatProjection;
+};
 /**
  * Error class for v3 feature compatibility issues
  *
@@ -111,6 +131,12 @@ export declare class WebhookDispatchError extends Error {
  * Configuration for SingleAgentClient (and multi-agent client)
  */
 export interface SingleAgentClientConfig extends ConversationConfig {
+    /** Converter for seller-specific legacy creative formats at canonical read, write, and webhook boundaries. */
+    legacyFormatConverter?: LegacyFormatConverter;
+    /** Pre-resolved exact-owner publisher/community catalogs used at every projection boundary. */
+    projectionCatalogs?: readonly ProjectionCatalogSnapshot[];
+    /** Resolver for persisted canonical selections when a negotiated legacy wire is required. */
+    canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver;
     /**
      * AdCP protocol version this client speaks to agents. Defaults to
      * {@link ADCP_VERSION} — the GA version the SDK ships against. Override
@@ -341,8 +367,25 @@ export declare class SingleAgentClient {
     private _syntheticV3WarningFired;
     private _syntheticV2WarningFired;
     private readonly productPolicyRequestParamsByTask;
+    private readonly canonicalCreativeTaskAssociations;
+    private readonly canonicalLegacyRoutes;
     private readonly resolvedAdcpVersion;
     constructor(agent: AgentConfig, config?: SingleAgentClientConfig);
+    private resolveLegacyFormatConverter;
+    private canonicalAccountScope;
+    private canonicalLegacyRouteKey;
+    private canonicalLegacyPackageRouteKey;
+    private sameCanonicalOptionRef;
+    private rememberCanonicalLegacyRoute;
+    private invalidateCanonicalProductRoutes;
+    private rememberCanonicalProductRoutes;
+    private routeForOption;
+    private routeForPackage;
+    private packageIdsFromSelector;
+    private cachedCanonicalLegacyRefs;
+    private rememberCanonicalPackageRoutes;
+    private rememberCanonicalPackageRoutesForTask;
+    private resolveCanonicalFormatLegacyResolver;
     /**
      * Returns the AdCP protocol version this client is configured to speak.
      *
@@ -465,11 +508,14 @@ export declare class SingleAgentClient {
      * This is the lower-level receiver primitive for integrations that need to
      * map malformed webhooks to precise HTTP responses. It verifies the legacy
      * HMAC profile when `webhookSecret` is configured, parses raw JSON bodies,
-     * validates the transport envelope shape, and returns the unwrapped AdCP
-     * result plus routing metadata.
+     * validates the transport envelope shape, and returns the canonicalized
+     * AdCP result plus routing metadata. Legacy wire inspection is intentionally
+     * confined to the transport adapter and is not returned by this primary API.
      */
     verifyAndParseWebhook(options: VerifyAndParseWebhookOptions): Promise<WebhookParseResult>;
     private dispatchParsedWebhook;
+    private rememberCanonicalCreativeWebhookContext;
+    private canonicalizeWebhookCreativeResult;
     /**
      * Normalize webhook payload - handles both MCP and A2A webhook formats
      *
@@ -573,6 +619,15 @@ export declare class SingleAgentClient {
      * Automatically adapts requests for v2 servers and normalizes responses.
      */
     private executeAndHandle;
+    private canonicalCreativeInputHandler;
+    private projectCanonicalCreativeData;
+    private canonicalizeCreativeTaskResult;
+    private canonicalizeCreativeTaskInfo;
+    private wrapCanonicalCreativeContinuations;
+    private rememberCanonicalCreativeTaskIds;
+    private rememberCanonicalCreativeTaskAssociation;
+    private canonicalCreativeTaskAssociation;
+    private forgetCanonicalCreativeTaskAssociationKeys;
     /**
      * Drop products that arrive without a usable `pricing_options[]` array from a
      * completed `get_products` response. `pricing_options` is required and
@@ -587,11 +642,15 @@ export declare class SingleAgentClient {
     private enforceProductPricingOptions;
     private applyProductPropertyPolicy;
     private rememberProductPolicyRequestParams;
+    private rememberProductPolicyRequestState;
+    private rememberLegacyFormatConverter;
+    private legacyFormatConverterForWebhook;
     private forgetProductPolicyRequestParams;
     private forgetProductPolicyRequestParamKeys;
     private wrapProductPolicySubmittedContinuation;
     private applyProductPropertyPolicyToTaskInfo;
     private productPolicyRequestParamsForWebhook;
+    private productPolicyRequestParamsForKey;
     private applyProductPropertyPolicyToWebhookResult;
     /**
      * Adapt a request for the detected server wire version and the seller's
@@ -600,8 +659,8 @@ export declare class SingleAgentClient {
      * 3.1-only fields for a 3.0 seller). Returns the adapted params and any
      * drift log entries describing what was changed.
      *
-     * Runs after `detectServerVersion` so `cachedCapabilities` is populated
-     * and the protocol-version adapters see the seller's declared caps.
+     * Runs after `detectServerVersion` so capabilities are available and the
+     * current call's tool schemas can be supplied without cross-tenant caching.
      */
     private adaptRequest;
     /**
@@ -641,15 +700,20 @@ export declare class SingleAgentClient {
      * );
      * ```
      */
-    getProducts(params: GetProductsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<GetProductsResponse>>;
+    getProducts(params: CanonicalGetProductsRequest, inputHandler?: InputHandler, options?: CanonicalReadTaskOptions): Promise<TaskResult<CanonicalGetProductsResponse>>;
+    /** @deprecated Explicit raw-wire escape hatch for migration tooling. */
+    getProductsLegacy(params: GetProductsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<GetProductsResponse>>;
     /**
-     * List available creative formats
+     * List a legacy named-format catalog for migration tooling.
      *
      * @param params - Format listing parameters
      * @param inputHandler - Handler for clarification requests
      * @param options - Task execution options
+     * @deprecated Canonical applications discover `format_options[]` through `getProducts()`.
      */
-    listCreativeFormats(params: ListCreativeFormatsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ListCreativeFormatsResponse>>;
+    listCreativeFormatsLegacy(params: ListCreativeFormatsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ListCreativeFormatsResponse>>;
+    /** @deprecated Migration-only access to legacy creative transformer declarations. */
+    listTransformersLegacy(params: ListTransformersRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ListTransformersResponse>>;
     /**
      * Create a new media buy
      *
@@ -657,7 +721,9 @@ export declare class SingleAgentClient {
      * @param inputHandler - Handler for clarification requests
      * @param options - Task execution options
      */
-    createMediaBuy(params: MutatingRequestInput<CreateMediaBuyRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CreateMediaBuyResponse>>;
+    createMediaBuy(params: MutatingRequestInput<CanonicalCreateMediaBuyRequest>, inputHandler?: InputHandler, options?: CreativeDeliveryTaskOptions): Promise<TaskResult<CanonicalCreativeResponse<CreateMediaBuyResponse>>>;
+    /** @deprecated Compatibility-only entry point for callers still holding legacy creative `format_id` values. */
+    createMediaBuyLegacy(params: MutatingRequestInput<CreateMediaBuyRequest>, inputHandler?: InputHandler, options?: CreativeDeliveryTaskOptions): Promise<TaskResult<CreateMediaBuyResponse>>;
     /**
      * Update an existing media buy
      *
@@ -665,7 +731,9 @@ export declare class SingleAgentClient {
      * @param inputHandler - Handler for clarification requests
      * @param options - Task execution options
      */
-    updateMediaBuy(params: MutatingRequestInput<UpdateMediaBuyRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<UpdateMediaBuyResponse>>;
+    updateMediaBuy(params: MutatingRequestInput<CanonicalUpdateMediaBuyRequest>, inputHandler?: InputHandler, options?: CreativeDeliveryTaskOptions): Promise<TaskResult<CanonicalCreativeResponse<UpdateMediaBuyResponse>>>;
+    /** @deprecated Compatibility-only entry point for callers still holding legacy creative `format_id` values. */
+    updateMediaBuyLegacy(params: MutatingRequestInput<UpdateMediaBuyRequest>, inputHandler?: InputHandler, options?: CreativeDeliveryTaskOptions): Promise<TaskResult<UpdateMediaBuyResponse>>;
     /**
      * Sync creative assets
      *
@@ -673,23 +741,35 @@ export declare class SingleAgentClient {
      * @param inputHandler - Handler for clarification requests
      * @param options - Task execution options
      */
-    syncCreatives(params: MutatingRequestInput<SyncCreativesRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<SyncCreativesResponse>>;
+    syncCreatives(params: MutatingRequestInput<CanonicalSyncCreativesRequest>, inputHandler?: InputHandler, options?: SyncCreativesTaskOptions): Promise<TaskResult<CanonicalCreativeResponse<SyncCreativesResponse>>>;
+    /** @deprecated Compatibility-only entry point for callers still holding legacy creative `format_id` values. */
+    syncCreativesLegacy(params: MutatingRequestInput<SyncCreativesRequest>, inputHandler?: InputHandler, options?: SyncCreativesTaskOptions): Promise<TaskResult<SyncCreativesResponse>>;
+    private resolveCreativeFormatWireMode;
+    /** Validate malformed creative payloads before capability discovery can perform I/O. */
+    private validateBeforeCreativeCapabilityProbe;
     /**
-     * List creative assets
+     * List creatives through the canonical SDK boundary.
+     *
+     * Legacy format filters are rejected and returned creative identities are
+     * projected to `format_kind` / `format_option_ref`. Migration tooling that
+     * needs the negotiated raw wire shape must call `listCreativesLegacy()`.
      *
      * @param params - Creative listing parameters
      * @param inputHandler - Handler for clarification requests
      * @param options - Task execution options
      */
-    listCreatives(params: ListCreativesRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ListCreativesResponse>>;
+    listCreatives(params: CanonicalListCreativesRequest, inputHandler?: InputHandler, options?: CanonicalReadTaskOptions): Promise<TaskResult<CanonicalListCreativesResponse>>;
+    /** @deprecated Explicit raw-wire escape hatch for migration tooling. */
+    listCreativesLegacy(params: ListCreativesRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ListCreativesResponse>>;
     /**
-     * Preview a creative
+     * Preview a creative through the legacy named-format protocol.
      *
      * @param params - Preview creative parameters
      * @param inputHandler - Handler for clarification requests
      * @param options - Task execution options
+     * @deprecated Migration-only access to `format_id`-based creative preview.
      */
-    previewCreative(params: PreviewCreativeRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<PreviewCreativeResponse>>;
+    previewCreativeLegacy(params: PreviewCreativeRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<PreviewCreativeResponse>>;
     /**
      * Get media buy status, creative approvals, and optional delivery snapshots
      *
@@ -697,7 +777,7 @@ export declare class SingleAgentClient {
      * @param inputHandler - Handler for clarification requests
      * @param options - Task execution options
      */
-    getMediaBuys(params: GetMediaBuysRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<GetMediaBuysResponse>>;
+    getMediaBuys(params: GetMediaBuysRequest, inputHandler?: InputHandler, options?: CanonicalReadTaskOptions): Promise<TaskResult<CanonicalCreativeResponse<GetMediaBuysResponse>>>;
     /**
      * Get media buy delivery information
      *
@@ -705,7 +785,9 @@ export declare class SingleAgentClient {
      * @param inputHandler - Handler for clarification requests
      * @param options - Task execution options
      */
-    getMediaBuyDelivery(params: GetMediaBuyDeliveryRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<GetMediaBuyDeliveryResponse>>;
+    getMediaBuyDelivery(params: GetMediaBuyDeliveryRequest, inputHandler?: InputHandler, options?: CanonicalReadTaskOptions): Promise<TaskResult<CanonicalCreativeResponse<GetMediaBuyDeliveryResponse>>>;
+    /** Retrieve canonical creative-level and variant-level delivery metrics. */
+    getCreativeDelivery(params: GetCreativeDeliveryRequest, inputHandler?: InputHandler, options?: CanonicalReadTaskOptions): Promise<TaskResult<CanonicalCreativeResponse<GetCreativeDeliveryResponse>>>;
     /**
      * Provide performance feedback
      *
@@ -771,9 +853,10 @@ export declare class SingleAgentClient {
      */
     getAdcpCapabilities(params: GetAdCPCapabilitiesRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<GetAdCPCapabilitiesResponse>>;
     /**
-     * Build a creative from a format and brand context
+     * Build a creative through the legacy named-format protocol.
+     * @deprecated Migration-only access to `target_format_id`-based creative building.
      */
-    buildCreative(params: MutatingRequestInput<BuildCreativeRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<BuildCreativeResponse>>;
+    buildCreativeLegacy(params: MutatingRequestInput<BuildCreativeRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<BuildCreativeResponse>>;
     /**
      * List accounts
      */
@@ -809,19 +892,19 @@ export declare class SingleAgentClient {
     /**
      * List content standards
      */
-    listContentStandards(params: ListContentStandardsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ListContentStandardsResponse>>;
+    listContentStandardsLegacy(params: ListContentStandardsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ListContentStandardsResponse>>;
     /**
      * Get content standards
      */
-    getContentStandards(params: GetContentStandardsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<GetContentStandardsResponse>>;
+    getContentStandardsLegacy(params: GetContentStandardsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<GetContentStandardsResponse>>;
     /**
      * Calibrate content against standards
      */
-    calibrateContent(params: MutatingRequestInput<CalibrateContentRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CalibrateContentResponse>>;
+    calibrateContentLegacy(params: MutatingRequestInput<CalibrateContentRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CalibrateContentResponse>>;
     /**
      * Validate content delivery
      */
-    validateContentDelivery(params: ValidateContentDeliveryRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ValidateContentDeliveryResponse>>;
+    validateContentDeliveryLegacy(params: ValidateContentDeliveryRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ValidateContentDeliveryResponse>>;
     /**
      * Get an SI offering
      */
@@ -855,7 +938,21 @@ export declare class SingleAgentClient {
      * );
      * ```
      */
-    executeTask<T = any>(taskName: string, params: any, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<T>>;
+    executeTask<K extends AdcpTaskName>(taskName: K, params: TaskRequestFor<K>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<TaskResponseTypeMap[K]>>;
+    /**
+     * Execute an extension task that is not part of the standard AdCP task set.
+     *
+     * Keeping custom tasks on an explicitly named API prevents a response-type
+     * generic from weakening the canonical request types enforced by
+     * `executeTask()` for standard creative-boundary tasks.
+     */
+    executeCustomTask<T = unknown>(taskName: string, params: Record<string, unknown>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<T>>;
+    /**
+     * Explicit raw-task compatibility escape hatch for conformance and migration tooling.
+     * @deprecated Application code should use typed primary methods or `executeTask()`.
+     */
+    executeTaskLegacy<T = any>(taskName: string, params: any, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<T>>;
+    private executeTaskUnprojected;
     /**
      * Resume a deferred task using its token
      *
@@ -902,7 +999,7 @@ export declare class SingleAgentClient {
     /**
      * Get conversation history for a task
      */
-    getConversationHistory(taskId: string): import("./ConversationTypes.mjs").Message[] | undefined;
+    getConversationHistory(taskId: string): Message[] | undefined;
     /**
      * Clear conversation history for a task
      */
@@ -992,7 +1089,7 @@ export declare class SingleAgentClient {
     /**
      * Get active tasks for this agent
      */
-    getActiveTasks(): import("./ConversationTypes.mjs").TaskState[];
+    getActiveTasks(): TaskState[];
     /**
      * List all tasks for this agent with detailed information
      *
@@ -1299,38 +1396,18 @@ export declare class SingleAgentClient {
     requireV3(taskType?: string): Promise<void>;
     private isV2Allowed;
     /**
-     * Query a creative agent to discover available creative formats
+     * Query a legacy creative-agent named-format catalog.
      *
-     * This is a static utility method that allows you to query any creative agent
-     * (like creative.adcontextprotocol.org) to discover what formats are available
-     * before creating a media buy.
+     * Canonical applications discover seller-supported declarations through
+     * `AgentClient.getProducts()` and consume `format_options[]` instead.
      *
      * @param creativeAgentUrl - URL of the creative agent (e.g., 'https://creative.adcontextprotocol.org/mcp')
      * @param protocol - Protocol to use ('mcp' or 'a2a'), defaults to 'mcp'
      * @returns Promise resolving to the list of available formats
      *
-     * @example
-     * ```typescript
-     * // Discover formats from the standard creative agent
-     * const formats = await SingleAgentClient.discoverCreativeFormats(
-     *   'https://creative.adcontextprotocol.org/mcp'
-     * );
-     *
-     * // Find a specific format
-     * const banner = formats.find(f => f.format_id.id === 'display_300x250_image');
-     *
-     * // Use the format in a media buy
-     * await salesAgent.createMediaBuy({
-     *   packages: [{
-     *     format_ids: [{
-     *       agent_url: banner.format_id.agent_url,
-     *       id: banner.format_id.id
-     *     }]
-     *   }]
-     * });
-     * ```
+     * @deprecated Migration-only helper for the legacy named-format protocol.
      */
-    static discoverCreativeFormats(creativeAgentUrl: string, protocol?: 'mcp' | 'a2a'): Promise<Format[]>;
+    static discoverCreativeFormatsLegacy(creativeAgentUrl: string, protocol?: 'mcp' | 'a2a'): Promise<Format[]>;
     /**
      * Validate request parameters against AdCP schema.
      *