@adcp/sdk 17.0.0-beta.21 → 17.0.0-beta.22
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/README.md +26 -2
- package/dist/lib/client/core.d.mts +4 -0
- package/dist/lib/client/core.d.ts +4 -0
- package/dist/lib/client/core.js +13 -0
- package/dist/lib/client/core.mjs +12 -0
- package/dist/lib/conformance/property-lists.d.mts +1 -1
- package/dist/lib/conformance/property-lists.d.ts +1 -1
- package/dist/lib/conformance/property-lists.js +1 -1
- package/dist/lib/conformance/property-lists.mjs +1 -1
- package/dist/lib/core/SingleAgentClient.d.mts +10 -1
- package/dist/lib/core/SingleAgentClient.d.ts +10 -1
- package/dist/lib/core/SingleAgentClient.js +56 -7
- package/dist/lib/core/SingleAgentClient.mjs +61 -7
- package/dist/lib/core/targeting-helpers.d.mts +123 -0
- package/dist/lib/core/targeting-helpers.d.ts +123 -0
- package/dist/lib/core/targeting-helpers.js +412 -0
- package/dist/lib/core/targeting-helpers.mjs +370 -0
- package/dist/lib/entrypoints/client-account-changes.d.mts +5 -0
- package/dist/lib/entrypoints/client-account-changes.d.ts +5 -0
- package/dist/lib/entrypoints/client-account-changes.js +28 -0
- package/dist/lib/entrypoints/client-account-changes.mjs +4 -0
- package/dist/lib/entrypoints/client-webhook-stores.d.mts +2 -0
- package/dist/lib/entrypoints/client-webhook-stores.d.ts +2 -0
- package/dist/lib/entrypoints/client-webhook-stores.js +37 -0
- package/dist/lib/entrypoints/client-webhook-stores.mjs +16 -0
- package/dist/lib/entrypoints/discovery.d.mts +9 -0
- package/dist/lib/entrypoints/discovery.d.ts +9 -0
- package/dist/lib/entrypoints/discovery.js +72 -0
- package/dist/lib/entrypoints/discovery.mjs +56 -0
- package/dist/lib/entrypoints/errors.d.mts +11 -0
- package/dist/lib/entrypoints/errors.d.ts +11 -0
- package/dist/lib/entrypoints/errors.js +159 -0
- package/dist/lib/entrypoints/errors.mjs +132 -0
- package/dist/lib/entrypoints/media-buy.d.mts +5 -0
- package/dist/lib/entrypoints/media-buy.d.ts +5 -0
- package/dist/lib/entrypoints/media-buy.js +119 -0
- package/dist/lib/entrypoints/media-buy.mjs +100 -0
- package/dist/lib/entrypoints/registry.d.mts +5 -0
- package/dist/lib/entrypoints/registry.d.ts +5 -0
- package/dist/lib/entrypoints/registry.js +61 -0
- package/dist/lib/entrypoints/registry.mjs +40 -0
- package/dist/lib/entrypoints/utils.d.mts +7 -0
- package/dist/lib/entrypoints/utils.d.ts +7 -0
- package/dist/lib/entrypoints/utils.js +100 -0
- package/dist/lib/entrypoints/utils.mjs +72 -0
- package/dist/lib/entrypoints/version.d.mts +3 -0
- package/dist/lib/entrypoints/version.d.ts +3 -0
- package/dist/lib/entrypoints/version.js +57 -0
- package/dist/lib/entrypoints/version.mjs +36 -0
- package/dist/lib/index.d.mts +1 -1
- package/dist/lib/index.d.ts +1 -1
- package/dist/lib/media-buy/action-contracts.js +3 -3
- package/dist/lib/media-buy/action-contracts.mjs +1 -1
- package/dist/lib/media-buy/creative-start-policy.d.mts +19 -0
- package/dist/lib/media-buy/creative-start-policy.d.ts +19 -0
- package/dist/lib/media-buy/creative-start-policy.js +59 -0
- package/dist/lib/media-buy/creative-start-policy.mjs +31 -0
- package/dist/lib/media-buy/valid-actions.d.mts +47 -0
- package/dist/lib/media-buy/valid-actions.d.ts +47 -0
- package/dist/lib/media-buy/valid-actions.js +42 -0
- package/dist/lib/media-buy/valid-actions.mjs +18 -0
- package/dist/lib/net/pin-and-bind-fetch.d.mts +121 -0
- package/dist/lib/net/pin-and-bind-fetch.d.ts +121 -0
- package/dist/lib/net/pin-and-bind-fetch.js +209 -0
- package/dist/lib/net/pin-and-bind-fetch.mjs +183 -0
- package/dist/lib/registry/types.generated.d.ts +18 -2
- package/dist/lib/reporting/ledger/index.d.mts +1 -0
- package/dist/lib/reporting/ledger/index.d.ts +1 -0
- package/dist/lib/reporting/ledger/index.js +3 -1
- package/dist/lib/reporting/ledger/index.mjs +1 -0
- package/dist/lib/reporting/ledger/instant.d.mts +5 -0
- package/dist/lib/reporting/ledger/instant.d.ts +5 -0
- package/dist/lib/reporting/ledger/instant.js +10 -0
- package/dist/lib/reporting/ledger/instant.mjs +9 -0
- package/dist/lib/reporting/ledger/issue-events.d.mts +333 -0
- package/dist/lib/reporting/ledger/issue-events.d.ts +333 -0
- package/dist/lib/reporting/ledger/issue-events.js +310 -0
- package/dist/lib/reporting/ledger/issue-events.mjs +282 -0
- package/dist/lib/reporting/service/index.d.mts +36 -1
- package/dist/lib/reporting/service/index.d.ts +36 -1
- package/dist/lib/reporting/service/index.js +51 -1
- package/dist/lib/reporting/service/index.mjs +52 -2
- package/dist/lib/reporting/service/scheduler-support.d.mts +1 -1
- package/dist/lib/reporting/service/scheduler-support.d.ts +1 -1
- package/dist/lib/reporting/service/scheduler-support.js +1 -1
- package/dist/lib/reporting/service/scheduler-support.mjs +1 -1
- package/dist/lib/server/capabilities-release-projection.d.mts +43 -0
- package/dist/lib/server/capabilities-release-projection.d.ts +43 -0
- package/dist/lib/server/capabilities-release-projection.js +128 -0
- package/dist/lib/server/capabilities-release-projection.mjs +112 -0
- package/dist/lib/server/create-adcp-server.d.mts +29 -5
- package/dist/lib/server/create-adcp-server.d.ts +29 -5
- package/dist/lib/server/create-adcp-server.js +95 -22
- package/dist/lib/server/create-adcp-server.mjs +106 -21
- package/dist/lib/server/decisioning/capabilities.d.mts +27 -0
- package/dist/lib/server/decisioning/capabilities.d.ts +27 -0
- package/dist/lib/server/decisioning/runtime/from-platform.js +99 -27
- package/dist/lib/server/decisioning/runtime/from-platform.mjs +103 -27
- package/dist/lib/server/declared-input-schema.d.mts +108 -0
- package/dist/lib/server/declared-input-schema.d.ts +108 -0
- package/dist/lib/server/declared-input-schema.js +167 -0
- package/dist/lib/server/declared-input-schema.mjs +137 -0
- package/dist/lib/server/envelope-allowlist.d.mts +1 -105
- package/dist/lib/server/envelope-allowlist.d.ts +1 -105
- package/dist/lib/server/envelope-allowlist.js +3 -79
- package/dist/lib/server/envelope-allowlist.mjs +1 -71
- package/dist/lib/server/errors.d.mts +1 -186
- package/dist/lib/server/errors.d.ts +1 -186
- package/dist/lib/server/errors.js +3 -98
- package/dist/lib/server/errors.mjs +1 -94
- package/dist/lib/server/index.d.mts +1 -1
- package/dist/lib/server/index.d.ts +1 -1
- package/dist/lib/server/mcp-modern-server.js +21 -4
- package/dist/lib/server/mcp-modern-server.mjs +21 -4
- package/dist/lib/server/media-buy-action-resolver.d.mts +7 -0
- package/dist/lib/server/media-buy-action-resolver.d.ts +7 -0
- package/dist/lib/server/media-buy-action-resolver.js +10 -1
- package/dist/lib/server/media-buy-action-resolver.mjs +10 -1
- package/dist/lib/server/media-buy-helpers.d.mts +1 -47
- package/dist/lib/server/media-buy-helpers.d.ts +1 -47
- package/dist/lib/server/media-buy-helpers.js +3 -23
- package/dist/lib/server/media-buy-helpers.mjs +1 -18
- package/dist/lib/server/pick-safe-details.d.mts +1 -89
- package/dist/lib/server/pick-safe-details.d.ts +1 -89
- package/dist/lib/server/pick-safe-details.js +3 -61
- package/dist/lib/server/pick-safe-details.mjs +1 -56
- package/dist/lib/server/pin-and-bind-fetch.d.mts +1 -121
- package/dist/lib/server/pin-and-bind-fetch.d.ts +1 -121
- package/dist/lib/server/pin-and-bind-fetch.js +3 -190
- package/dist/lib/server/pin-and-bind-fetch.mjs +1 -183
- package/dist/lib/server/targeting-helpers.d.mts +1 -123
- package/dist/lib/server/targeting-helpers.d.ts +1 -123
- package/dist/lib/server/targeting-helpers.js +3 -393
- package/dist/lib/server/targeting-helpers.mjs +1 -370
- package/dist/lib/server/test-controller.js +7 -3
- package/dist/lib/server/test-controller.mjs +7 -3
- package/dist/lib/storage/memory-ledger.js +219 -1
- package/dist/lib/storage/memory-ledger.mjs +223 -1
- package/dist/lib/testing/compliance/storyboard-tracks.js +0 -4
- package/dist/lib/testing/compliance/storyboard-tracks.mjs +0 -4
- package/dist/lib/testing/comply-controller.js +7 -2
- package/dist/lib/testing/comply-controller.mjs +7 -2
- package/dist/lib/testing/storyboard/request-signing/grader.d.mts +21 -0
- package/dist/lib/testing/storyboard/request-signing/grader.d.ts +21 -0
- package/dist/lib/testing/storyboard/request-signing/grader.js +31 -0
- package/dist/lib/testing/storyboard/request-signing/grader.mjs +30 -0
- package/dist/lib/testing/storyboard/request-signing/probe-dispatch.js +1 -1
- package/dist/lib/testing/storyboard/request-signing/probe-dispatch.mjs +2 -1
- package/dist/lib/testing/storyboard/request-signing/types.d.mts +12 -0
- package/dist/lib/testing/storyboard/request-signing/types.d.ts +12 -0
- package/dist/lib/testing/storyboard/request-signing/vector-loader.js +7 -2
- package/dist/lib/testing/storyboard/request-signing/vector-loader.mjs +7 -2
- package/dist/lib/testing/storyboard/runner.js +2 -2
- package/dist/lib/testing/storyboard/runner.mjs +2 -2
- package/dist/lib/testing/storyboard/validations.d.mts +1 -1
- package/dist/lib/testing/storyboard/validations.d.ts +1 -1
- package/dist/lib/utils/adcp-error-response.d.mts +196 -0
- package/dist/lib/utils/adcp-error-response.d.ts +196 -0
- package/dist/lib/utils/adcp-error-response.js +118 -0
- package/dist/lib/utils/adcp-error-response.mjs +95 -0
- package/dist/lib/utils/buyer-retry-policy.js +2 -2
- package/dist/lib/utils/buyer-retry-policy.mjs +1 -1
- package/dist/lib/utils/capabilities.d.mts +6 -0
- package/dist/lib/utils/capabilities.d.ts +6 -0
- package/dist/lib/utils/capabilities.js +6 -2
- package/dist/lib/utils/capabilities.mjs +6 -2
- package/dist/lib/utils/envelope-allowlist.d.mts +105 -0
- package/dist/lib/utils/envelope-allowlist.d.ts +105 -0
- package/dist/lib/utils/envelope-allowlist.js +98 -0
- package/dist/lib/utils/envelope-allowlist.mjs +71 -0
- package/dist/lib/utils/pick-safe-details.d.mts +89 -0
- package/dist/lib/utils/pick-safe-details.d.ts +89 -0
- package/dist/lib/utils/pick-safe-details.js +80 -0
- package/dist/lib/utils/pick-safe-details.mjs +56 -0
- package/dist/lib/v2/projection/augment-response.d.mts +4 -0
- package/dist/lib/v2/projection/augment-response.d.ts +4 -0
- package/dist/lib/v2/projection/creative-delivery.d.mts +20 -3
- package/dist/lib/v2/projection/creative-delivery.d.ts +20 -3
- package/dist/lib/v2/projection/creative-delivery.js +20 -4
- package/dist/lib/v2/projection/creative-delivery.mjs +19 -4
- package/dist/lib/v2/projection/index.d.mts +2 -2
- package/dist/lib/v2/projection/index.d.ts +2 -2
- package/dist/lib/v2/projection/index.js +4 -0
- package/dist/lib/v2/projection/index.mjs +5 -1
- package/dist/lib/v2/projection/legacy-metadata.d.mts +7 -0
- package/dist/lib/v2/projection/legacy-metadata.d.ts +7 -0
- package/dist/lib/v2/projection/legacy-metadata.js +14 -0
- package/dist/lib/v2/projection/legacy-metadata.mjs +12 -0
- package/dist/lib/v2/projection/legacy-routes.d.mts +11 -0
- package/dist/lib/v2/projection/legacy-routes.d.ts +11 -0
- package/dist/lib/v2/projection/legacy-routes.js +2 -1
- package/dist/lib/v2/projection/legacy-routes.mjs +7 -2
- package/dist/lib/v2/projection/v1-to-v2.d.mts +21 -1
- package/dist/lib/v2/projection/v1-to-v2.d.ts +21 -1
- package/dist/lib/v2/projection/v1-to-v2.js +18 -11
- package/dist/lib/v2/projection/v1-to-v2.mjs +19 -11
- 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/docs/TYPE-SUMMARY.md +2 -2
- package/docs/guides/CREATIVE-DELIVERY.md +12 -0
- package/docs/guides/REPORTING-LEDGER.md +121 -0
- package/docs/guides/VALIDATE-YOUR-AGENT.md +1 -0
- package/docs/llms.txt +2 -2
- package/docs/migration-14.x-rc-worksheet.md +4 -4
- package/docs/migration-16-to-17.md +149 -0
- package/docs/migration-reporting-storage-package.md +10 -0
- package/package.json +106 -1
|
@@ -34,6 +34,7 @@ var import_adcp_version_config = require('../utils/adcp-version-config.js');
|
|
|
34
34
|
var import_web_bot_auth = require('../signing/web-bot-auth.js');
|
|
35
35
|
var import_version = require('../adapters/version/index.js');
|
|
36
36
|
var import_schema_loader = require('../validation/schema-loader.js');
|
|
37
|
+
var import_capabilities_release_projection = require('./capabilities-release-projection.js');
|
|
37
38
|
var import_lifecycle = require('../identity-3.3/lifecycle.js');
|
|
38
39
|
var import_server = require('../identity-3.3/server.js');
|
|
39
40
|
var import_web_bot_auth2 = require('../signing/web-bot-auth.js');
|
|
@@ -43,6 +44,7 @@ var import_zod = require("zod");
|
|
|
43
44
|
var import_version2 = require('../version.js');
|
|
44
45
|
var import_adcp_version_config2 = require('../utils/adcp-version-config.js');
|
|
45
46
|
var import_reporting_subscription_release = require('./reporting-subscription-release.js');
|
|
47
|
+
var import_creative_start_policy = require('../media-buy/creative-start-policy.js');
|
|
46
48
|
var import_errors = require('../errors/index.js');
|
|
47
49
|
var import_schema_loader2 = require('../validation/schema-loader.js');
|
|
48
50
|
var import_schemas = require('../schemas/index.js');
|
|
@@ -52,6 +54,7 @@ var import_error_arm_tools = require('./error-arm-tools.js');
|
|
|
52
54
|
var import_structured_content_fallback = require('./structured-content-fallback.js');
|
|
53
55
|
var import_adcp_server = require('./adcp-server.js');
|
|
54
56
|
var import_mcp_app = require('./mcp-app.js');
|
|
57
|
+
var import_declared_input_schema = require('./declared-input-schema.js');
|
|
55
58
|
var import_tasks = require('./tasks.js');
|
|
56
59
|
var import_errors2 = require('./errors.js');
|
|
57
60
|
var import_task_registry = require('./decisioning/runtime/task-registry.js');
|
|
@@ -165,6 +168,8 @@ function applyCapabilityOverrides(target, overrides) {
|
|
|
165
168
|
"compliance_testing",
|
|
166
169
|
"webhook_signing",
|
|
167
170
|
"identity",
|
|
171
|
+
"wholesale_feed_versioning",
|
|
172
|
+
"wholesale_feed_webhooks",
|
|
168
173
|
"request_signing"
|
|
169
174
|
]);
|
|
170
175
|
for (const [key, value] of Object.entries(overrides)) {
|
|
@@ -575,7 +580,6 @@ const RO = { readOnlyHint: true };
|
|
|
575
580
|
const MUT = { readOnlyHint: false, destructiveHint: false };
|
|
576
581
|
const DEST = { readOnlyHint: false, destructiveHint: true };
|
|
577
582
|
const IDEMP = { readOnlyHint: false, idempotentHint: true };
|
|
578
|
-
const PASSTHROUGH_INPUT_SCHEMA = import_zod.z.object({}).passthrough();
|
|
579
583
|
let cachedToolInputShapes;
|
|
580
584
|
const SHALLOW_HINT_FIELD_SCHEMA = import_zod.z.unknown().optional();
|
|
581
585
|
const SHALLOW_HINT_SCHEMAS = /* @__PURE__ */ new Map();
|
|
@@ -2104,7 +2108,7 @@ function createAdcpServer(config) {
|
|
|
2104
2108
|
"createAdcpServer: governance.resolveReportPlanAdjustmentScope is required to authorize report_plan_adjustment"
|
|
2105
2109
|
);
|
|
2106
2110
|
}
|
|
2107
|
-
const frameworkInputSchemaFor = (toolName) => config.exposeToolSchemas === true ? shallowToolInputHintSchema(toolName) ?? PASSTHROUGH_INPUT_SCHEMA : PASSTHROUGH_INPUT_SCHEMA;
|
|
2111
|
+
const frameworkInputSchemaFor = (toolName) => config.exposeToolSchemas === true ? shallowToolInputHintSchema(toolName) ?? import_declared_input_schema.PASSTHROUGH_INPUT_SCHEMA : import_declared_input_schema.PASSTHROUGH_INPUT_SCHEMA;
|
|
2108
2112
|
const mcpAppResources = (0, import_mcp_app.normalizeMcpAppResources)(config.resources);
|
|
2109
2113
|
const mcpAppResourceUris = new Set(mcpAppResources.map((resource) => resource.uri));
|
|
2110
2114
|
for (const [toolName, tool] of Object.entries(config.customTools ?? {})) {
|
|
@@ -2127,6 +2131,7 @@ function createAdcpServer(config) {
|
|
|
2127
2131
|
const adcpVersion = (0, import_adcp_version_config2.resolveAdcpVersion)(
|
|
2128
2132
|
configuredAdcpVersion ?? (config.identity33 ? "3.3" : config.proposalNegotiation ? import_version3.ADCP_VERSION : void 0)
|
|
2129
2133
|
);
|
|
2134
|
+
const handlerRunsAdcp33 = (0, import_adcp_version_config2.isAdcpVersionAtLeast)(adcpVersion, "3.3.0-beta.0");
|
|
2130
2135
|
const toolVersionRanges = parseToolVersionRanges(config.toolVersions);
|
|
2131
2136
|
const toolAvailableForRelease = (toolName, release) => toolIsAvailableInRelease(toolVersionRanges, toolName, release);
|
|
2132
2137
|
const movingSupportedVersion = capConfig?.supported_versions?.find(import_adcp_version_config2.isMovingAdcpPrereleaseFamilyAlias);
|
|
@@ -2374,6 +2379,26 @@ function createAdcpServer(config) {
|
|
|
2374
2379
|
taskMessageQueue,
|
|
2375
2380
|
instructions: resolvedInstructions
|
|
2376
2381
|
});
|
|
2382
|
+
const defaultErrorRelease = {
|
|
2383
|
+
validationVersion: selectedDefault.validationVersion,
|
|
2384
|
+
...servedAdcpVersion !== void 0 && { wireVersion: servedAdcpVersion }
|
|
2385
|
+
};
|
|
2386
|
+
const finishFrameworkRejection = (toolName, response, rejection, release) => {
|
|
2387
|
+
let served = release;
|
|
2388
|
+
if (served === void 0) {
|
|
2389
|
+
const releaseArgs = isPlainObject(rejection.releaseArgs) ? rejection.releaseArgs : {};
|
|
2390
|
+
const selected = selectServedAdcpRelease(releaseArgs, capConfig, adcpVersion, defaultAdcpVersion);
|
|
2391
|
+
served = isMcpToolResponse(selected) ? defaultErrorRelease : selected;
|
|
2392
|
+
}
|
|
2393
|
+
injectEnvelopeStatusIntoResponse(response, toolName, served.validationVersion);
|
|
2394
|
+
injectContextIntoResponse(response, rejection.context);
|
|
2395
|
+
injectVersionIntoResponse(response, served.wireVersion);
|
|
2396
|
+
return response;
|
|
2397
|
+
};
|
|
2398
|
+
(0, import_declared_input_schema.configureDeclaredInputErrors)(server, {
|
|
2399
|
+
exposeSchemaPath: exposeErrorDetails,
|
|
2400
|
+
finalize: (toolName, response, rejection) => finishFrameworkRejection(toolName, response, rejection)
|
|
2401
|
+
});
|
|
2377
2402
|
for (const resource of mcpAppResources) {
|
|
2378
2403
|
(0, import_mcp_app.registerMcpAppResource)(server, resource, (async (uri, extra) => (0, import_mcp_app.readMcpAppResource)(resource, uri, {
|
|
2379
2404
|
signal: extra.signal
|
|
@@ -3414,6 +3439,17 @@ function createAdcpServer(config) {
|
|
|
3414
3439
|
);
|
|
3415
3440
|
}
|
|
3416
3441
|
}
|
|
3442
|
+
if (toolName === "control_media_buy" && handlerRunsAdcp33) {
|
|
3443
|
+
const optedIn = (0, import_creative_start_policy.creativeStartPolicyOptInFields)(params);
|
|
3444
|
+
if (optedIn.length > 0 && !(0, import_creative_start_policy.declaresCreativeStartPolicy)(capabilitiesData)) {
|
|
3445
|
+
return finalize(
|
|
3446
|
+
(0, import_errors2.adcpError)("UNSUPPORTED_FEATURE", {
|
|
3447
|
+
...(0, import_creative_start_policy.undeclaredCreativeStartPolicyRefusal)(optedIn),
|
|
3448
|
+
mutation_outcome: "not_applied"
|
|
3449
|
+
})
|
|
3450
|
+
);
|
|
3451
|
+
}
|
|
3452
|
+
}
|
|
3417
3453
|
if ((requestIsStateChanging || requestUsesOptionalIdempotency) && hasIdempotencyKeyField && (typeof params.idempotency_key !== "string" || !import_idempotency.IDEMPOTENCY_KEY_PATTERN.test(params.idempotency_key))) {
|
|
3418
3454
|
return finalize(
|
|
3419
3455
|
(0, import_errors2.adcpError)("INVALID_REQUEST", {
|
|
@@ -4574,13 +4610,30 @@ function createAdcpServer(config) {
|
|
|
4574
4610
|
);
|
|
4575
4611
|
};
|
|
4576
4612
|
const wrappedHandler = (async (...args) => {
|
|
4577
|
-
const
|
|
4578
|
-
|
|
4579
|
-
|
|
4613
|
+
const extraIndex = Math.max(0, args.length - 1);
|
|
4614
|
+
const callerContext = isPlainObject(args[0]) ? args[0].context : void 0;
|
|
4615
|
+
let input = args[0];
|
|
4616
|
+
if (inputSchema != null) {
|
|
4617
|
+
const parsed = await (0, import_declared_input_schema.parseDeclaredToolInput)(server, customName, args[0]);
|
|
4618
|
+
if (!parsed.success) return finalizeCustomResponse(parsed.response);
|
|
4619
|
+
input = parsed.data;
|
|
4620
|
+
}
|
|
4621
|
+
const params = isPlainObject(input) ? input : {};
|
|
4622
|
+
const reject = (response, release) => finalizeCustomResponse(
|
|
4623
|
+
finishFrameworkRejection(
|
|
4624
|
+
customName,
|
|
4625
|
+
response,
|
|
4626
|
+
{ context: callerContext, releaseArgs: params },
|
|
4627
|
+
release ?? defaultErrorRelease
|
|
4628
|
+
),
|
|
4629
|
+
release
|
|
4630
|
+
);
|
|
4631
|
+
const identityError = await authorizeAuxiliaryIdentityTool(customName, input, args[extraIndex]);
|
|
4632
|
+
if (identityError) return reject(identityError);
|
|
4580
4633
|
const selectedRelease = selectServedAdcpRelease(params, capConfig, adcpVersion, defaultAdcpVersion);
|
|
4581
|
-
if (isMcpToolResponse(selectedRelease)) return
|
|
4634
|
+
if (isMcpToolResponse(selectedRelease)) return reject(selectedRelease);
|
|
4582
4635
|
if (!toolAvailableForRelease(customName, selectedRelease.validationVersion)) {
|
|
4583
|
-
return
|
|
4636
|
+
return reject(
|
|
4584
4637
|
(0, import_errors2.adcpError)("VERSION_UNSUPPORTED", {
|
|
4585
4638
|
message: `${customName} is not available in the selected AdCP release ${selectedRelease.validationVersion}.`,
|
|
4586
4639
|
details: {
|
|
@@ -4591,7 +4644,6 @@ function createAdcpServer(config) {
|
|
|
4591
4644
|
);
|
|
4592
4645
|
}
|
|
4593
4646
|
try {
|
|
4594
|
-
const extraIndex = Math.max(0, args.length - 1);
|
|
4595
4647
|
const rawExtra = args[extraIndex];
|
|
4596
4648
|
const versionedExtra = withImmutableServedAdcpVersion(
|
|
4597
4649
|
{ ...rawExtra ?? {} },
|
|
@@ -4599,11 +4651,13 @@ function createAdcpServer(config) {
|
|
|
4599
4651
|
);
|
|
4600
4652
|
const versionedArgs = [...args];
|
|
4601
4653
|
versionedArgs[extraIndex] = versionedExtra;
|
|
4654
|
+
if (inputSchema != null) versionedArgs[0] = input;
|
|
4602
4655
|
const response = await rawHandler(...versionedArgs);
|
|
4656
|
+
if (response?.isError === true) injectContextIntoResponse(response, callerContext);
|
|
4603
4657
|
return finalizeCustomResponse(response, selectedRelease);
|
|
4604
4658
|
} catch (err) {
|
|
4605
|
-
if (isThrownAdcpError(err)) return
|
|
4606
|
-
if (err instanceof import_async_outcome.AdcpError) return
|
|
4659
|
+
if (isThrownAdcpError(err)) return reject(err, selectedRelease);
|
|
4660
|
+
if (err instanceof import_async_outcome.AdcpError) return reject(projectThrownAdcpError(err), selectedRelease);
|
|
4607
4661
|
throw err;
|
|
4608
4662
|
}
|
|
4609
4663
|
});
|
|
@@ -4615,16 +4669,13 @@ function createAdcpServer(config) {
|
|
|
4615
4669
|
...annotations != null && { annotations },
|
|
4616
4670
|
..._meta != null && { _meta }
|
|
4617
4671
|
};
|
|
4618
|
-
|
|
4619
|
-
|
|
4620
|
-
|
|
4621
|
-
|
|
4622
|
-
|
|
4623
|
-
|
|
4624
|
-
|
|
4625
|
-
} else {
|
|
4626
|
-
server.registerTool(customName, customToolConfig, wrappedHandler);
|
|
4627
|
-
}
|
|
4672
|
+
const registered = (0, import_mcp_app.isMcpAppToolMeta)(_meta) ? (0, import_mcp_app.registerMcpAppTool)(
|
|
4673
|
+
server,
|
|
4674
|
+
customName,
|
|
4675
|
+
customToolConfig,
|
|
4676
|
+
wrappedHandler
|
|
4677
|
+
) : server.registerTool(customName, customToolConfig, wrappedHandler);
|
|
4678
|
+
(0, import_declared_input_schema.validateToolInputAtAdcpLayer)(server, customName, registered);
|
|
4628
4679
|
registeredToolNames.add(customName);
|
|
4629
4680
|
}
|
|
4630
4681
|
}
|
|
@@ -4691,7 +4742,10 @@ function createAdcpServer(config) {
|
|
|
4691
4742
|
property_list_filtering: capConfig?.features?.propertyListFiltering ?? false,
|
|
4692
4743
|
content_standards: capConfig?.features?.contentStandards ?? false,
|
|
4693
4744
|
conversion_tracking: capConfig?.features?.conversionTracking ?? false,
|
|
4694
|
-
audience_targeting: capConfig?.features?.audienceTargeting ?? false
|
|
4745
|
+
audience_targeting: capConfig?.features?.audienceTargeting ?? false,
|
|
4746
|
+
...capConfig?.features?.creativeStartPolicy !== void 0 && {
|
|
4747
|
+
creative_start_policy: capConfig.features.creativeStartPolicy
|
|
4748
|
+
}
|
|
4695
4749
|
},
|
|
4696
4750
|
...capConfig?.portfolio && { portfolio: capConfig.portfolio }
|
|
4697
4751
|
};
|
|
@@ -5006,9 +5060,28 @@ function createAdcpServer(config) {
|
|
|
5006
5060
|
if (selected !== void 0 && (selected.major > 3 || selected.major === 3 && selected.minor >= 2) && data.request_signing?.supported === true) {
|
|
5007
5061
|
data.request_signing = { ...data.request_signing, covers_content_digest: "required" };
|
|
5008
5062
|
}
|
|
5009
|
-
|
|
5063
|
+
const servesAdcp30 = selected?.major === 3 && selected.minor === 0;
|
|
5064
|
+
if (servesAdcp30) {
|
|
5010
5065
|
data = projectCapabilitiesToVersion(data, release.validationVersion);
|
|
5011
5066
|
}
|
|
5067
|
+
if ((0, import_version.translationSteps)(adcpVersion, release.validationVersion).length > 0) {
|
|
5068
|
+
const options = { fromVersion: adcpVersion, toVersion: release.validationVersion };
|
|
5069
|
+
const projected = servesAdcp30 ? (0, import_capabilities_release_projection.projectExperimentalFeaturesForRelease)(data, options) : (0, import_capabilities_release_projection.projectCapabilitiesForRelease)(data, options);
|
|
5070
|
+
data = projected.data;
|
|
5071
|
+
if (projected.drifts.length > 0) {
|
|
5072
|
+
logger.info(`Converted get_adcp_capabilities response down to AdCP ${release.validationVersion}`, {
|
|
5073
|
+
tool: "get_adcp_capabilities",
|
|
5074
|
+
drifts: projected.drifts
|
|
5075
|
+
});
|
|
5076
|
+
reportVersionTranslation({
|
|
5077
|
+
tool: "get_adcp_capabilities",
|
|
5078
|
+
direction: "response",
|
|
5079
|
+
fromVersion: adcpVersion,
|
|
5080
|
+
toVersion: release.validationVersion,
|
|
5081
|
+
drifts: projected.drifts
|
|
5082
|
+
});
|
|
5083
|
+
}
|
|
5084
|
+
}
|
|
5012
5085
|
if (selected !== void 0 && (selected.major < 3 || selected.major === 3 && selected.minor === 1)) {
|
|
5013
5086
|
if (data.webhook_signing) {
|
|
5014
5087
|
delete data.webhook_signing.delivery_retry_horizon_seconds;
|
|
@@ -11,6 +11,10 @@ import {
|
|
|
11
11
|
withIdentity33SchemaScope,
|
|
12
12
|
bindIdentity33SchemaScope
|
|
13
13
|
} from "../validation/schema-loader.mjs";
|
|
14
|
+
import {
|
|
15
|
+
projectCapabilitiesForRelease,
|
|
16
|
+
projectExperimentalFeaturesForRelease
|
|
17
|
+
} from "./capabilities-release-projection.mjs";
|
|
14
18
|
import { validateAgentOnboarding } from "../identity-3.3/lifecycle.mjs";
|
|
15
19
|
import { isIdentity33UnboundContext } from "../identity-3.3/server.mjs";
|
|
16
20
|
import {
|
|
@@ -43,6 +47,11 @@ import {
|
|
|
43
47
|
resolveAdcpVersion
|
|
44
48
|
} from "../utils/adcp-version-config.mjs";
|
|
45
49
|
import { reportingSubscriptionReleaseFieldsV1 } from "./reporting-subscription-release.mjs";
|
|
50
|
+
import {
|
|
51
|
+
creativeStartPolicyOptInFields,
|
|
52
|
+
declaresCreativeStartPolicy,
|
|
53
|
+
undeclaredCreativeStartPolicyRefusal
|
|
54
|
+
} from "../media-buy/creative-start-policy.mjs";
|
|
46
55
|
import { ConfigurationError } from "../errors/index.mjs";
|
|
47
56
|
import {
|
|
48
57
|
getValidator,
|
|
@@ -76,6 +85,12 @@ import {
|
|
|
76
85
|
registerMcpAppResource,
|
|
77
86
|
registerMcpAppTool
|
|
78
87
|
} from "./mcp-app.mjs";
|
|
88
|
+
import {
|
|
89
|
+
PASSTHROUGH_INPUT_SCHEMA,
|
|
90
|
+
configureDeclaredInputErrors,
|
|
91
|
+
parseDeclaredToolInput,
|
|
92
|
+
validateToolInputAtAdcpLayer
|
|
93
|
+
} from "./declared-input-schema.mjs";
|
|
79
94
|
import { ADCP_TASK_MESSAGE_QUEUE, createTaskCapableServer, InMemoryTaskStore } from "./tasks.mjs";
|
|
80
95
|
import { adcpError, applyAdcpErrorAllowlist, sanitizeStructuredAdcpError } from "./errors.mjs";
|
|
81
96
|
import {
|
|
@@ -268,6 +283,8 @@ function applyCapabilityOverrides(target, overrides) {
|
|
|
268
283
|
"compliance_testing",
|
|
269
284
|
"webhook_signing",
|
|
270
285
|
"identity",
|
|
286
|
+
"wholesale_feed_versioning",
|
|
287
|
+
"wholesale_feed_webhooks",
|
|
271
288
|
"request_signing"
|
|
272
289
|
]);
|
|
273
290
|
for (const [key, value] of Object.entries(overrides)) {
|
|
@@ -678,7 +695,6 @@ const RO = { readOnlyHint: true };
|
|
|
678
695
|
const MUT = { readOnlyHint: false, destructiveHint: false };
|
|
679
696
|
const DEST = { readOnlyHint: false, destructiveHint: true };
|
|
680
697
|
const IDEMP = { readOnlyHint: false, idempotentHint: true };
|
|
681
|
-
const PASSTHROUGH_INPUT_SCHEMA = z.object({}).passthrough();
|
|
682
698
|
let cachedToolInputShapes;
|
|
683
699
|
const SHALLOW_HINT_FIELD_SCHEMA = z.unknown().optional();
|
|
684
700
|
const SHALLOW_HINT_SCHEMAS = /* @__PURE__ */ new Map();
|
|
@@ -2230,6 +2246,7 @@ function createAdcpServer(config) {
|
|
|
2230
2246
|
const adcpVersion = resolveAdcpVersion(
|
|
2231
2247
|
configuredAdcpVersion ?? (config.identity33 ? "3.3" : config.proposalNegotiation ? ADCP_VERSION : void 0)
|
|
2232
2248
|
);
|
|
2249
|
+
const handlerRunsAdcp33 = isAdcpVersionAtLeast(adcpVersion, "3.3.0-beta.0");
|
|
2233
2250
|
const toolVersionRanges = parseToolVersionRanges(config.toolVersions);
|
|
2234
2251
|
const toolAvailableForRelease = (toolName, release) => toolIsAvailableInRelease(toolVersionRanges, toolName, release);
|
|
2235
2252
|
const movingSupportedVersion = capConfig?.supported_versions?.find(isMovingAdcpPrereleaseFamilyAlias);
|
|
@@ -2477,6 +2494,26 @@ function createAdcpServer(config) {
|
|
|
2477
2494
|
taskMessageQueue,
|
|
2478
2495
|
instructions: resolvedInstructions
|
|
2479
2496
|
});
|
|
2497
|
+
const defaultErrorRelease = {
|
|
2498
|
+
validationVersion: selectedDefault.validationVersion,
|
|
2499
|
+
...servedAdcpVersion !== void 0 && { wireVersion: servedAdcpVersion }
|
|
2500
|
+
};
|
|
2501
|
+
const finishFrameworkRejection = (toolName, response, rejection, release) => {
|
|
2502
|
+
let served = release;
|
|
2503
|
+
if (served === void 0) {
|
|
2504
|
+
const releaseArgs = isPlainObject(rejection.releaseArgs) ? rejection.releaseArgs : {};
|
|
2505
|
+
const selected = selectServedAdcpRelease(releaseArgs, capConfig, adcpVersion, defaultAdcpVersion);
|
|
2506
|
+
served = isMcpToolResponse(selected) ? defaultErrorRelease : selected;
|
|
2507
|
+
}
|
|
2508
|
+
injectEnvelopeStatusIntoResponse(response, toolName, served.validationVersion);
|
|
2509
|
+
injectContextIntoResponse(response, rejection.context);
|
|
2510
|
+
injectVersionIntoResponse(response, served.wireVersion);
|
|
2511
|
+
return response;
|
|
2512
|
+
};
|
|
2513
|
+
configureDeclaredInputErrors(server, {
|
|
2514
|
+
exposeSchemaPath: exposeErrorDetails,
|
|
2515
|
+
finalize: (toolName, response, rejection) => finishFrameworkRejection(toolName, response, rejection)
|
|
2516
|
+
});
|
|
2480
2517
|
for (const resource of mcpAppResources) {
|
|
2481
2518
|
registerMcpAppResource(server, resource, (async (uri, extra) => readMcpAppResource(resource, uri, {
|
|
2482
2519
|
signal: extra.signal
|
|
@@ -3517,6 +3554,17 @@ function createAdcpServer(config) {
|
|
|
3517
3554
|
);
|
|
3518
3555
|
}
|
|
3519
3556
|
}
|
|
3557
|
+
if (toolName === "control_media_buy" && handlerRunsAdcp33) {
|
|
3558
|
+
const optedIn = creativeStartPolicyOptInFields(params);
|
|
3559
|
+
if (optedIn.length > 0 && !declaresCreativeStartPolicy(capabilitiesData)) {
|
|
3560
|
+
return finalize(
|
|
3561
|
+
adcpError("UNSUPPORTED_FEATURE", {
|
|
3562
|
+
...undeclaredCreativeStartPolicyRefusal(optedIn),
|
|
3563
|
+
mutation_outcome: "not_applied"
|
|
3564
|
+
})
|
|
3565
|
+
);
|
|
3566
|
+
}
|
|
3567
|
+
}
|
|
3520
3568
|
if ((requestIsStateChanging || requestUsesOptionalIdempotency) && hasIdempotencyKeyField && (typeof params.idempotency_key !== "string" || !IDEMPOTENCY_KEY_PATTERN.test(params.idempotency_key))) {
|
|
3521
3569
|
return finalize(
|
|
3522
3570
|
adcpError("INVALID_REQUEST", {
|
|
@@ -4677,13 +4725,30 @@ function createAdcpServer(config) {
|
|
|
4677
4725
|
);
|
|
4678
4726
|
};
|
|
4679
4727
|
const wrappedHandler = (async (...args) => {
|
|
4680
|
-
const
|
|
4681
|
-
|
|
4682
|
-
|
|
4728
|
+
const extraIndex = Math.max(0, args.length - 1);
|
|
4729
|
+
const callerContext = isPlainObject(args[0]) ? args[0].context : void 0;
|
|
4730
|
+
let input = args[0];
|
|
4731
|
+
if (inputSchema != null) {
|
|
4732
|
+
const parsed = await parseDeclaredToolInput(server, customName, args[0]);
|
|
4733
|
+
if (!parsed.success) return finalizeCustomResponse(parsed.response);
|
|
4734
|
+
input = parsed.data;
|
|
4735
|
+
}
|
|
4736
|
+
const params = isPlainObject(input) ? input : {};
|
|
4737
|
+
const reject = (response, release) => finalizeCustomResponse(
|
|
4738
|
+
finishFrameworkRejection(
|
|
4739
|
+
customName,
|
|
4740
|
+
response,
|
|
4741
|
+
{ context: callerContext, releaseArgs: params },
|
|
4742
|
+
release ?? defaultErrorRelease
|
|
4743
|
+
),
|
|
4744
|
+
release
|
|
4745
|
+
);
|
|
4746
|
+
const identityError = await authorizeAuxiliaryIdentityTool(customName, input, args[extraIndex]);
|
|
4747
|
+
if (identityError) return reject(identityError);
|
|
4683
4748
|
const selectedRelease = selectServedAdcpRelease(params, capConfig, adcpVersion, defaultAdcpVersion);
|
|
4684
|
-
if (isMcpToolResponse(selectedRelease)) return
|
|
4749
|
+
if (isMcpToolResponse(selectedRelease)) return reject(selectedRelease);
|
|
4685
4750
|
if (!toolAvailableForRelease(customName, selectedRelease.validationVersion)) {
|
|
4686
|
-
return
|
|
4751
|
+
return reject(
|
|
4687
4752
|
adcpError("VERSION_UNSUPPORTED", {
|
|
4688
4753
|
message: `${customName} is not available in the selected AdCP release ${selectedRelease.validationVersion}.`,
|
|
4689
4754
|
details: {
|
|
@@ -4694,7 +4759,6 @@ function createAdcpServer(config) {
|
|
|
4694
4759
|
);
|
|
4695
4760
|
}
|
|
4696
4761
|
try {
|
|
4697
|
-
const extraIndex = Math.max(0, args.length - 1);
|
|
4698
4762
|
const rawExtra = args[extraIndex];
|
|
4699
4763
|
const versionedExtra = withImmutableServedAdcpVersion(
|
|
4700
4764
|
{ ...rawExtra ?? {} },
|
|
@@ -4702,11 +4766,13 @@ function createAdcpServer(config) {
|
|
|
4702
4766
|
);
|
|
4703
4767
|
const versionedArgs = [...args];
|
|
4704
4768
|
versionedArgs[extraIndex] = versionedExtra;
|
|
4769
|
+
if (inputSchema != null) versionedArgs[0] = input;
|
|
4705
4770
|
const response = await rawHandler(...versionedArgs);
|
|
4771
|
+
if (response?.isError === true) injectContextIntoResponse(response, callerContext);
|
|
4706
4772
|
return finalizeCustomResponse(response, selectedRelease);
|
|
4707
4773
|
} catch (err) {
|
|
4708
|
-
if (isThrownAdcpError(err)) return
|
|
4709
|
-
if (err instanceof AdcpError) return
|
|
4774
|
+
if (isThrownAdcpError(err)) return reject(err, selectedRelease);
|
|
4775
|
+
if (err instanceof AdcpError) return reject(projectThrownAdcpError(err), selectedRelease);
|
|
4710
4776
|
throw err;
|
|
4711
4777
|
}
|
|
4712
4778
|
});
|
|
@@ -4718,16 +4784,13 @@ function createAdcpServer(config) {
|
|
|
4718
4784
|
...annotations != null && { annotations },
|
|
4719
4785
|
..._meta != null && { _meta }
|
|
4720
4786
|
};
|
|
4721
|
-
|
|
4722
|
-
|
|
4723
|
-
|
|
4724
|
-
|
|
4725
|
-
|
|
4726
|
-
|
|
4727
|
-
|
|
4728
|
-
} else {
|
|
4729
|
-
server.registerTool(customName, customToolConfig, wrappedHandler);
|
|
4730
|
-
}
|
|
4787
|
+
const registered = isMcpAppToolMeta(_meta) ? registerMcpAppTool(
|
|
4788
|
+
server,
|
|
4789
|
+
customName,
|
|
4790
|
+
customToolConfig,
|
|
4791
|
+
wrappedHandler
|
|
4792
|
+
) : server.registerTool(customName, customToolConfig, wrappedHandler);
|
|
4793
|
+
validateToolInputAtAdcpLayer(server, customName, registered);
|
|
4731
4794
|
registeredToolNames.add(customName);
|
|
4732
4795
|
}
|
|
4733
4796
|
}
|
|
@@ -4794,7 +4857,10 @@ function createAdcpServer(config) {
|
|
|
4794
4857
|
property_list_filtering: capConfig?.features?.propertyListFiltering ?? false,
|
|
4795
4858
|
content_standards: capConfig?.features?.contentStandards ?? false,
|
|
4796
4859
|
conversion_tracking: capConfig?.features?.conversionTracking ?? false,
|
|
4797
|
-
audience_targeting: capConfig?.features?.audienceTargeting ?? false
|
|
4860
|
+
audience_targeting: capConfig?.features?.audienceTargeting ?? false,
|
|
4861
|
+
...capConfig?.features?.creativeStartPolicy !== void 0 && {
|
|
4862
|
+
creative_start_policy: capConfig.features.creativeStartPolicy
|
|
4863
|
+
}
|
|
4798
4864
|
},
|
|
4799
4865
|
...capConfig?.portfolio && { portfolio: capConfig.portfolio }
|
|
4800
4866
|
};
|
|
@@ -5109,9 +5175,28 @@ function createAdcpServer(config) {
|
|
|
5109
5175
|
if (selected !== void 0 && (selected.major > 3 || selected.major === 3 && selected.minor >= 2) && data.request_signing?.supported === true) {
|
|
5110
5176
|
data.request_signing = { ...data.request_signing, covers_content_digest: "required" };
|
|
5111
5177
|
}
|
|
5112
|
-
|
|
5178
|
+
const servesAdcp30 = selected?.major === 3 && selected.minor === 0;
|
|
5179
|
+
if (servesAdcp30) {
|
|
5113
5180
|
data = projectCapabilitiesToVersion(data, release.validationVersion);
|
|
5114
5181
|
}
|
|
5182
|
+
if (translationSteps(adcpVersion, release.validationVersion).length > 0) {
|
|
5183
|
+
const options = { fromVersion: adcpVersion, toVersion: release.validationVersion };
|
|
5184
|
+
const projected = servesAdcp30 ? projectExperimentalFeaturesForRelease(data, options) : projectCapabilitiesForRelease(data, options);
|
|
5185
|
+
data = projected.data;
|
|
5186
|
+
if (projected.drifts.length > 0) {
|
|
5187
|
+
logger.info(`Converted get_adcp_capabilities response down to AdCP ${release.validationVersion}`, {
|
|
5188
|
+
tool: "get_adcp_capabilities",
|
|
5189
|
+
drifts: projected.drifts
|
|
5190
|
+
});
|
|
5191
|
+
reportVersionTranslation({
|
|
5192
|
+
tool: "get_adcp_capabilities",
|
|
5193
|
+
direction: "response",
|
|
5194
|
+
fromVersion: adcpVersion,
|
|
5195
|
+
toVersion: release.validationVersion,
|
|
5196
|
+
drifts: projected.drifts
|
|
5197
|
+
});
|
|
5198
|
+
}
|
|
5199
|
+
}
|
|
5115
5200
|
if (selected !== void 0 && (selected.major < 3 || selected.major === 3 && selected.minor === 1)) {
|
|
5116
5201
|
if (data.webhook_signing) {
|
|
5117
5202
|
delete data.webhook_signing.delivery_retry_horizon_seconds;
|
|
@@ -167,6 +167,33 @@ export interface DecisioningCapabilities<TConfig = unknown> {
|
|
|
167
167
|
* as `true` unless they override this explicitly.
|
|
168
168
|
*/
|
|
169
169
|
supportsProposals?: boolean;
|
|
170
|
+
/**
|
|
171
|
+
* The `get_products` buying modes this seller serves. Projected onto
|
|
172
|
+
* `get_adcp_capabilities.media_buy.buying_modes`.
|
|
173
|
+
*
|
|
174
|
+
* Omit it and the framework derives the list from the handlers the platform
|
|
175
|
+
* registers: `brief`, plus `refine` when proposals are supported (as before),
|
|
176
|
+
* plus `wholesale` when `mediaBuyLifecycle.listProducts` is registered. A
|
|
177
|
+
* platform that registers that catalogue handler but has no brief path (no
|
|
178
|
+
* `sales.getProducts`, `proposalManager`, `requestProposals` or
|
|
179
|
+
* `refineProposals`) is advertised as `['wholesale']` alone.
|
|
180
|
+
*
|
|
181
|
+
* Declare the list when the handlers cannot say it: a `sales.getProducts`
|
|
182
|
+
* handler that answers `buying_mode: 'wholesale'` (one handler serves every
|
|
183
|
+
* mode, so registering it does not reveal which), or a seller that must not
|
|
184
|
+
* advertise a mode its handlers would imply. The list needs at least one
|
|
185
|
+
* mode, and every mode needs a handler that serves it: `brief` and `refine`
|
|
186
|
+
* need `sales.getProducts` or a proposal path, `wholesale` needs
|
|
187
|
+
* `sales.getProducts` or `mediaBuyLifecycle.listProducts`. A declaration that
|
|
188
|
+
* breaks this is refused when the server is built, with a `PlatformConfigError`
|
|
189
|
+
* naming the mode.
|
|
190
|
+
*
|
|
191
|
+
* This is the only way to change the list: `overrides.media_buy.buying_modes`
|
|
192
|
+
* is still overwritten by the framework's value. AdCP treats `brief` as
|
|
193
|
+
* universally supported and implicit, so declaring `['wholesale']` does not
|
|
194
|
+
* say the seller refuses briefs.
|
|
195
|
+
*/
|
|
196
|
+
buyingModes?: ReadonlyArray<NonNullable<_MediaBuyCapabilities['buying_modes']>[number]>;
|
|
170
197
|
/**
|
|
171
198
|
* Brand-protocol capabilities. Projected onto the wire `brand` block of
|
|
172
199
|
* `get_adcp_capabilities` (`brand: { rights, right_types, available_uses,
|
|
@@ -167,6 +167,33 @@ export interface DecisioningCapabilities<TConfig = unknown> {
|
|
|
167
167
|
* as `true` unless they override this explicitly.
|
|
168
168
|
*/
|
|
169
169
|
supportsProposals?: boolean;
|
|
170
|
+
/**
|
|
171
|
+
* The `get_products` buying modes this seller serves. Projected onto
|
|
172
|
+
* `get_adcp_capabilities.media_buy.buying_modes`.
|
|
173
|
+
*
|
|
174
|
+
* Omit it and the framework derives the list from the handlers the platform
|
|
175
|
+
* registers: `brief`, plus `refine` when proposals are supported (as before),
|
|
176
|
+
* plus `wholesale` when `mediaBuyLifecycle.listProducts` is registered. A
|
|
177
|
+
* platform that registers that catalogue handler but has no brief path (no
|
|
178
|
+
* `sales.getProducts`, `proposalManager`, `requestProposals` or
|
|
179
|
+
* `refineProposals`) is advertised as `['wholesale']` alone.
|
|
180
|
+
*
|
|
181
|
+
* Declare the list when the handlers cannot say it: a `sales.getProducts`
|
|
182
|
+
* handler that answers `buying_mode: 'wholesale'` (one handler serves every
|
|
183
|
+
* mode, so registering it does not reveal which), or a seller that must not
|
|
184
|
+
* advertise a mode its handlers would imply. The list needs at least one
|
|
185
|
+
* mode, and every mode needs a handler that serves it: `brief` and `refine`
|
|
186
|
+
* need `sales.getProducts` or a proposal path, `wholesale` needs
|
|
187
|
+
* `sales.getProducts` or `mediaBuyLifecycle.listProducts`. A declaration that
|
|
188
|
+
* breaks this is refused when the server is built, with a `PlatformConfigError`
|
|
189
|
+
* naming the mode.
|
|
190
|
+
*
|
|
191
|
+
* This is the only way to change the list: `overrides.media_buy.buying_modes`
|
|
192
|
+
* is still overwritten by the framework's value. AdCP treats `brief` as
|
|
193
|
+
* universally supported and implicit, so declaring `['wholesale']` does not
|
|
194
|
+
* say the seller refuses briefs.
|
|
195
|
+
*/
|
|
196
|
+
buyingModes?: ReadonlyArray<NonNullable<_MediaBuyCapabilities['buying_modes']>[number]>;
|
|
170
197
|
/**
|
|
171
198
|
* Brand-protocol capabilities. Projected onto the wire `brand` block of
|
|
172
199
|
* `get_adcp_capabilities` (`brand: { rights, right_types, available_uses,
|