@adcp/sdk 16.5.0 → 16.6.1

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

@@ -1,3 +1,5 @@
+import type * as ToolTypes from '../types/tools.generated';
+import type * as CoreTypes from '../types/core.generated';
 import type { Client as MCPClient } from '@modelcontextprotocol/sdk/client/index.js';
 import type { AccountReference, AgentConfig } from '../types';
 import type { ResolveAccountOptions, ResolveAccountResult } from './account-resolution';
@@ -92,6 +94,40 @@ export type TaskResponseTypeMap = {
     sync_agent_notification_configs: SyncAgentNotificationConfigsResponse;
     get_principal: GetPrincipalResponse;
     sync_principal: SyncPrincipalResponse;
+    acquire_rights: CoreTypes.AcquireRightsResponse;
+    build_creative: ToolTypes.BuildCreativeResponse;
+    calibrate_content: ToolTypes.CalibrateContentResponse;
+    comply_test_controller: ToolTypes.ComplyTestControllerResponse;
+    create_collection_list: ToolTypes.CreateCollectionListResponse;
+    create_content_standards: ToolTypes.CreateContentStandardsResponse;
+    delete_collection_list: ToolTypes.DeleteCollectionListResponse;
+    get_account_financials: ToolTypes.GetAccountFinancialsResponse;
+    get_collection_list: ToolTypes.GetCollectionListResponse;
+    get_content_standards: ToolTypes.GetContentStandardsResponse;
+    get_creative_features: ToolTypes.GetCreativeFeaturesResponse;
+    get_media_buy_artifacts: ToolTypes.GetMediaBuyArtifactsResponse;
+    get_rights: CoreTypes.GetRightsResponse;
+    get_task_status: ToolTypes.GetTaskStatusResponse;
+    list_collection_lists: ToolTypes.ListCollectionListsResponse;
+    list_content_standards: ToolTypes.ListContentStandardsResponse;
+    list_creative_formats: ToolTypes.ListCreativeFormatsResponse;
+    list_tasks: ToolTypes.ListTasksResponse;
+    list_transformers: ToolTypes.ListTransformersResponse;
+    log_event: ToolTypes.LogEventResponse;
+    preview_creative: CanonicalPreviewCreativeResponse;
+    report_usage: ToolTypes.ReportUsageResponse;
+    search_brands: CoreTypes.SearchBrandsResponse;
+    sync_catalogs: ToolTypes.SyncCatalogsResponse;
+    sync_event_sources: ToolTypes.SyncEventSourcesResponse;
+    sync_governance: ToolTypes.SyncGovernanceResponse;
+    update_collection_list: ToolTypes.UpdateCollectionListResponse;
+    update_content_standards: ToolTypes.UpdateContentStandardsResponse;
+    update_rights: CoreTypes.UpdateRightsResponse;
+    validate_content_delivery: ToolTypes.ValidateContentDeliveryResponse;
+    validate_input: ToolTypes.ValidateInputResponse;
+    validate_property_delivery: CoreTypes.ValidatePropertyDeliveryResponse;
+    verify_brand_claim: CoreTypes.VerifyBrandClaimResponse;
+    verify_brand_claims: CoreTypes.VerifyBrandClaimsResponseBulk;
 };
 /**
  * Valid ADCP task names
@@ -145,6 +181,40 @@ export type TaskRequestTypeMap = {
     sync_agent_notification_configs: MutatingRequestInput<SyncAgentNotificationConfigsRequest>;
     get_principal: GetPrincipalRequest;
     sync_principal: MutatingRequestInput<SyncPrincipalRequest>;
+    acquire_rights: MutatingRequestInput<CoreTypes.AcquireRightsRequest>;
+    build_creative: MutatingRequestInput<ToolTypes.BuildCreativeRequest>;
+    calibrate_content: MutatingRequestInput<ToolTypes.CalibrateContentRequest>;
+    comply_test_controller: ToolTypes.ComplyTestControllerRequest;
+    create_collection_list: MutatingRequestInput<ToolTypes.CreateCollectionListRequest>;
+    create_content_standards: MutatingRequestInput<ToolTypes.CreateContentStandardsRequest>;
+    delete_collection_list: MutatingRequestInput<ToolTypes.DeleteCollectionListRequest>;
+    get_account_financials: ToolTypes.GetAccountFinancialsRequest;
+    get_collection_list: ToolTypes.GetCollectionListRequest;
+    get_content_standards: ToolTypes.GetContentStandardsRequest;
+    get_creative_features: ToolTypes.GetCreativeFeaturesRequest;
+    get_media_buy_artifacts: ToolTypes.GetMediaBuyArtifactsRequest;
+    get_rights: CoreTypes.GetRightsRequest;
+    get_task_status: ToolTypes.GetTaskStatusRequest;
+    list_collection_lists: ToolTypes.ListCollectionListsRequest;
+    list_content_standards: ToolTypes.ListContentStandardsRequest;
+    list_creative_formats: ToolTypes.ListCreativeFormatsRequest;
+    list_tasks: ToolTypes.ListTasksRequest;
+    list_transformers: ToolTypes.ListTransformersRequest;
+    log_event: MutatingRequestInput<ToolTypes.LogEventRequest>;
+    preview_creative: CanonicalPreviewCreativeRequest;
+    report_usage: MutatingRequestInput<ToolTypes.ReportUsageRequest>;
+    search_brands: CoreTypes.SearchBrandsRequest;
+    sync_catalogs: MutatingRequestInput<ToolTypes.SyncCatalogsRequest>;
+    sync_event_sources: MutatingRequestInput<ToolTypes.SyncEventSourcesRequest>;
+    sync_governance: MutatingRequestInput<ToolTypes.SyncGovernanceRequest>;
+    update_collection_list: MutatingRequestInput<ToolTypes.UpdateCollectionListRequest>;
+    update_content_standards: MutatingRequestInput<ToolTypes.UpdateContentStandardsRequest>;
+    update_rights: MutatingRequestInput<CoreTypes.UpdateRightsRequest>;
+    validate_content_delivery: ToolTypes.ValidateContentDeliveryRequest;
+    validate_input: ToolTypes.ValidateInputRequest;
+    validate_property_delivery: CoreTypes.ValidatePropertyDeliveryRequest;
+    verify_brand_claim: CoreTypes.VerifyBrandClaimRequest;
+    verify_brand_claims: CoreTypes.VerifyBrandClaimsRequestBulk;
 };
 export type TaskRequestFor<K extends AdcpTaskName> = TaskRequestTypeMap[K];
 /**
@@ -208,6 +278,13 @@ export declare class AgentClient {
      * rejected rather than silently falling back to redundant discovery.
      */
     static createWithCapabilityPreflight(agent: AgentConfig, loadEvidence: CapabilityPreflightLoader, config?: SingleAgentClientConfig): Promise<AgentClient>;
