@adcp/sdk 17.0.0-beta.0 → 17.0.0-beta.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/lib/adapters/keyed-account-store.js +1 -1
- package/dist/lib/adapters/keyed-account-store.mjs +1 -1
- package/dist/lib/adapters/version/3.0/brand-fields.d.mts +7 -1
- package/dist/lib/adapters/version/3.0/brand-fields.d.ts +7 -1
- package/dist/lib/adapters/version/3.0/brand-fields.js +139 -3
- package/dist/lib/adapters/version/3.0/brand-fields.mjs +136 -2
- package/dist/lib/adapters/version/3.0/index.js +6 -0
- package/dist/lib/adapters/version/3.0/index.mjs +7 -1
- package/dist/lib/adapters/version/3.1/bidding.js +1 -1
- package/dist/lib/adapters/version/3.1/bidding.mjs +1 -1
- package/dist/lib/adapters/version/types.d.mts +5 -0
- package/dist/lib/adapters/version/types.d.ts +5 -0
- package/dist/lib/canonical-references/index.js +2 -0
- package/dist/lib/canonical-references/index.mjs +2 -0
- package/dist/lib/client/account-changes.d.mts +3 -1
- package/dist/lib/client/account-changes.d.ts +3 -1
- package/dist/lib/client/account-changes.js +22 -2
- package/dist/lib/client/account-changes.mjs +22 -2
- package/dist/lib/conformance/oracle.js +3 -2
- package/dist/lib/conformance/oracle.mjs +3 -2
- package/dist/lib/core/AgentClient.d.mts +165 -1
- package/dist/lib/core/AgentClient.d.ts +165 -1
- package/dist/lib/core/AgentClient.js +446 -8
- package/dist/lib/core/AgentClient.mjs +446 -8
- package/dist/lib/core/ConversationTypes.d.mts +8 -0
- package/dist/lib/core/ConversationTypes.d.ts +8 -0
- package/dist/lib/core/ProtocolResponseParser.d.mts +1 -1
- package/dist/lib/core/ProtocolResponseParser.d.ts +1 -1
- package/dist/lib/core/ProtocolResponseParser.js +28 -18
- package/dist/lib/core/ProtocolResponseParser.mjs +11 -1
- package/dist/lib/core/ResponseValidator.js +1 -1
- package/dist/lib/core/ResponseValidator.mjs +1 -1
- package/dist/lib/core/SingleAgentClient.d.mts +122 -7
- package/dist/lib/core/SingleAgentClient.d.ts +122 -7
- package/dist/lib/core/SingleAgentClient.js +601 -96
- package/dist/lib/core/SingleAgentClient.mjs +590 -84
- package/dist/lib/core/TaskExecutor.d.mts +7 -0
- package/dist/lib/core/TaskExecutor.d.ts +7 -0
- package/dist/lib/core/TaskExecutor.js +23 -8
- package/dist/lib/core/TaskExecutor.mjs +23 -8
- package/dist/lib/core/task-status.d.mts +2 -0
- package/dist/lib/core/task-status.d.ts +2 -0
- package/dist/lib/core/task-status.js +11 -2
- package/dist/lib/core/task-status.mjs +9 -1
- package/dist/lib/errors/index.d.mts +22 -0
- package/dist/lib/errors/index.d.ts +22 -0
- package/dist/lib/errors/index.js +43 -0
- package/dist/lib/errors/index.mjs +42 -0
- package/dist/lib/identity-3.3/trust.d.mts +1 -4
- package/dist/lib/identity-3.3/trust.d.ts +1 -4
- package/dist/lib/identity-3.3/trust.js +34 -21
- package/dist/lib/identity-3.3/trust.mjs +34 -21
- package/dist/lib/identity-3.3/validation.js +5 -3
- package/dist/lib/identity-3.3/validation.mjs +6 -4
- package/dist/lib/index.d.mts +7 -53
- package/dist/lib/index.d.ts +7 -53
- package/dist/lib/index.js +13 -0
- package/dist/lib/index.mjs +9 -0
- package/dist/lib/media-buy/compatibility.js +6 -1
- package/dist/lib/media-buy/compatibility.mjs +6 -1
- package/dist/lib/protocols/mcp-modern.d.mts +2 -0
- package/dist/lib/protocols/mcp-modern.d.ts +2 -0
- package/dist/lib/protocols/mcp-modern.js +31 -5
- package/dist/lib/protocols/mcp-modern.mjs +31 -5
- package/dist/lib/protocols/mcp-scope.d.mts +6 -1
- package/dist/lib/protocols/mcp-scope.d.ts +6 -1
- package/dist/lib/protocols/mcp-scope.js +25 -3
- package/dist/lib/protocols/mcp-scope.mjs +24 -3
- package/dist/lib/protocols/mcp.js +12 -6
- package/dist/lib/protocols/mcp.mjs +13 -6
- package/dist/lib/reporting/inspection.js +1 -0
- package/dist/lib/reporting/inspection.mjs +1 -0
- package/dist/lib/reporting/ledger/coverage.d.mts +5 -0
- package/dist/lib/reporting/ledger/coverage.d.ts +5 -0
- package/dist/lib/reporting/ledger/coverage.js +37 -3
- package/dist/lib/reporting/ledger/coverage.mjs +36 -3
- package/dist/lib/reporting/ledger/handler.js +7 -4
- package/dist/lib/reporting/ledger/handler.mjs +7 -4
- package/dist/lib/reporting/ledger/producer.js +215 -69
- package/dist/lib/reporting/ledger/producer.mjs +217 -70
- package/dist/lib/reporting/ledger/schedule.d.mts +2 -2
- package/dist/lib/reporting/ledger/schedule.d.ts +2 -2
- package/dist/lib/reporting/ledger/schedule.js +8 -5
- package/dist/lib/reporting/ledger/schedule.mjs +8 -5
- package/dist/lib/reporting/ledger/status-ingest.d.mts +1 -1
- package/dist/lib/reporting/ledger/status-ingest.d.ts +1 -1
- package/dist/lib/reporting/ledger/status-ingest.js +4 -3
- package/dist/lib/reporting/ledger/status-ingest.mjs +4 -3
- package/dist/lib/reporting/ledger/types.d.mts +36 -1
- package/dist/lib/reporting/ledger/types.d.ts +36 -1
- package/dist/lib/reporting/service/index.d.mts +14 -1
- package/dist/lib/reporting/service/index.d.ts +14 -1
- package/dist/lib/reporting/service/index.js +24 -12
- package/dist/lib/reporting/service/index.mjs +24 -12
- package/dist/lib/schemas/browser.d.mts +2 -0
- package/dist/lib/schemas/browser.d.ts +2 -0
- package/dist/lib/schemas/browser.js +3 -0
- package/dist/lib/schemas/browser.mjs +2 -0
- package/dist/lib/schemas/index.d.mts +5 -3
- package/dist/lib/schemas/index.d.ts +5 -3
- package/dist/lib/schemas/index.js +5 -0
- package/dist/lib/schemas/index.mjs +4 -0
- package/dist/lib/server/account-response-identity.d.mts +17 -0
- package/dist/lib/server/account-response-identity.d.ts +17 -0
- package/dist/lib/server/account-response-identity.js +52 -0
- package/dist/lib/server/account-response-identity.mjs +28 -0
- package/dist/lib/server/account-sync-contract.js +2 -2
- package/dist/lib/server/account-sync-contract.mjs +2 -2
- package/dist/lib/server/create-adcp-server.js +33 -20
- package/dist/lib/server/create-adcp-server.mjs +36 -12
- package/dist/lib/server/decisioning/account.d.mts +36 -10
- package/dist/lib/server/decisioning/account.d.ts +36 -10
- package/dist/lib/server/decisioning/account.js +33 -14
- package/dist/lib/server/decisioning/account.mjs +33 -14
- package/dist/lib/server/decisioning/runtime/from-platform.d.mts +5 -5
- package/dist/lib/server/decisioning/runtime/from-platform.d.ts +5 -5
- package/dist/lib/server/decisioning/runtime/from-platform.js +4 -4
- package/dist/lib/server/decisioning/runtime/from-platform.mjs +4 -4
- package/dist/lib/server/media-buy-store.d.mts +26 -12
- package/dist/lib/server/media-buy-store.d.ts +26 -12
- package/dist/lib/server/media-buy-store.js +69 -21
- package/dist/lib/server/media-buy-store.mjs +69 -21
- package/dist/lib/server/notification-subscriptions/runtime.d.mts +1 -1
- package/dist/lib/server/notification-subscriptions/runtime.d.ts +1 -1
- package/dist/lib/server/notification-subscriptions/runtime.js +4 -0
- package/dist/lib/server/notification-subscriptions/runtime.mjs +4 -0
- package/dist/lib/server/responses.js +9 -1
- package/dist/lib/server/responses.mjs +9 -1
- package/dist/lib/signing/agent-fetch.d.mts +1 -1
- package/dist/lib/signing/agent-fetch.d.ts +1 -1
- package/dist/lib/signing/agent-fetch.js +3 -3
- package/dist/lib/signing/agent-fetch.mjs +3 -3
- package/dist/lib/testing/client.d.mts +1 -0
- package/dist/lib/testing/client.d.ts +1 -0
- package/dist/lib/testing/client.js +6 -5
- package/dist/lib/testing/client.mjs +6 -5
- package/dist/lib/testing/storyboard/agent-routing.d.mts +5 -2
- package/dist/lib/testing/storyboard/agent-routing.d.ts +5 -2
- package/dist/lib/testing/storyboard/agent-routing.js +11 -4
- package/dist/lib/testing/storyboard/agent-routing.mjs +11 -4
- package/dist/lib/testing/storyboard/canonical-format-satisfaction.js +60 -14
- package/dist/lib/testing/storyboard/canonical-format-satisfaction.mjs +60 -14
- package/dist/lib/testing/storyboard/compliance.d.mts +2 -5
- package/dist/lib/testing/storyboard/compliance.d.ts +2 -5
- package/dist/lib/testing/storyboard/compliance.js +62 -13
- package/dist/lib/testing/storyboard/compliance.mjs +63 -14
- package/dist/lib/testing/storyboard/context.d.mts +13 -3
- package/dist/lib/testing/storyboard/context.d.ts +13 -3
- package/dist/lib/testing/storyboard/context.js +15 -10
- package/dist/lib/testing/storyboard/context.mjs +15 -10
- package/dist/lib/testing/storyboard/request-signing/vector-loader.d.mts +2 -0
- package/dist/lib/testing/storyboard/request-signing/vector-loader.d.ts +2 -0
- package/dist/lib/testing/storyboard/request-signing/vector-loader.js +11 -0
- package/dist/lib/testing/storyboard/request-signing/vector-loader.mjs +10 -0
- package/dist/lib/testing/storyboard/runner.js +141 -13
- package/dist/lib/testing/storyboard/runner.mjs +141 -13
- package/dist/lib/testing/storyboard/validations.d.mts +1 -1
- package/dist/lib/testing/storyboard/validations.d.ts +1 -1
- package/dist/lib/testing/storyboard/validations.js +4 -1
- package/dist/lib/testing/storyboard/validations.mjs +4 -1
- package/dist/lib/testing/test-controller.js +3 -0
- package/dist/lib/testing/test-controller.mjs +3 -0
- package/dist/lib/types/accept-proposal.d.ts +20 -28
- package/dist/lib/types/asset-instances.d.mts +1 -1
- package/dist/lib/types/asset-instances.d.ts +1 -1
- package/dist/lib/types/buy-products.d.ts +20 -28
- package/dist/lib/types/check-governance.d.ts +20 -28
- package/dist/lib/types/comply-test-controller.d.ts +20 -28
- package/dist/lib/types/control-media-buy.d.ts +20 -28
- package/dist/lib/types/core.generated.d.mts +273 -184
- package/dist/lib/types/core.generated.d.ts +273 -184
- package/dist/lib/types/create-media-buy.d.ts +20 -28
- package/dist/lib/types/get-media-buys.d.ts +20 -28
- package/dist/lib/types/get-products.d.ts +20 -28
- package/dist/lib/types/index.d.mts +6 -1
- package/dist/lib/types/index.d.ts +6 -1
- package/dist/lib/types/index.js +6 -1
- package/dist/lib/types/index.mjs +4 -1
- package/dist/lib/types/inline-enums.generated.d.mts +30 -4
- package/dist/lib/types/inline-enums.generated.d.ts +30 -4
- package/dist/lib/types/inline-enums.generated.js +41 -2
- package/dist/lib/types/inline-enums.generated.mjs +28 -2
- package/dist/lib/types/list-products.d.ts +20 -28
- package/dist/lib/types/list-proposals.d.ts +20 -28
- package/dist/lib/types/media-buy-delivery-report.d.mts +6 -0
- package/dist/lib/types/media-buy-delivery-report.d.ts +6 -0
- package/dist/lib/types/media-buy-delivery-report.js +16 -0
- package/dist/lib/types/media-buy-delivery-report.mjs +0 -0
- package/dist/lib/types/refine-proposals.d.ts +20 -28
- package/dist/lib/types/request-proposals.d.ts +20 -28
- package/dist/lib/types/schemas.generated.d.ts +63113 -127273
- package/dist/lib/types/schemas.generated.js +759 -770
- package/dist/lib/types/schemas.generated.mjs +759 -770
- package/dist/lib/types/targeting-keys.generated.d.mts +4 -0
- package/dist/lib/types/targeting-keys.generated.d.ts +4 -0
- package/dist/lib/types/targeting-keys.generated.js +109 -0
- package/dist/lib/types/targeting-keys.generated.mjs +84 -0
- package/dist/lib/types/tools.generated.d.mts +2 -68
- package/dist/lib/types/tools.generated.d.ts +2 -68
- package/dist/lib/types/update-media-buy.d.ts +20 -28
- package/dist/lib/utils/adcp-version-config.js +5 -2
- package/dist/lib/utils/adcp-version-config.mjs +5 -2
- package/dist/lib/utils/envelope-status-compat.d.mts +18 -1
- package/dist/lib/utils/envelope-status-compat.d.ts +18 -1
- package/dist/lib/utils/envelope-status-compat.js +11 -5
- package/dist/lib/utils/envelope-status-compat.mjs +11 -5
- package/dist/lib/utils/response-unwrapper.js +18 -10
- package/dist/lib/utils/response-unwrapper.mjs +18 -10
- package/dist/lib/v2/format-schema/resolver.js +1 -1
- package/dist/lib/v2/format-schema/resolver.mjs +1 -1
- package/dist/lib/v2/projection/creative-delivery.js +159 -39
- package/dist/lib/v2/projection/creative-delivery.mjs +163 -39
- package/dist/lib/v2/projection/index.d.mts +1 -0
- package/dist/lib/v2/projection/index.d.ts +1 -0
- package/dist/lib/v2/projection/index.js +3 -0
- package/dist/lib/v2/projection/index.mjs +2 -0
- package/dist/lib/v2/projection/legacy-metadata.d.mts +19 -0
- package/dist/lib/v2/projection/legacy-metadata.d.ts +19 -0
- package/dist/lib/v2/projection/legacy-metadata.js +91 -0
- package/dist/lib/v2/projection/legacy-metadata.mjs +86 -0
- package/dist/lib/v2/projection/v1-to-v2.d.mts +1 -1
- package/dist/lib/v2/projection/v1-to-v2.d.ts +1 -1
- package/dist/lib/v2/projection/v1-to-v2.js +12 -9
- package/dist/lib/v2/projection/v1-to-v2.mjs +12 -9
- package/dist/lib/validation/budget-allocation.d.mts +3 -3
- package/dist/lib/validation/budget-allocation.d.ts +3 -3
- package/dist/lib/validation/compact-schema.d.mts +27 -0
- package/dist/lib/validation/compact-schema.d.ts +27 -0
- package/dist/lib/validation/compact-schema.js +276 -0
- package/dist/lib/validation/compact-schema.mjs +250 -0
- package/dist/lib/validation/media-buy-delivery-report.d.mts +8 -0
- package/dist/lib/validation/media-buy-delivery-report.d.ts +8 -0
- package/dist/lib/validation/media-buy-delivery-report.js +31 -0
- package/dist/lib/validation/media-buy-delivery-report.mjs +7 -0
- package/dist/lib/validation/nonempty-array.d.mts +15 -0
- package/dist/lib/validation/nonempty-array.d.ts +15 -0
- package/dist/lib/validation/nonempty-array.js +41 -0
- package/dist/lib/validation/nonempty-array.mjs +7 -0
- package/dist/lib/validation/schema-diagnostic-origins.d.mts +21 -0
- package/dist/lib/validation/schema-diagnostic-origins.d.ts +21 -0
- package/dist/lib/validation/schema-diagnostic-origins.js +193 -0
- package/dist/lib/validation/schema-diagnostic-origins.mjs +169 -0
- package/dist/lib/validation/schema-loader.js +86 -16
- package/dist/lib/validation/schema-loader.mjs +82 -16
- package/dist/lib/validation/schema-validator.d.mts +10 -19
- package/dist/lib/validation/schema-validator.d.ts +10 -19
- package/dist/lib/validation/schema-validator.js +136 -43
- package/dist/lib/validation/schema-validator.mjs +140 -44
- package/dist/lib/validation/sync-creatives.d.mts +22 -22
- package/dist/lib/validation/sync-creatives.d.ts +22 -22
- package/dist/lib/version.d.mts +3 -3
- package/dist/lib/version.d.ts +3 -3
- package/dist/lib/version.js +3 -3
- package/dist/lib/version.mjs +3 -3
- package/dist/lib/webhooks/index.d.mts +3 -0
- package/dist/lib/webhooks/index.d.ts +3 -0
- package/dist/lib/webhooks/index.js +3 -0
- package/dist/lib/webhooks/index.mjs +2 -0
- package/dist/lib/webhooks/media-buy-delivery.d.mts +43 -0
- package/dist/lib/webhooks/media-buy-delivery.d.ts +43 -0
- package/dist/lib/webhooks/media-buy-delivery.js +119 -0
- package/dist/lib/webhooks/media-buy-delivery.mjs +94 -0
- package/docs/TYPE-SUMMARY.md +2 -2
- package/docs/guides/COLLECTION-FIXTURE-FOUNDATION.md +11 -0
- package/docs/guides/DELIVERY-WEBHOOK-PARSING.md +142 -0
- package/docs/guides/DISCOVERY-CACHE-AND-SESSION-REUSE.md +27 -1
- package/docs/guides/REPORTING-LEDGER.md +93 -0
- package/docs/guides/REPORTING-STABILITY.md +1 -1
- package/docs/guides/TYPED-CLIENT-TOOLS.md +49 -0
- package/docs/llms.txt +2 -2
- package/docs/migration-14.x-rc-worksheet.md +4 -4
- package/docs/migration-16-to-17.md +202 -2
- package/docs/migration-6.6-to-6.7.md +14 -0
- package/docs/migration-account-change-feed.md +15 -0
- package/docs/migration-reporting-storage-package.md +1 -1
- package/docs/recipes/verifying-inbound-webhooks.md +18 -2
- package/package.json +2 -2
|
@@ -1,3 +1,5 @@
|
|
|
1
|
+
import type * as ToolTypes from '../types/tools.generated.mjs';
|
|
2
|
+
import type * as CoreTypes from '../types/core.generated.mjs';
|
|
1
3
|
import type { Client as MCPClient } from '@modelcontextprotocol/sdk/client/index.js';
|
|
2
4
|
import type { AccountReference, AgentConfig } from '../types/index.mjs';
|
|
3
5
|
import type { ResolveAccountOptions, ResolveAccountResult } from './account-resolution.mjs';
|
|
@@ -94,6 +96,40 @@ export type TaskResponseTypeMap = {
|
|
|
94
96
|
sync_agent_notification_configs: SyncAgentNotificationConfigsResponse;
|
|
95
97
|
get_principal: GetPrincipalResponse;
|
|
96
98
|
sync_principal: SyncPrincipalResponse;
|
|
99
|
+
acquire_rights: CoreTypes.AcquireRightsResponse;
|
|
100
|
+
build_creative: ToolTypes.BuildCreativeResponse;
|
|
101
|
+
calibrate_content: ToolTypes.CalibrateContentResponse;
|
|
102
|
+
comply_test_controller: ToolTypes.ComplyTestControllerResponse;
|
|
103
|
+
create_collection_list: ToolTypes.CreateCollectionListResponse;
|
|
104
|
+
create_content_standards: ToolTypes.CreateContentStandardsResponse;
|
|
105
|
+
delete_collection_list: ToolTypes.DeleteCollectionListResponse;
|
|
106
|
+
get_account_financials: ToolTypes.GetAccountFinancialsResponse;
|
|
107
|
+
get_collection_list: ToolTypes.GetCollectionListResponse;
|
|
108
|
+
get_content_standards: ToolTypes.GetContentStandardsResponse;
|
|
109
|
+
get_creative_features: ToolTypes.GetCreativeFeaturesResponse;
|
|
110
|
+
get_media_buy_artifacts: ToolTypes.GetMediaBuyArtifactsResponse;
|
|
111
|
+
get_rights: CoreTypes.GetRightsResponse;
|
|
112
|
+
get_task_status: ToolTypes.GetTaskStatusResponse;
|
|
113
|
+
list_collection_lists: ToolTypes.ListCollectionListsResponse;
|
|
114
|
+
list_content_standards: ToolTypes.ListContentStandardsResponse;
|
|
115
|
+
list_creative_formats: ToolTypes.ListCreativeFormatsResponse;
|
|
116
|
+
list_tasks: ToolTypes.ListTasksResponse;
|
|
117
|
+
list_transformers: ToolTypes.ListTransformersResponse;
|
|
118
|
+
log_event: ToolTypes.LogEventResponse;
|
|
119
|
+
preview_creative: CanonicalPreviewCreativeResponse;
|
|
120
|
+
report_usage: ToolTypes.ReportUsageResponse;
|
|
121
|
+
search_brands: CoreTypes.SearchBrandsResponse;
|
|
122
|
+
sync_catalogs: ToolTypes.SyncCatalogsResponse;
|
|
123
|
+
sync_event_sources: ToolTypes.SyncEventSourcesResponse;
|
|
124
|
+
sync_governance: ToolTypes.SyncGovernanceResponse;
|
|
125
|
+
update_collection_list: ToolTypes.UpdateCollectionListResponse;
|
|
126
|
+
update_content_standards: ToolTypes.UpdateContentStandardsResponse;
|
|
127
|
+
update_rights: CoreTypes.UpdateRightsResponse;
|
|
128
|
+
validate_content_delivery: ToolTypes.ValidateContentDeliveryResponse;
|
|
129
|
+
validate_input: ToolTypes.ValidateInputResponse;
|
|
130
|
+
validate_property_delivery: CoreTypes.ValidatePropertyDeliveryResponse;
|
|
131
|
+
verify_brand_claim: CoreTypes.VerifyBrandClaimResponse;
|
|
132
|
+
verify_brand_claims: CoreTypes.VerifyBrandClaimsResponseBulk;
|
|
97
133
|
};
|
|
98
134
|
/**
|
|
99
135
|
* Valid ADCP task names
|
|
@@ -149,6 +185,40 @@ export type TaskRequestTypeMap = {
|
|
|
149
185
|
sync_agent_notification_configs: MutatingRequestInput<SyncAgentNotificationConfigsRequest>;
|
|
150
186
|
get_principal: GetPrincipalRequest;
|
|
151
187
|
sync_principal: MutatingRequestInput<SyncPrincipalRequest>;
|
|
188
|
+
acquire_rights: MutatingRequestInput<CoreTypes.AcquireRightsRequest>;
|
|
189
|
+
build_creative: MutatingRequestInput<ToolTypes.BuildCreativeRequest>;
|
|
190
|
+
calibrate_content: MutatingRequestInput<ToolTypes.CalibrateContentRequest>;
|
|
191
|
+
comply_test_controller: ToolTypes.ComplyTestControllerRequest;
|
|
192
|
+
create_collection_list: MutatingRequestInput<ToolTypes.CreateCollectionListRequest>;
|
|
193
|
+
create_content_standards: MutatingRequestInput<ToolTypes.CreateContentStandardsRequest>;
|
|
194
|
+
delete_collection_list: MutatingRequestInput<ToolTypes.DeleteCollectionListRequest>;
|
|
195
|
+
get_account_financials: ToolTypes.GetAccountFinancialsRequest;
|
|
196
|
+
get_collection_list: ToolTypes.GetCollectionListRequest;
|
|
197
|
+
get_content_standards: ToolTypes.GetContentStandardsRequest;
|
|
198
|
+
get_creative_features: ToolTypes.GetCreativeFeaturesRequest;
|
|
199
|
+
get_media_buy_artifacts: ToolTypes.GetMediaBuyArtifactsRequest;
|
|
200
|
+
get_rights: CoreTypes.GetRightsRequest;
|
|
201
|
+
get_task_status: ToolTypes.GetTaskStatusRequest;
|
|
202
|
+
list_collection_lists: ToolTypes.ListCollectionListsRequest;
|
|
203
|
+
list_content_standards: ToolTypes.ListContentStandardsRequest;
|
|
204
|
+
list_creative_formats: ToolTypes.ListCreativeFormatsRequest;
|
|
205
|
+
list_tasks: ToolTypes.ListTasksRequest;
|
|
206
|
+
list_transformers: ToolTypes.ListTransformersRequest;
|
|
207
|
+
log_event: MutatingRequestInput<ToolTypes.LogEventRequest>;
|
|
208
|
+
preview_creative: CanonicalPreviewCreativeRequest;
|
|
209
|
+
report_usage: MutatingRequestInput<ToolTypes.ReportUsageRequest>;
|
|
210
|
+
search_brands: CoreTypes.SearchBrandsRequest;
|
|
211
|
+
sync_catalogs: MutatingRequestInput<ToolTypes.SyncCatalogsRequest>;
|
|
212
|
+
sync_event_sources: MutatingRequestInput<ToolTypes.SyncEventSourcesRequest>;
|
|
213
|
+
sync_governance: MutatingRequestInput<ToolTypes.SyncGovernanceRequest>;
|
|
214
|
+
update_collection_list: MutatingRequestInput<ToolTypes.UpdateCollectionListRequest>;
|
|
215
|
+
update_content_standards: MutatingRequestInput<ToolTypes.UpdateContentStandardsRequest>;
|
|
216
|
+
update_rights: MutatingRequestInput<CoreTypes.UpdateRightsRequest>;
|
|
217
|
+
validate_content_delivery: ToolTypes.ValidateContentDeliveryRequest;
|
|
218
|
+
validate_input: ToolTypes.ValidateInputRequest;
|
|
219
|
+
validate_property_delivery: CoreTypes.ValidatePropertyDeliveryRequest;
|
|
220
|
+
verify_brand_claim: CoreTypes.VerifyBrandClaimRequest;
|
|
221
|
+
verify_brand_claims: CoreTypes.VerifyBrandClaimsRequestBulk;
|
|
152
222
|
};
|
|
153
223
|
export type TaskRequestFor<K extends AdcpTaskName> = TaskRequestTypeMap[K];
|
|
154
224
|
/**
|
|
@@ -212,6 +282,13 @@ export declare class AgentClient {
|
|
|
212
282
|
* rejected rather than silently falling back to redundant discovery.
|
|
213
283
|
*/
|
|
214
284
|
static createWithCapabilityPreflight(agent: AgentConfig, loadEvidence: CapabilityPreflightLoader, config?: SingleAgentClientConfig): Promise<AgentClient>;
|
|
285
|
+
/** Execute the typed AdCP get_task_status tool. */
|
|
286
|
+
getTaskStatus(params: ToolTypes.GetTaskStatusRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.GetTaskStatusResponse>>;
|
|
287
|
+
/** Poll one task and map its status to TaskInfo. Preserved for existing callers. */
|
|
288
|
+
getTaskStatus(taskId: string, transport?: import('../protocols/index.mjs').TransportOptions, signal?: AbortSignal, wireOptions?: {
|
|
289
|
+
wireAdcpVersion?: string;
|
|
290
|
+
versionEnvelope?: import('../protocols/index.mjs').VersionEnvelopeMode;
|
|
291
|
+
}): Promise<TaskInfo>;
|
|
215
292
|
/**
|
|
216
293
|
* Recover the current A2A pause generation for a direct mutation that opted
|
|
217
294
|
* into `TaskOptions.durableContinuationRecovery`.
|
|
@@ -606,6 +683,88 @@ export declare class AgentClient {
|
|
|
606
683
|
* Sync audiences
|
|
607
684
|
*/
|
|
608
685
|
syncAudiences(params: MutatingRequestInput<SyncAudiencesRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<SyncAudiencesResponse>>;
|
|
686
|
+
/** Execute the AdCP acquire_rights tool. */
|
|
687
|
+
acquireRights(params: MutatingRequestInput<CoreTypes.AcquireRightsRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.AcquireRightsResponse>>;
|
|
688
|
+
/** Generate, transform, refine, retrieve, or adapt creative manifests for advertised creative capabilities. */
|
|
689
|
+
buildCreative(params: MutatingRequestInput<ToolTypes.BuildCreativeRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.BuildCreativeResponse>>;
|
|
690
|
+
/** Execute the AdCP calibrate_content tool. */
|
|
691
|
+
calibrateContent(params: MutatingRequestInput<ToolTypes.CalibrateContentRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.CalibrateContentResponse>>;
|
|
692
|
+
/** Execute the AdCP check_governance tool. */
|
|
693
|
+
checkGovernance(params: ToolTypes.CheckGovernanceRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.CheckGovernanceResponse>>;
|
|
694
|
+
/** Control a seller compliance scenario. Intended for conformance testing. */
|
|
695
|
+
complyTestController(params: ToolTypes.ComplyTestControllerRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ComplyTestControllerResponse>>;
|
|
696
|
+
/** Execute the AdCP create_collection_list tool. */
|
|
697
|
+
createCollectionList(params: MutatingRequestInput<ToolTypes.CreateCollectionListRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.CreateCollectionListResponse>>;
|
|
698
|
+
/** Execute the AdCP create_content_standards tool. */
|
|
699
|
+
createContentStandards(params: MutatingRequestInput<ToolTypes.CreateContentStandardsRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.CreateContentStandardsResponse>>;
|
|
700
|
+
/** Execute the AdCP delete_collection_list tool. */
|
|
701
|
+
deleteCollectionList(params: MutatingRequestInput<ToolTypes.DeleteCollectionListRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.DeleteCollectionListResponse>>;
|
|
702
|
+
/** Retrieve spend, credit or balance status, and invoice history for an operator-billed account. */
|
|
703
|
+
getAccountFinancials(params: ToolTypes.GetAccountFinancialsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.GetAccountFinancialsResponse>>;
|
|
704
|
+
/** Execute the AdCP get_brand_identity tool. */
|
|
705
|
+
getBrandIdentity(params: CoreTypes.GetBrandIdentityRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.GetBrandIdentityResponse>>;
|
|
706
|
+
/** Execute the AdCP get_collection_list tool. */
|
|
707
|
+
getCollectionList(params: ToolTypes.GetCollectionListRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.GetCollectionListResponse>>;
|
|
708
|
+
/** Execute the AdCP get_content_standards tool. */
|
|
709
|
+
getContentStandards(params: ToolTypes.GetContentStandardsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.GetContentStandardsResponse>>;
|
|
710
|
+
/** Evaluate a creative manifest and return scored safety, content, quality, and governance features. */
|
|
711
|
+
getCreativeFeatures(params: ToolTypes.GetCreativeFeaturesRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.GetCreativeFeaturesResponse>>;
|
|
712
|
+
/** Execute the AdCP get_media_buy_artifacts tool. */
|
|
713
|
+
getMediaBuyArtifacts(params: ToolTypes.GetMediaBuyArtifactsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.GetMediaBuyArtifactsResponse>>;
|
|
714
|
+
/** Execute the AdCP get_plan_audit_logs tool. */
|
|
715
|
+
getPlanAuditLogs(params: ToolTypes.GetPlanAuditLogsRequest, inputHandler?: InputHandler, options?: TaskOptions & {
|
|
716
|
+
agent?: AgentConfig;
|
|
717
|
+
}): Promise<TaskResult<ToolTypes.GetPlanAuditLogsResponse>>;
|
|
718
|
+
/** Check reporting health, enumerate expected periods and all retained revisions, or resolve one exact reporting revision. */
|
|
719
|
+
getReportingStatus(params: ToolTypes.GetReportingStatusRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.GetReportingStatusResponse>>;
|
|
720
|
+
/** Execute the AdCP get_rights tool. */
|
|
721
|
+
getRights(params: CoreTypes.GetRightsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.GetRightsResponse>>;
|
|
722
|
+
/** Execute the AdCP list_collection_lists tool. */
|
|
723
|
+
listCollectionLists(params: ToolTypes.ListCollectionListsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ListCollectionListsResponse>>;
|
|
724
|
+
/** Execute the AdCP list_content_standards tool. */
|
|
725
|
+
listContentStandards(params: ToolTypes.ListContentStandardsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ListContentStandardsResponse>>;
|
|
726
|
+
/** Execute the AdCP list_creative_formats tool. */
|
|
727
|
+
listCreativeFormats(params: ToolTypes.ListCreativeFormatsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ListCreativeFormatsResponse>>;
|
|
728
|
+
/** Discover account-scoped creative transformers and their selectable configuration options. */
|
|
729
|
+
listTransformers(params: ToolTypes.ListTransformersRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ListTransformersResponse>>;
|
|
730
|
+
/** Log batches of marketing events against a configured event source for measurement and attribution. */
|
|
731
|
+
logEvent(params: MutatingRequestInput<ToolTypes.LogEventRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.LogEventResponse>>;
|
|
732
|
+
/** Execute the AdCP report_plan_outcome tool. */
|
|
733
|
+
reportPlanOutcome(params: MutatingRequestInput<ToolTypes.ReportPlanOutcomeRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ReportPlanOutcomeResponse>>;
|
|
734
|
+
/** Report vendor-service consumption and final measurements for revenue tracking and billing reconciliation. */
|
|
735
|
+
reportUsage(params: MutatingRequestInput<ToolTypes.ReportUsageRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ReportUsageResponse>>;
|
|
736
|
+
/** Execute the AdCP search_brands tool. */
|
|
737
|
+
searchBrands(params: CoreTypes.SearchBrandsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.SearchBrandsResponse>>;
|
|
738
|
+
/** List or synchronize buyer-managed account catalog feeds, suppress or restore specific items, and read current availability state. */
|
|
739
|
+
syncCatalogs(params: MutatingRequestInput<ToolTypes.SyncCatalogsRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.SyncCatalogsResponse>>;
|
|
740
|
+
/** List or synchronize account event sources with upsert and optional replacement semantics. */
|
|
741
|
+
syncEventSources(params: MutatingRequestInput<ToolTypes.SyncEventSourcesRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.SyncEventSourcesResponse>>;
|
|
742
|
+
/** Bind or replace the governance agent used for approval across specific advertiser accounts. */
|
|
743
|
+
syncGovernance(params: MutatingRequestInput<ToolTypes.SyncGovernanceRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.SyncGovernanceResponse>>;
|
|
744
|
+
/** Execute the AdCP sync_plans tool. */
|
|
745
|
+
syncPlans(params: MutatingRequestInput<ToolTypes.SyncPlansRequest>, inputHandler?: InputHandler, options?: TaskOptions & {
|
|
746
|
+
agent?: AgentConfig;
|
|
747
|
+
}): Promise<TaskResult<ToolTypes.SyncPlansResponse>>;
|
|
748
|
+
/** Record a consumer's independently verified reporting totals and destination evidence in the seller ledger. */
|
|
749
|
+
syncReportingReceipts(params: MutatingRequestInput<ToolTypes.SyncReportingReceiptsRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.SyncReportingReceiptsResponse>>;
|
|
750
|
+
/** Tell a seller whether expected reporting was received, omitted, missing, unreadable, or contradictory. */
|
|
751
|
+
syncReportingStatus(params: MutatingRequestInput<ToolTypes.SyncReportingStatusRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.SyncReportingStatusResponse>>;
|
|
752
|
+
/** Execute the AdCP update_collection_list tool. */
|
|
753
|
+
updateCollectionList(params: MutatingRequestInput<ToolTypes.UpdateCollectionListRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.UpdateCollectionListResponse>>;
|
|
754
|
+
/** Execute the AdCP update_content_standards tool. */
|
|
755
|
+
updateContentStandards(params: MutatingRequestInput<ToolTypes.UpdateContentStandardsRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.UpdateContentStandardsResponse>>;
|
|
756
|
+
/** Execute the AdCP update_rights tool. */
|
|
757
|
+
updateRights(params: MutatingRequestInput<CoreTypes.UpdateRightsRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.UpdateRightsResponse>>;
|
|
758
|
+
/** Execute the AdCP validate_content_delivery tool. */
|
|
759
|
+
validateContentDelivery(params: ToolTypes.ValidateContentDeliveryRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ValidateContentDeliveryResponse>>;
|
|
760
|
+
/** Preflight a creative manifest against canonical formats, products, third-party formats, or agent capabilities. */
|
|
761
|
+
validateInput(params: ToolTypes.ValidateInputRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ValidateInputResponse>>;
|
|
762
|
+
/** Execute the AdCP validate_property_delivery tool. */
|
|
763
|
+
validatePropertyDelivery(params: CoreTypes.ValidatePropertyDeliveryRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.ValidatePropertyDeliveryResponse>>;
|
|
764
|
+
/** Execute the AdCP verify_brand_claim tool. */
|
|
765
|
+
verifyBrandClaim(params: CoreTypes.VerifyBrandClaimRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.VerifyBrandClaimResponse>>;
|
|
766
|
+
/** Execute the AdCP verify_brand_claims tool. */
|
|
767
|
+
verifyBrandClaims(params: CoreTypes.VerifyBrandClaimsRequestBulk, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.VerifyBrandClaimsResponseBulk>>;
|
|
609
768
|
/**
|
|
610
769
|
* Create a property list
|
|
611
770
|
*/
|
|
@@ -822,7 +981,9 @@ export declare class AgentClient {
|
|
|
822
981
|
* const customResult = await agent.executeCustomTask<MyCustomResponse>('custom_task', params);
|
|
823
982
|
* ```
|
|
824
983
|
*/
|
|
825
|
-
executeTask<K extends AdcpTaskName>(taskName: K, params: TaskRequestFor<K>, inputHandler?: InputHandler, options?: TaskOptions
|
|
984
|
+
executeTask<K extends AdcpTaskName>(taskName: K, params: TaskRequestFor<K>, inputHandler?: InputHandler, options?: TaskOptions & {
|
|
985
|
+
agent?: K extends 'sync_plans' | 'get_plan_audit_logs' ? AgentConfig : never;
|
|
986
|
+
}): Promise<TaskResult<TaskResponseTypeMap[K]>>;
|
|
826
987
|
/** Execute an extension task that is not part of the standard AdCP task set. */
|
|
827
988
|
executeCustomTask<T = unknown>(taskName: string, params: Record<string, unknown>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<T>>;
|
|
828
989
|
/**
|
|
@@ -833,6 +994,9 @@ export declare class AgentClient {
|
|
|
833
994
|
/**
|
|
834
995
|
* List all tasks for this agent
|
|
835
996
|
*/
|
|
997
|
+
/** Query the seller's typed AdCP list_tasks tool. Pass {} for an unfiltered query. */
|
|
998
|
+
listTasks(params: ToolTypes.ListTasksRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ListTasksResponse>>;
|
|
999
|
+
/** List local tasks only. Pass {} to query the seller's list_tasks tool. */
|
|
836
1000
|
listTasks(): Promise<TaskInfo[]>;
|
|
837
1001
|
/**
|
|
838
1002
|
* Get detailed information about a specific task
|
|
@@ -1,3 +1,5 @@
|
|
|
1
|
+
import type * as ToolTypes from '../types/tools.generated';
|
|
2
|
+
import type * as CoreTypes from '../types/core.generated';
|
|
1
3
|
import type { Client as MCPClient } from '@modelcontextprotocol/sdk/client/index.js';
|
|
2
4
|
import type { AccountReference, AgentConfig } from '../types';
|
|
3
5
|
import type { ResolveAccountOptions, ResolveAccountResult } from './account-resolution';
|
|
@@ -94,6 +96,40 @@ export type TaskResponseTypeMap = {
|
|
|
94
96
|
sync_agent_notification_configs: SyncAgentNotificationConfigsResponse;
|
|
95
97
|
get_principal: GetPrincipalResponse;
|
|
96
98
|
sync_principal: SyncPrincipalResponse;
|
|
99
|
+
acquire_rights: CoreTypes.AcquireRightsResponse;
|
|
100
|
+
build_creative: ToolTypes.BuildCreativeResponse;
|
|
101
|
+
calibrate_content: ToolTypes.CalibrateContentResponse;
|
|
102
|
+
comply_test_controller: ToolTypes.ComplyTestControllerResponse;
|
|
103
|
+
create_collection_list: ToolTypes.CreateCollectionListResponse;
|
|
104
|
+
create_content_standards: ToolTypes.CreateContentStandardsResponse;
|
|
105
|
+
delete_collection_list: ToolTypes.DeleteCollectionListResponse;
|
|
106
|
+
get_account_financials: ToolTypes.GetAccountFinancialsResponse;
|
|
107
|
+
get_collection_list: ToolTypes.GetCollectionListResponse;
|
|
108
|
+
get_content_standards: ToolTypes.GetContentStandardsResponse;
|
|
109
|
+
get_creative_features: ToolTypes.GetCreativeFeaturesResponse;
|
|
110
|
+
get_media_buy_artifacts: ToolTypes.GetMediaBuyArtifactsResponse;
|
|
111
|
+
get_rights: CoreTypes.GetRightsResponse;
|
|
112
|
+
get_task_status: ToolTypes.GetTaskStatusResponse;
|
|
113
|
+
list_collection_lists: ToolTypes.ListCollectionListsResponse;
|
|
114
|
+
list_content_standards: ToolTypes.ListContentStandardsResponse;
|
|
115
|
+
list_creative_formats: ToolTypes.ListCreativeFormatsResponse;
|
|
116
|
+
list_tasks: ToolTypes.ListTasksResponse;
|
|
117
|
+
list_transformers: ToolTypes.ListTransformersResponse;
|
|
118
|
+
log_event: ToolTypes.LogEventResponse;
|
|
119
|
+
preview_creative: CanonicalPreviewCreativeResponse;
|
|
120
|
+
report_usage: ToolTypes.ReportUsageResponse;
|
|
121
|
+
search_brands: CoreTypes.SearchBrandsResponse;
|
|
122
|
+
sync_catalogs: ToolTypes.SyncCatalogsResponse;
|
|
123
|
+
sync_event_sources: ToolTypes.SyncEventSourcesResponse;
|
|
124
|
+
sync_governance: ToolTypes.SyncGovernanceResponse;
|
|
125
|
+
update_collection_list: ToolTypes.UpdateCollectionListResponse;
|
|
126
|
+
update_content_standards: ToolTypes.UpdateContentStandardsResponse;
|
|
127
|
+
update_rights: CoreTypes.UpdateRightsResponse;
|
|
128
|
+
validate_content_delivery: ToolTypes.ValidateContentDeliveryResponse;
|
|
129
|
+
validate_input: ToolTypes.ValidateInputResponse;
|
|
130
|
+
validate_property_delivery: CoreTypes.ValidatePropertyDeliveryResponse;
|
|
131
|
+
verify_brand_claim: CoreTypes.VerifyBrandClaimResponse;
|
|
132
|
+
verify_brand_claims: CoreTypes.VerifyBrandClaimsResponseBulk;
|
|
97
133
|
};
|
|
98
134
|
/**
|
|
99
135
|
* Valid ADCP task names
|
|
@@ -149,6 +185,40 @@ export type TaskRequestTypeMap = {
|
|
|
149
185
|
sync_agent_notification_configs: MutatingRequestInput<SyncAgentNotificationConfigsRequest>;
|
|
150
186
|
get_principal: GetPrincipalRequest;
|
|
151
187
|
sync_principal: MutatingRequestInput<SyncPrincipalRequest>;
|
|
188
|
+
acquire_rights: MutatingRequestInput<CoreTypes.AcquireRightsRequest>;
|
|
189
|
+
build_creative: MutatingRequestInput<ToolTypes.BuildCreativeRequest>;
|
|
190
|
+
calibrate_content: MutatingRequestInput<ToolTypes.CalibrateContentRequest>;
|
|
191
|
+
comply_test_controller: ToolTypes.ComplyTestControllerRequest;
|
|
192
|
+
create_collection_list: MutatingRequestInput<ToolTypes.CreateCollectionListRequest>;
|
|
193
|
+
create_content_standards: MutatingRequestInput<ToolTypes.CreateContentStandardsRequest>;
|
|
194
|
+
delete_collection_list: MutatingRequestInput<ToolTypes.DeleteCollectionListRequest>;
|
|
195
|
+
get_account_financials: ToolTypes.GetAccountFinancialsRequest;
|
|
196
|
+
get_collection_list: ToolTypes.GetCollectionListRequest;
|
|
197
|
+
get_content_standards: ToolTypes.GetContentStandardsRequest;
|
|
198
|
+
get_creative_features: ToolTypes.GetCreativeFeaturesRequest;
|
|
199
|
+
get_media_buy_artifacts: ToolTypes.GetMediaBuyArtifactsRequest;
|
|
200
|
+
get_rights: CoreTypes.GetRightsRequest;
|
|
201
|
+
get_task_status: ToolTypes.GetTaskStatusRequest;
|
|
202
|
+
list_collection_lists: ToolTypes.ListCollectionListsRequest;
|
|
203
|
+
list_content_standards: ToolTypes.ListContentStandardsRequest;
|
|
204
|
+
list_creative_formats: ToolTypes.ListCreativeFormatsRequest;
|
|
205
|
+
list_tasks: ToolTypes.ListTasksRequest;
|
|
206
|
+
list_transformers: ToolTypes.ListTransformersRequest;
|
|
207
|
+
log_event: MutatingRequestInput<ToolTypes.LogEventRequest>;
|
|
208
|
+
preview_creative: CanonicalPreviewCreativeRequest;
|
|
209
|
+
report_usage: MutatingRequestInput<ToolTypes.ReportUsageRequest>;
|
|
210
|
+
search_brands: CoreTypes.SearchBrandsRequest;
|
|
211
|
+
sync_catalogs: MutatingRequestInput<ToolTypes.SyncCatalogsRequest>;
|
|
212
|
+
sync_event_sources: MutatingRequestInput<ToolTypes.SyncEventSourcesRequest>;
|
|
213
|
+
sync_governance: MutatingRequestInput<ToolTypes.SyncGovernanceRequest>;
|
|
214
|
+
update_collection_list: MutatingRequestInput<ToolTypes.UpdateCollectionListRequest>;
|
|
215
|
+
update_content_standards: MutatingRequestInput<ToolTypes.UpdateContentStandardsRequest>;
|
|
216
|
+
update_rights: MutatingRequestInput<CoreTypes.UpdateRightsRequest>;
|
|
217
|
+
validate_content_delivery: ToolTypes.ValidateContentDeliveryRequest;
|
|
218
|
+
validate_input: ToolTypes.ValidateInputRequest;
|
|
219
|
+
validate_property_delivery: CoreTypes.ValidatePropertyDeliveryRequest;
|
|
220
|
+
verify_brand_claim: CoreTypes.VerifyBrandClaimRequest;
|
|
221
|
+
verify_brand_claims: CoreTypes.VerifyBrandClaimsRequestBulk;
|
|
152
222
|
};
|
|
153
223
|
export type TaskRequestFor<K extends AdcpTaskName> = TaskRequestTypeMap[K];
|
|
154
224
|
/**
|
|
@@ -212,6 +282,13 @@ export declare class AgentClient {
|
|
|
212
282
|
* rejected rather than silently falling back to redundant discovery.
|
|
213
283
|
*/
|
|
214
284
|
static createWithCapabilityPreflight(agent: AgentConfig, loadEvidence: CapabilityPreflightLoader, config?: SingleAgentClientConfig): Promise<AgentClient>;
|
|
285
|
+
/** Execute the typed AdCP get_task_status tool. */
|
|
286
|
+
getTaskStatus(params: ToolTypes.GetTaskStatusRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.GetTaskStatusResponse>>;
|
|
287
|
+
/** Poll one task and map its status to TaskInfo. Preserved for existing callers. */
|
|
288
|
+
getTaskStatus(taskId: string, transport?: import('../protocols').TransportOptions, signal?: AbortSignal, wireOptions?: {
|
|
289
|
+
wireAdcpVersion?: string;
|
|
290
|
+
versionEnvelope?: import('../protocols').VersionEnvelopeMode;
|
|
291
|
+
}): Promise<TaskInfo>;
|
|
215
292
|
/**
|
|
216
293
|
* Recover the current A2A pause generation for a direct mutation that opted
|
|
217
294
|
* into `TaskOptions.durableContinuationRecovery`.
|
|
@@ -606,6 +683,88 @@ export declare class AgentClient {
|
|
|
606
683
|
* Sync audiences
|
|
607
684
|
*/
|
|
608
685
|
syncAudiences(params: MutatingRequestInput<SyncAudiencesRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<SyncAudiencesResponse>>;
|
|
686
|
+
/** Execute the AdCP acquire_rights tool. */
|
|
687
|
+
acquireRights(params: MutatingRequestInput<CoreTypes.AcquireRightsRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.AcquireRightsResponse>>;
|
|
688
|
+
/** Generate, transform, refine, retrieve, or adapt creative manifests for advertised creative capabilities. */
|
|
689
|
+
buildCreative(params: MutatingRequestInput<ToolTypes.BuildCreativeRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.BuildCreativeResponse>>;
|
|
690
|
+
/** Execute the AdCP calibrate_content tool. */
|
|
691
|
+
calibrateContent(params: MutatingRequestInput<ToolTypes.CalibrateContentRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.CalibrateContentResponse>>;
|
|
692
|
+
/** Execute the AdCP check_governance tool. */
|
|
693
|
+
checkGovernance(params: ToolTypes.CheckGovernanceRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.CheckGovernanceResponse>>;
|
|
694
|
+
/** Control a seller compliance scenario. Intended for conformance testing. */
|
|
695
|
+
complyTestController(params: ToolTypes.ComplyTestControllerRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ComplyTestControllerResponse>>;
|
|
696
|
+
/** Execute the AdCP create_collection_list tool. */
|
|
697
|
+
createCollectionList(params: MutatingRequestInput<ToolTypes.CreateCollectionListRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.CreateCollectionListResponse>>;
|
|
698
|
+
/** Execute the AdCP create_content_standards tool. */
|
|
699
|
+
createContentStandards(params: MutatingRequestInput<ToolTypes.CreateContentStandardsRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.CreateContentStandardsResponse>>;
|
|
700
|
+
/** Execute the AdCP delete_collection_list tool. */
|
|
701
|
+
deleteCollectionList(params: MutatingRequestInput<ToolTypes.DeleteCollectionListRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.DeleteCollectionListResponse>>;
|
|
702
|
+
/** Retrieve spend, credit or balance status, and invoice history for an operator-billed account. */
|
|
703
|
+
getAccountFinancials(params: ToolTypes.GetAccountFinancialsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.GetAccountFinancialsResponse>>;
|
|
704
|
+
/** Execute the AdCP get_brand_identity tool. */
|
|
705
|
+
getBrandIdentity(params: CoreTypes.GetBrandIdentityRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.GetBrandIdentityResponse>>;
|
|
706
|
+
/** Execute the AdCP get_collection_list tool. */
|
|
707
|
+
getCollectionList(params: ToolTypes.GetCollectionListRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.GetCollectionListResponse>>;
|
|
708
|
+
/** Execute the AdCP get_content_standards tool. */
|
|
709
|
+
getContentStandards(params: ToolTypes.GetContentStandardsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.GetContentStandardsResponse>>;
|
|
710
|
+
/** Evaluate a creative manifest and return scored safety, content, quality, and governance features. */
|
|
711
|
+
getCreativeFeatures(params: ToolTypes.GetCreativeFeaturesRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.GetCreativeFeaturesResponse>>;
|
|
712
|
+
/** Execute the AdCP get_media_buy_artifacts tool. */
|
|
713
|
+
getMediaBuyArtifacts(params: ToolTypes.GetMediaBuyArtifactsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.GetMediaBuyArtifactsResponse>>;
|
|
714
|
+
/** Execute the AdCP get_plan_audit_logs tool. */
|
|
715
|
+
getPlanAuditLogs(params: ToolTypes.GetPlanAuditLogsRequest, inputHandler?: InputHandler, options?: TaskOptions & {
|
|
716
|
+
agent?: AgentConfig;
|
|
717
|
+
}): Promise<TaskResult<ToolTypes.GetPlanAuditLogsResponse>>;
|
|
718
|
+
/** Check reporting health, enumerate expected periods and all retained revisions, or resolve one exact reporting revision. */
|
|
719
|
+
getReportingStatus(params: ToolTypes.GetReportingStatusRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.GetReportingStatusResponse>>;
|
|
720
|
+
/** Execute the AdCP get_rights tool. */
|
|
721
|
+
getRights(params: CoreTypes.GetRightsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.GetRightsResponse>>;
|
|
722
|
+
/** Execute the AdCP list_collection_lists tool. */
|
|
723
|
+
listCollectionLists(params: ToolTypes.ListCollectionListsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ListCollectionListsResponse>>;
|
|
724
|
+
/** Execute the AdCP list_content_standards tool. */
|
|
725
|
+
listContentStandards(params: ToolTypes.ListContentStandardsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ListContentStandardsResponse>>;
|
|
726
|
+
/** Execute the AdCP list_creative_formats tool. */
|
|
727
|
+
listCreativeFormats(params: ToolTypes.ListCreativeFormatsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ListCreativeFormatsResponse>>;
|
|
728
|
+
/** Discover account-scoped creative transformers and their selectable configuration options. */
|
|
729
|
+
listTransformers(params: ToolTypes.ListTransformersRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ListTransformersResponse>>;
|
|
730
|
+
/** Log batches of marketing events against a configured event source for measurement and attribution. */
|
|
731
|
+
logEvent(params: MutatingRequestInput<ToolTypes.LogEventRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.LogEventResponse>>;
|
|
732
|
+
/** Execute the AdCP report_plan_outcome tool. */
|
|
733
|
+
reportPlanOutcome(params: MutatingRequestInput<ToolTypes.ReportPlanOutcomeRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ReportPlanOutcomeResponse>>;
|
|
734
|
+
/** Report vendor-service consumption and final measurements for revenue tracking and billing reconciliation. */
|
|
735
|
+
reportUsage(params: MutatingRequestInput<ToolTypes.ReportUsageRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ReportUsageResponse>>;
|
|
736
|
+
/** Execute the AdCP search_brands tool. */
|
|
737
|
+
searchBrands(params: CoreTypes.SearchBrandsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.SearchBrandsResponse>>;
|
|
738
|
+
/** List or synchronize buyer-managed account catalog feeds, suppress or restore specific items, and read current availability state. */
|
|
739
|
+
syncCatalogs(params: MutatingRequestInput<ToolTypes.SyncCatalogsRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.SyncCatalogsResponse>>;
|
|
740
|
+
/** List or synchronize account event sources with upsert and optional replacement semantics. */
|
|
741
|
+
syncEventSources(params: MutatingRequestInput<ToolTypes.SyncEventSourcesRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.SyncEventSourcesResponse>>;
|
|
742
|
+
/** Bind or replace the governance agent used for approval across specific advertiser accounts. */
|
|
743
|
+
syncGovernance(params: MutatingRequestInput<ToolTypes.SyncGovernanceRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.SyncGovernanceResponse>>;
|
|
744
|
+
/** Execute the AdCP sync_plans tool. */
|
|
745
|
+
syncPlans(params: MutatingRequestInput<ToolTypes.SyncPlansRequest>, inputHandler?: InputHandler, options?: TaskOptions & {
|
|
746
|
+
agent?: AgentConfig;
|
|
747
|
+
}): Promise<TaskResult<ToolTypes.SyncPlansResponse>>;
|
|
748
|
+
/** Record a consumer's independently verified reporting totals and destination evidence in the seller ledger. */
|
|
749
|
+
syncReportingReceipts(params: MutatingRequestInput<ToolTypes.SyncReportingReceiptsRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.SyncReportingReceiptsResponse>>;
|
|
750
|
+
/** Tell a seller whether expected reporting was received, omitted, missing, unreadable, or contradictory. */
|
|
751
|
+
syncReportingStatus(params: MutatingRequestInput<ToolTypes.SyncReportingStatusRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.SyncReportingStatusResponse>>;
|
|
752
|
+
/** Execute the AdCP update_collection_list tool. */
|
|
753
|
+
updateCollectionList(params: MutatingRequestInput<ToolTypes.UpdateCollectionListRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.UpdateCollectionListResponse>>;
|
|
754
|
+
/** Execute the AdCP update_content_standards tool. */
|
|
755
|
+
updateContentStandards(params: MutatingRequestInput<ToolTypes.UpdateContentStandardsRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.UpdateContentStandardsResponse>>;
|
|
756
|
+
/** Execute the AdCP update_rights tool. */
|
|
757
|
+
updateRights(params: MutatingRequestInput<CoreTypes.UpdateRightsRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.UpdateRightsResponse>>;
|
|
758
|
+
/** Execute the AdCP validate_content_delivery tool. */
|
|
759
|
+
validateContentDelivery(params: ToolTypes.ValidateContentDeliveryRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ValidateContentDeliveryResponse>>;
|
|
760
|
+
/** Preflight a creative manifest against canonical formats, products, third-party formats, or agent capabilities. */
|
|
761
|
+
validateInput(params: ToolTypes.ValidateInputRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ValidateInputResponse>>;
|
|
762
|
+
/** Execute the AdCP validate_property_delivery tool. */
|
|
763
|
+
validatePropertyDelivery(params: CoreTypes.ValidatePropertyDeliveryRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.ValidatePropertyDeliveryResponse>>;
|
|
764
|
+
/** Execute the AdCP verify_brand_claim tool. */
|
|
765
|
+
verifyBrandClaim(params: CoreTypes.VerifyBrandClaimRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.VerifyBrandClaimResponse>>;
|
|
766
|
+
/** Execute the AdCP verify_brand_claims tool. */
|
|
767
|
+
verifyBrandClaims(params: CoreTypes.VerifyBrandClaimsRequestBulk, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.VerifyBrandClaimsResponseBulk>>;
|
|
609
768
|
/**
|
|
610
769
|
* Create a property list
|
|
611
770
|
*/
|
|
@@ -822,7 +981,9 @@ export declare class AgentClient {
|
|
|
822
981
|
* const customResult = await agent.executeCustomTask<MyCustomResponse>('custom_task', params);
|
|
823
982
|
* ```
|
|
824
983
|
*/
|
|
825
|
-
executeTask<K extends AdcpTaskName>(taskName: K, params: TaskRequestFor<K>, inputHandler?: InputHandler, options?: TaskOptions
|
|
984
|
+
executeTask<K extends AdcpTaskName>(taskName: K, params: TaskRequestFor<K>, inputHandler?: InputHandler, options?: TaskOptions & {
|
|
985
|
+
agent?: K extends 'sync_plans' | 'get_plan_audit_logs' ? AgentConfig : never;
|
|
986
|
+
}): Promise<TaskResult<TaskResponseTypeMap[K]>>;
|
|
826
987
|
/** Execute an extension task that is not part of the standard AdCP task set. */
|
|
827
988
|
executeCustomTask<T = unknown>(taskName: string, params: Record<string, unknown>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<T>>;
|
|
828
989
|
/**
|
|
@@ -833,6 +994,9 @@ export declare class AgentClient {
|
|
|
833
994
|
/**
|
|
834
995
|
* List all tasks for this agent
|
|
835
996
|
*/
|
|
997
|
+
/** Query the seller's typed AdCP list_tasks tool. Pass {} for an unfiltered query. */
|
|
998
|
+
listTasks(params: ToolTypes.ListTasksRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ListTasksResponse>>;
|
|
999
|
+
/** List local tasks only. Pass {} to query the seller's list_tasks tool. */
|
|
836
1000
|
listTasks(): Promise<TaskInfo[]>;
|
|
837
1001
|
/**
|
|
838
1002
|
* Get detailed information about a specific task
|