+    /** Execute the typed AdCP get_task_status tool. */
+    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 A2A pause generation for a direct mutation that opted
      * into `TaskOptions.durableContinuationRecovery`.
@@ -598,6 +675,88 @@ export declare class AgentClient {
      * Sync audiences
      */
     syncAudiences(params: MutatingRequestInput<SyncAudiencesRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<SyncAudiencesResponse>>;
+    /** 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>>;
+    /** 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>>;
+    /** 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>>;
+    /** 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>>;
+    /** Execute the AdCP get_plan_audit_logs tool. */
+    getPlanAuditLogs(params: ToolTypes.GetPlanAuditLogsRequest, inputHandler?: InputHandler, options?: TaskOptions & {
+        agent?: AgentConfig;
+    }): Promise<TaskResult<ToolTypes.GetPlanAuditLogsResponse>>;
+    /** 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>>;
+    /** 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>>;
+    /** Execute the AdCP search_brands tool. */
+    searchBrands(params: CoreTypes.SearchBrandsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.SearchBrandsResponse>>;
+    /** 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>>;
+    /** Execute the AdCP sync_plans tool. */
+    syncPlans(params: MutatingRequestInput<ToolTypes.SyncPlansRequest>, inputHandler?: InputHandler, options?: TaskOptions & {
+        agent?: AgentConfig;
+    }): Promise<TaskResult<ToolTypes.SyncPlansResponse>>;
+    /** 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>>;
     /**
      * Create a property list
      */
@@ -814,7 +973,9 @@ export declare class AgentClient {
      * const customResult = await agent.executeCustomTask<MyCustomResponse>('custom_task', params);
      * ```
      */
-    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. */
     executeCustomTask<T = unknown>(taskName: string, params: Record<string, unknown>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<T>>;
     /**
@@ -825,6 +986,9 @@ export declare class AgentClient {
     /**
      * List all tasks for this agent
      */
+    /** 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