@adcp/sdk 8.1.0-beta.1 → 8.1.0-beta.10
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 +16 -1
- package/bin/adcp.js +75 -21
- package/dist/lib/conformance/oracle.d.ts.map +1 -1
- package/dist/lib/conformance/oracle.js +8 -1
- package/dist/lib/conformance/oracle.js.map +1 -1
- package/dist/lib/conformance/schemaArbitrary.js +135 -9
- package/dist/lib/conformance/schemaArbitrary.js.map +1 -1
- package/dist/lib/core/AgentClient.d.ts +1 -1
- package/dist/lib/core/AgentClient.d.ts.map +1 -1
- package/dist/lib/core/AgentClient.js.map +1 -1
- package/dist/lib/core/GovernanceMiddleware.d.ts +2 -1
- package/dist/lib/core/GovernanceMiddleware.d.ts.map +1 -1
- package/dist/lib/core/GovernanceMiddleware.js +9 -2
- package/dist/lib/core/GovernanceMiddleware.js.map +1 -1
- package/dist/lib/core/SingleAgentClient.d.ts +6 -0
- package/dist/lib/core/SingleAgentClient.d.ts.map +1 -1
- package/dist/lib/core/SingleAgentClient.js +2 -3
- package/dist/lib/core/SingleAgentClient.js.map +1 -1
- package/dist/lib/core/TaskExecutor.d.ts +1 -0
- package/dist/lib/core/TaskExecutor.d.ts.map +1 -1
- package/dist/lib/core/TaskExecutor.js +5 -1
- package/dist/lib/core/TaskExecutor.js.map +1 -1
- package/dist/lib/protocols/index.d.ts +10 -2
- package/dist/lib/protocols/index.d.ts.map +1 -1
- package/dist/lib/protocols/index.js +7 -6
- package/dist/lib/protocols/index.js.map +1 -1
- package/dist/lib/schemas/index.d.ts +68 -10
- package/dist/lib/schemas/index.d.ts.map +1 -1
- package/dist/lib/schemas/index.js +57 -16
- package/dist/lib/schemas/index.js.map +1 -1
- package/dist/lib/schemas-data/v2.5/_provenance.json +1 -1
- package/dist/lib/server/create-adcp-server.d.ts +59 -53
- package/dist/lib/server/create-adcp-server.d.ts.map +1 -1
- package/dist/lib/server/create-adcp-server.js +62 -10
- package/dist/lib/server/create-adcp-server.js.map +1 -1
- package/dist/lib/server/decisioning/account.d.ts +22 -6
- package/dist/lib/server/decisioning/account.d.ts.map +1 -1
- package/dist/lib/server/decisioning/account.js.map +1 -1
- package/dist/lib/server/decisioning/capabilities.d.ts +8 -0
- package/dist/lib/server/decisioning/capabilities.d.ts.map +1 -1
- package/dist/lib/server/decisioning/index.d.ts +12 -11
- package/dist/lib/server/decisioning/index.d.ts.map +1 -1
- package/dist/lib/server/decisioning/index.js.map +1 -1
- package/dist/lib/server/decisioning/list-helpers.d.ts +3 -2
- package/dist/lib/server/decisioning/list-helpers.d.ts.map +1 -1
- package/dist/lib/server/decisioning/list-helpers.js +0 -1
- package/dist/lib/server/decisioning/list-helpers.js.map +1 -1
- package/dist/lib/server/decisioning/manifest-helpers.d.ts +8 -2
- package/dist/lib/server/decisioning/manifest-helpers.d.ts.map +1 -1
- package/dist/lib/server/decisioning/manifest-helpers.js +8 -2
- package/dist/lib/server/decisioning/manifest-helpers.js.map +1 -1
- package/dist/lib/server/decisioning/proposal/dispatch.d.ts +3 -2
- package/dist/lib/server/decisioning/proposal/dispatch.d.ts.map +1 -1
- package/dist/lib/server/decisioning/proposal/dispatch.js +1 -0
- package/dist/lib/server/decisioning/proposal/dispatch.js.map +1 -1
- package/dist/lib/server/decisioning/proposal/mock-manager.d.ts +3 -2
- package/dist/lib/server/decisioning/proposal/mock-manager.d.ts.map +1 -1
- package/dist/lib/server/decisioning/proposal/mock-manager.js.map +1 -1
- package/dist/lib/server/decisioning/proposal/types.d.ts +3 -2
- package/dist/lib/server/decisioning/proposal/types.d.ts.map +1 -1
- package/dist/lib/server/decisioning/proposal/types.js.map +1 -1
- package/dist/lib/server/decisioning/runtime/from-platform.d.ts.map +1 -1
- package/dist/lib/server/decisioning/runtime/from-platform.js +14 -1
- package/dist/lib/server/decisioning/runtime/from-platform.js.map +1 -1
- package/dist/lib/server/decisioning/specialisms/audiences.d.ts +4 -1
- package/dist/lib/server/decisioning/specialisms/audiences.d.ts.map +1 -1
- package/dist/lib/server/decisioning/specialisms/brand-rights.d.ts +19 -7
- package/dist/lib/server/decisioning/specialisms/brand-rights.d.ts.map +1 -1
- package/dist/lib/server/decisioning/specialisms/campaign-governance.d.ts +9 -4
- package/dist/lib/server/decisioning/specialisms/campaign-governance.d.ts.map +1 -1
- package/dist/lib/server/decisioning/specialisms/content-standards.d.ts +17 -8
- package/dist/lib/server/decisioning/specialisms/content-standards.d.ts.map +1 -1
- package/dist/lib/server/decisioning/specialisms/creative-ad-server.d.ts +13 -5
- package/dist/lib/server/decisioning/specialisms/creative-ad-server.d.ts.map +1 -1
- package/dist/lib/server/decisioning/specialisms/creative.d.ts +14 -9
- package/dist/lib/server/decisioning/specialisms/creative.d.ts.map +1 -1
- package/dist/lib/server/decisioning/specialisms/lists.d.ts +21 -10
- package/dist/lib/server/decisioning/specialisms/lists.d.ts.map +1 -1
- package/dist/lib/server/decisioning/specialisms/sales.d.ts +27 -12
- package/dist/lib/server/decisioning/specialisms/sales.d.ts.map +1 -1
- package/dist/lib/server/decisioning/specialisms/signals.d.ts +5 -2
- package/dist/lib/server/decisioning/specialisms/signals.d.ts.map +1 -1
- package/dist/lib/server/decisioning/specialisms/sponsored-intelligence.d.ts +9 -4
- package/dist/lib/server/decisioning/specialisms/sponsored-intelligence.d.ts.map +1 -1
- package/dist/lib/server/index.d.ts +1 -0
- package/dist/lib/server/index.d.ts.map +1 -1
- package/dist/lib/server/index.js.map +1 -1
- package/dist/lib/server/operational-platform.d.ts +4 -3
- package/dist/lib/server/operational-platform.d.ts.map +1 -1
- package/dist/lib/server/operational-platform.js.map +1 -1
- package/dist/lib/server/responses.d.ts +28 -27
- package/dist/lib/server/responses.d.ts.map +1 -1
- package/dist/lib/server/responses.js +96 -35
- package/dist/lib/server/responses.js.map +1 -1
- package/dist/lib/signing/types.d.ts +6 -0
- package/dist/lib/signing/types.d.ts.map +1 -1
- package/dist/lib/signing/types.js.map +1 -1
- package/dist/lib/signing/verifier.d.ts.map +1 -1
- package/dist/lib/signing/verifier.js +33 -4
- package/dist/lib/signing/verifier.js.map +1 -1
- package/dist/lib/testing/client.d.ts +5 -0
- package/dist/lib/testing/client.d.ts.map +1 -1
- package/dist/lib/testing/client.js +33 -2
- package/dist/lib/testing/client.js.map +1 -1
- package/dist/lib/testing/compliance/comply.d.ts +8 -1
- package/dist/lib/testing/compliance/comply.d.ts.map +1 -1
- package/dist/lib/testing/compliance/comply.js +57 -25
- package/dist/lib/testing/compliance/comply.js.map +1 -1
- package/dist/lib/testing/compliance/types.d.ts +2 -0
- package/dist/lib/testing/compliance/types.d.ts.map +1 -1
- package/dist/lib/testing/index.d.ts +1 -1
- package/dist/lib/testing/index.d.ts.map +1 -1
- package/dist/lib/testing/index.js +4 -1
- package/dist/lib/testing/index.js.map +1 -1
- package/dist/lib/testing/storyboard/compliance.d.ts +11 -1
- package/dist/lib/testing/storyboard/compliance.d.ts.map +1 -1
- package/dist/lib/testing/storyboard/compliance.js +37 -3
- package/dist/lib/testing/storyboard/compliance.js.map +1 -1
- package/dist/lib/testing/storyboard/index.d.ts +2 -2
- package/dist/lib/testing/storyboard/index.d.ts.map +1 -1
- package/dist/lib/testing/storyboard/index.js +6 -2
- package/dist/lib/testing/storyboard/index.js.map +1 -1
- package/dist/lib/testing/storyboard/probes.d.ts.map +1 -1
- package/dist/lib/testing/storyboard/probes.js +3 -0
- package/dist/lib/testing/storyboard/probes.js.map +1 -1
- package/dist/lib/testing/storyboard/request-builder.d.ts.map +1 -1
- package/dist/lib/testing/storyboard/request-builder.js +4 -1
- package/dist/lib/testing/storyboard/request-builder.js.map +1 -1
- package/dist/lib/testing/storyboard/runner.d.ts +2 -0
- package/dist/lib/testing/storyboard/runner.d.ts.map +1 -1
- package/dist/lib/testing/storyboard/runner.js +335 -43
- package/dist/lib/testing/storyboard/runner.js.map +1 -1
- package/dist/lib/testing/storyboard/types.d.ts +65 -0
- package/dist/lib/testing/storyboard/types.d.ts.map +1 -1
- package/dist/lib/testing/storyboard/types.js.map +1 -1
- package/dist/lib/testing/storyboard/validations.d.ts +4 -3
- package/dist/lib/testing/storyboard/validations.d.ts.map +1 -1
- package/dist/lib/testing/storyboard/validations.js +26 -2
- package/dist/lib/testing/storyboard/validations.js.map +1 -1
- package/dist/lib/testing/types.d.ts +19 -0
- package/dist/lib/testing/types.d.ts.map +1 -1
- package/dist/lib/types/activate-signal.d.ts +647 -0
- package/dist/lib/types/build-creative.d.ts +2105 -0
- package/dist/lib/types/calibrate-content.d.ts +675 -0
- package/dist/lib/types/check-governance.d.ts +619 -0
- package/dist/lib/types/comply-test-controller.d.ts +8428 -0
- package/dist/lib/types/core.generated.d.ts +547 -537
- package/dist/lib/types/core.generated.d.ts.map +1 -1
- package/dist/lib/types/core.generated.js +1 -1
- package/dist/lib/types/create-collection-list.d.ts +693 -0
- package/dist/lib/types/create-content-standards.d.ts +830 -0
- package/dist/lib/types/create-media-buy.d.ts +3374 -0
- package/dist/lib/types/create-property-list.d.ts +836 -0
- package/dist/lib/types/delete-collection-list.d.ts +497 -0
- package/dist/lib/types/delete-property-list.d.ts +497 -0
- package/dist/lib/types/get-account-financials.d.ts +624 -0
- package/dist/lib/types/get-adcp-capabilities.d.ts +2863 -0
- package/dist/lib/types/get-collection-list.d.ts +763 -0
- package/dist/lib/types/get-content-standards.d.ts +919 -0
- package/dist/lib/types/get-creative-delivery.d.ts +2219 -0
- package/dist/lib/types/get-creative-features.d.ts +1736 -0
- package/dist/lib/types/get-media-buy-artifacts.d.ts +864 -0
- package/dist/lib/types/get-media-buys.d.ts +1670 -0
- package/dist/lib/types/get-plan-audit-logs.d.ts +455 -0
- package/dist/lib/types/get-products.d.ts +4935 -0
- package/dist/lib/types/get-property-list.d.ts +874 -0
- package/dist/lib/types/get-signals.d.ts +986 -0
- package/dist/lib/types/index.d.ts +1 -0
- package/dist/lib/types/index.d.ts.map +1 -1
- package/dist/lib/types/index.js.map +1 -1
- package/dist/lib/types/inline-enums.generated.d.ts +163 -7
- package/dist/lib/types/inline-enums.generated.d.ts.map +1 -1
- package/dist/lib/types/inline-enums.generated.js +222 -9
- package/dist/lib/types/inline-enums.generated.js.map +1 -1
- package/dist/lib/types/list-accounts.d.ts +851 -0
- package/dist/lib/types/list-content-standards.d.ts +975 -0
- package/dist/lib/types/list-creative-formats.d.ts +3132 -0
- package/dist/lib/types/list-creatives.d.ts +2390 -0
- package/dist/lib/types/list-property-lists.d.ts +855 -0
- package/dist/lib/types/log-event.d.ts +373 -0
- package/dist/lib/types/per-tool-index.json +391 -0
- package/dist/lib/types/preview-creative.d.ts +1981 -0
- package/dist/lib/types/provide-performance-feedback.d.ts +218 -0
- package/dist/lib/types/report-plan-outcome.d.ts +433 -0
- package/dist/lib/types/report-usage.d.ts +579 -0
- package/dist/lib/types/schemas.generated.d.ts +146765 -128986
- package/dist/lib/types/schemas.generated.d.ts.map +1 -1
- package/dist/lib/types/schemas.generated.js +405 -437
- package/dist/lib/types/schemas.generated.js.map +1 -1
- package/dist/lib/types/server-payload.d.ts +39 -0
- package/dist/lib/types/server-payload.d.ts.map +1 -0
- package/dist/lib/types/server-payload.js +11 -0
- package/dist/lib/types/server-payload.js.map +1 -0
- package/dist/lib/types/si-get-offering.d.ts +259 -0
- package/dist/lib/types/si-initiate-session.d.ts +372 -0
- package/dist/lib/types/si-send-message.d.ts +300 -0
- package/dist/lib/types/si-terminate-session.d.ts +213 -0
- package/dist/lib/types/sync-accounts.d.ts +856 -0
- package/dist/lib/types/sync-audiences.d.ts +707 -0
- package/dist/lib/types/sync-catalogs.d.ts +766 -0
- package/dist/lib/types/sync-creatives.d.ts +2134 -0
- package/dist/lib/types/sync-event-sources.d.ts +665 -0
- package/dist/lib/types/sync-governance.d.ts +558 -0
- package/dist/lib/types/sync-plans.d.ts +979 -0
- package/dist/lib/types/tools.generated.d.ts +236 -188
- package/dist/lib/types/tools.generated.d.ts.map +1 -1
- package/dist/lib/types/update-collection-list.d.ts +697 -0
- package/dist/lib/types/update-content-standards.d.ts +847 -0
- package/dist/lib/types/update-media-buy.d.ts +3047 -0
- package/dist/lib/types/update-property-list.d.ts +840 -0
- package/dist/lib/types/validate-content-delivery.d.ts +722 -0
- package/dist/lib/types/validate-input.d.ts +1683 -0
- package/dist/lib/utils/adcp-version-config.d.ts +2 -0
- package/dist/lib/utils/adcp-version-config.d.ts.map +1 -1
- package/dist/lib/utils/adcp-version-config.js +42 -0
- package/dist/lib/utils/adcp-version-config.js.map +1 -1
- package/dist/lib/utils/response-schemas.d.ts.map +1 -1
- package/dist/lib/utils/response-schemas.js +3 -0
- package/dist/lib/utils/response-schemas.js.map +1 -1
- package/dist/lib/utils/response-unwrapper.d.ts.map +1 -1
- package/dist/lib/utils/response-unwrapper.js +28 -4
- package/dist/lib/utils/response-unwrapper.js.map +1 -1
- package/dist/lib/utils/tool-request-schemas.d.ts +8574 -1
- package/dist/lib/utils/tool-request-schemas.d.ts.map +1 -1
- package/dist/lib/utils/tool-request-schemas.js +4 -5
- package/dist/lib/utils/tool-request-schemas.js.map +1 -1
- package/dist/lib/utils/union-errors.d.ts +13 -6
- package/dist/lib/utils/union-errors.d.ts.map +1 -1
- package/dist/lib/utils/union-errors.js +34 -7
- package/dist/lib/utils/union-errors.js.map +1 -1
- package/dist/lib/validation/schema-loader.d.ts.map +1 -1
- package/dist/lib/validation/schema-loader.js +68 -15
- package/dist/lib/validation/schema-loader.js.map +1 -1
- package/dist/lib/version.d.ts +27 -3
- package/dist/lib/version.d.ts.map +1 -1
- package/dist/lib/version.js +42 -3
- package/dist/lib/version.js.map +1 -1
- package/examples/error-compliant-server.ts +1 -1
- package/examples/hello_seller_adapter_guaranteed.ts +14 -10
- package/examples/hello_seller_adapter_multi_tenant.ts +27 -23
- package/examples/hello_seller_adapter_non_guaranteed.ts +16 -14
- package/examples/hello_seller_adapter_proposal_mode.ts +22 -6
- package/examples/hello_signals_adapter_marketplace.ts +34 -3
- package/package.json +9 -2
|
@@ -156,14 +156,14 @@ class ProtocolClient {
|
|
|
156
156
|
* @param options - Optional call-level configuration. See {@link CallToolOptions}.
|
|
157
157
|
*/
|
|
158
158
|
static async callTool(agent, toolName, args, options = {}) {
|
|
159
|
-
const { debugLogs = [], webhookUrl, webhookSecret, webhookToken, serverVersion, session, adcpVersion, transport, } = options;
|
|
159
|
+
const { debugLogs = [], webhookUrl, webhookSecret, webhookToken, serverVersion, session, adcpVersion, versionEnvelope: versionEnvelopeMode = 'auto', transport, } = options;
|
|
160
160
|
// Per-instance version envelope. Throws on unparseable pins via
|
|
161
161
|
// `resolveWireMajor`; construction-time `resolveAdcpVersion` is the
|
|
162
162
|
// primary gate but this is the failsafe for callers reaching
|
|
163
163
|
// `ProtocolClient.callTool` directly (test harnesses, the in-process
|
|
164
164
|
// MCP path). Returns `{ adcp_major_version }` for 3.0 pins and
|
|
165
165
|
// `{ adcp_major_version, adcp_version }` for 3.1+ pins.
|
|
166
|
-
const versionEnvelope = buildVersionEnvelope(adcpVersion, serverVersion);
|
|
166
|
+
const versionEnvelope = versionEnvelopeMode === 'none' ? {} : buildVersionEnvelope(adcpVersion, serverVersion);
|
|
167
167
|
// Enter the response-size-limit ALS slot once for this call. The slot is
|
|
168
168
|
// read by `wrapFetchWithSizeLimit` in both protocol transports, so the
|
|
169
169
|
// cap applies regardless of which path (MCP / A2A / OAuth refresh) the
|
|
@@ -217,6 +217,7 @@ class ProtocolClient {
|
|
|
217
217
|
debugLogs,
|
|
218
218
|
serverVersion,
|
|
219
219
|
adcpVersion,
|
|
220
|
+
...(versionEnvelopeMode !== 'auto' && { versionEnvelope: versionEnvelopeMode }),
|
|
220
221
|
}));
|
|
221
222
|
}
|
|
222
223
|
// Inject the version envelope on every request so sellers can validate
|
|
@@ -373,18 +374,18 @@ async function rethrowAsNeedsAuthorization(err, agentUrl) {
|
|
|
373
374
|
* the factories would silently bypass the cap, which the public API
|
|
374
375
|
* (`TransportOptions`) implies they honor.
|
|
375
376
|
*/
|
|
376
|
-
const createMCPClient = (agentUrl, authToken, headers, serverVersion, adcpVersion, transport) => {
|
|
377
|
+
const createMCPClient = (agentUrl, authToken, headers, serverVersion, adcpVersion, transport, versionEnvelopeMode = 'auto') => {
|
|
377
378
|
// Validate the pin at factory time so a typo surfaces here rather than at
|
|
378
379
|
// first call. `buildVersionEnvelope` throws via `resolveWireMajor` on bad
|
|
379
380
|
// input — call it once to surface, then close over the envelope.
|
|
380
|
-
const versionEnvelope = buildVersionEnvelope(adcpVersion, serverVersion);
|
|
381
|
+
const versionEnvelope = versionEnvelopeMode === 'none' ? {} : buildVersionEnvelope(adcpVersion, serverVersion);
|
|
381
382
|
return {
|
|
382
383
|
callTool: (toolName, args, debugLogs) => (0, responseSizeLimit_1.withResponseSizeLimit)(transport?.maxResponseBytes, () => (0, mcp_tasks_2.callMCPToolWithTasks)(agentUrl, toolName, applyVersionEnvelope(args, versionEnvelope), authToken, debugLogs, headers)),
|
|
383
384
|
};
|
|
384
385
|
};
|
|
385
386
|
exports.createMCPClient = createMCPClient;
|
|
386
|
-
const createA2AClient = (agentUrl, authToken, headers, serverVersion, adcpVersion, transport) => {
|
|
387
|
-
const versionEnvelope = buildVersionEnvelope(adcpVersion, serverVersion);
|
|
387
|
+
const createA2AClient = (agentUrl, authToken, headers, serverVersion, adcpVersion, transport, versionEnvelopeMode = 'auto') => {
|
|
388
|
+
const versionEnvelope = versionEnvelopeMode === 'none' ? {} : buildVersionEnvelope(adcpVersion, serverVersion);
|
|
388
389
|
return {
|
|
389
390
|
callTool: (toolName, parameters, debugLogs) => (0, responseSizeLimit_1.withResponseSizeLimit)(transport?.maxResponseBytes, () => (0, a2a_3.callA2ATool)(agentUrl, toolName, applyVersionEnvelope(parameters, versionEnvelope), authToken, debugLogs, undefined, headers)),
|
|
390
391
|
};
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/protocols/index.ts"],"names":[],"mappings":";;;AAUA,4CAMC;
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/protocols/index.ts"],"names":[],"mappings":"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"}
|
|
@@ -3,18 +3,22 @@
|
|
|
3
3
|
*
|
|
4
4
|
* The generated Zod schemas in `../types/schemas.generated` cover every
|
|
5
5
|
* AdCP tool — the framework-registered {@link AdcpToolMap} tools AND
|
|
6
|
-
* tools like `creative_approval
|
|
7
|
-
* `customTools` extensions because the spec models them
|
|
8
|
-
*
|
|
6
|
+
* tools like `creative_approval`, `search_brands`, and brand verification
|
|
7
|
+
* tasks that ship as `customTools` extensions because the spec models them
|
|
8
|
+
* outside the SDK's framework-registered surface.
|
|
9
9
|
*
|
|
10
10
|
* This module re-exports the generated schemas plus two convenience
|
|
11
11
|
* helpers for the `customTools` registration path:
|
|
12
12
|
*
|
|
13
|
-
* - {@link TOOL_INPUT_SHAPES}: `toolName →
|
|
14
|
-
* pass as `inputSchema` to MCP SDK's `server.registerTool()
|
|
15
|
-
*
|
|
13
|
+
* - {@link TOOL_INPUT_SHAPES}: `toolName → raw Zod shape` map, ready to
|
|
14
|
+
* pass as `inputSchema` to MCP SDK's `server.registerTool()` when the
|
|
15
|
+
* request schema is a ZodObject.
|
|
16
|
+
* - {@link TOOL_INPUT_SCHEMAS}: `toolName → full Zod schema` map for
|
|
17
|
+
* custom tools whose request schema is a union/intersection and cannot
|
|
18
|
+
* be represented as a raw shape without weakening validation.
|
|
16
19
|
* - {@link customToolFor}: sugar for registering a single custom tool
|
|
17
20
|
* with type-safe `handler` params derived from the schema's shape.
|
|
21
|
+
* - {@link customToolForSchema}: same sugar for full Zod schemas.
|
|
18
22
|
*
|
|
19
23
|
* ```ts
|
|
20
24
|
* import { createAdcpServer } from '@adcp/sdk/server/legacy/v5';
|
|
@@ -34,9 +38,34 @@
|
|
|
34
38
|
* ```
|
|
35
39
|
*/
|
|
36
40
|
import type { z } from 'zod';
|
|
41
|
+
import * as schemas from '../types/schemas.generated';
|
|
42
|
+
import type { KnownToolRequestSchemas } from '../utils/tool-request-schemas';
|
|
37
43
|
export * from '../types/schemas.generated';
|
|
38
44
|
export { TOOL_REQUEST_SCHEMAS } from '../utils/tool-request-schemas';
|
|
39
45
|
type InputShape = Record<string, z.ZodType>;
|
|
46
|
+
type InputSchema = z.ZodType;
|
|
47
|
+
type ShapeOf<T> = T extends {
|
|
48
|
+
shape: infer TShape extends InputShape;
|
|
49
|
+
} ? TShape : never;
|
|
50
|
+
type ToolInputShapes = {
|
|
51
|
+
[K in keyof KnownToolRequestSchemas]: ShapeOf<KnownToolRequestSchemas[K]>;
|
|
52
|
+
} & {
|
|
53
|
+
creative_approval: typeof schemas.CreativeApprovalRequestSchema.shape;
|
|
54
|
+
search_brands: typeof schemas.SearchBrandsRequestSchema.shape;
|
|
55
|
+
verify_brand_claims: typeof schemas.VerifyBrandClaimsRequestBulkSchema.shape;
|
|
56
|
+
} & {
|
|
57
|
+
readonly [toolName: string]: Readonly<InputShape> | undefined;
|
|
58
|
+
};
|
|
59
|
+
type ToolInputSchemas = {
|
|
60
|
+
[K in keyof KnownToolRequestSchemas]: KnownToolRequestSchemas[K];
|
|
61
|
+
} & {
|
|
62
|
+
creative_approval: typeof schemas.CreativeApprovalRequestSchema;
|
|
63
|
+
search_brands: typeof schemas.SearchBrandsRequestSchema;
|
|
64
|
+
verify_brand_claim: typeof schemas.VerifyBrandClaimRequestSchema;
|
|
65
|
+
verify_brand_claims: typeof schemas.VerifyBrandClaimsRequestBulkSchema;
|
|
66
|
+
} & {
|
|
67
|
+
readonly [toolName: string]: InputSchema | undefined;
|
|
68
|
+
};
|
|
40
69
|
/**
|
|
41
70
|
* Map of every known AdCP tool name to its Zod input shape — i.e., the
|
|
42
71
|
* `.shape` of its request schema, ready to pass as `inputSchema` to MCP
|
|
@@ -46,16 +75,34 @@ type InputShape = Record<string, z.ZodType>;
|
|
|
46
75
|
* registered with the framework (get_products, create_media_buy,
|
|
47
76
|
* sync_catalogs, check_governance, comply_test_controller, all five
|
|
48
77
|
* *_collection_list tools, validate_property_delivery, acquire_rights,
|
|
49
|
-
* et al.) PLUS
|
|
50
|
-
*
|
|
51
|
-
*
|
|
78
|
+
* et al.) PLUS shape-compatible custom surfaces such as `creative_approval`,
|
|
79
|
+
* `search_brands`, and `verify_brand_claims` so sellers don't have to
|
|
80
|
+
* hand-author shapes for those either.
|
|
81
|
+
*
|
|
82
|
+
* `verify_brand_claim` is intentionally not present here: its request schema
|
|
83
|
+
* is an envelope intersected with a claim-variant union, so use
|
|
84
|
+
* {@link TOOL_INPUT_SCHEMAS} with {@link customToolForSchema} to preserve the
|
|
85
|
+
* discriminated union at validation time.
|
|
86
|
+
*
|
|
87
|
+
* Known tool names retain exact `.shape` field types for IDE completion and
|
|
88
|
+
* handler inference. Arbitrary string lookups return `undefined` until callers
|
|
89
|
+
* narrow the tool name to a known key.
|
|
52
90
|
*
|
|
53
91
|
* If a future AdCP release adds a new tool with a generated request
|
|
54
92
|
* schema, add its entry here (or to `TOOL_REQUEST_SCHEMAS` if it's
|
|
55
93
|
* framework-registrable) — CI's `ci:schema-check` catches missing
|
|
56
94
|
* map entries by diffing against the generated schemas.
|
|
57
95
|
*/
|
|
58
|
-
export declare const TOOL_INPUT_SHAPES: Readonly<
|
|
96
|
+
export declare const TOOL_INPUT_SHAPES: Readonly<ToolInputShapes>;
|
|
97
|
+
/**
|
|
98
|
+
* Map of known AdCP tool names to their full generated Zod request schemas.
|
|
99
|
+
*
|
|
100
|
+
* Prefer {@link TOOL_INPUT_SHAPES} when registering a shape-compatible tool
|
|
101
|
+
* with `registerTool()`. Use this map for union/intersection request schemas,
|
|
102
|
+
* notably `verify_brand_claim`, where a raw shape would lose the correlation
|
|
103
|
+
* between `claim_type` and the corresponding `claim` payload.
|
|
104
|
+
*/
|
|
105
|
+
export declare const TOOL_INPUT_SCHEMAS: Readonly<ToolInputSchemas>;
|
|
59
106
|
/**
|
|
60
107
|
* Register a custom tool with MCP-compatible `inputSchema` + handler
|
|
61
108
|
* wiring. Returns an object shaped for
|
|
@@ -73,4 +120,15 @@ export declare function customToolFor<TShape extends InputShape>(name: string, d
|
|
|
73
120
|
inputSchema: TShape;
|
|
74
121
|
handler: (args: z.input<z.ZodObject<TShape>>, extra?: unknown) => unknown | Promise<unknown>;
|
|
75
122
|
};
|
|
123
|
+
/**
|
|
124
|
+
* Register a custom tool whose MCP `inputSchema` is a full Zod schema rather
|
|
125
|
+
* than a raw shape. Use this for request schemas with top-level unions or
|
|
126
|
+
* intersections, where `.shape` would either be unavailable or would weaken
|
|
127
|
+
* runtime validation.
|
|
128
|
+
*/
|
|
129
|
+
export declare function customToolForSchema<TSchema extends InputSchema>(name: string, description: string, inputSchema: TSchema, handler: (args: z.input<TSchema>, extra?: unknown) => unknown | Promise<unknown>): {
|
|
130
|
+
description: string;
|
|
131
|
+
inputSchema: TSchema;
|
|
132
|
+
handler: (args: z.input<TSchema>, extra?: unknown) => unknown | Promise<unknown>;
|
|
133
|
+
};
|
|
76
134
|
//# sourceMappingURL=index.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/schemas/index.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/schemas/index.ts"],"names":[],"mappings":"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"}
|
|
@@ -4,18 +4,22 @@
|
|
|
4
4
|
*
|
|
5
5
|
* The generated Zod schemas in `../types/schemas.generated` cover every
|
|
6
6
|
* AdCP tool — the framework-registered {@link AdcpToolMap} tools AND
|
|
7
|
-
* tools like `creative_approval
|
|
8
|
-
* `customTools` extensions because the spec models them
|
|
9
|
-
*
|
|
7
|
+
* tools like `creative_approval`, `search_brands`, and brand verification
|
|
8
|
+
* tasks that ship as `customTools` extensions because the spec models them
|
|
9
|
+
* outside the SDK's framework-registered surface.
|
|
10
10
|
*
|
|
11
11
|
* This module re-exports the generated schemas plus two convenience
|
|
12
12
|
* helpers for the `customTools` registration path:
|
|
13
13
|
*
|
|
14
|
-
* - {@link TOOL_INPUT_SHAPES}: `toolName →
|
|
15
|
-
* pass as `inputSchema` to MCP SDK's `server.registerTool()
|
|
16
|
-
*
|
|
14
|
+
* - {@link TOOL_INPUT_SHAPES}: `toolName → raw Zod shape` map, ready to
|
|
15
|
+
* pass as `inputSchema` to MCP SDK's `server.registerTool()` when the
|
|
16
|
+
* request schema is a ZodObject.
|
|
17
|
+
* - {@link TOOL_INPUT_SCHEMAS}: `toolName → full Zod schema` map for
|
|
18
|
+
* custom tools whose request schema is a union/intersection and cannot
|
|
19
|
+
* be represented as a raw shape without weakening validation.
|
|
17
20
|
* - {@link customToolFor}: sugar for registering a single custom tool
|
|
18
21
|
* with type-safe `handler` params derived from the schema's shape.
|
|
22
|
+
* - {@link customToolForSchema}: same sugar for full Zod schemas.
|
|
19
23
|
*
|
|
20
24
|
* ```ts
|
|
21
25
|
* import { createAdcpServer } from '@adcp/sdk/server/legacy/v5';
|
|
@@ -71,17 +75,16 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
|
|
|
71
75
|
for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
|
|
72
76
|
};
|
|
73
77
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
74
|
-
exports.TOOL_INPUT_SHAPES = exports.TOOL_REQUEST_SCHEMAS = void 0;
|
|
78
|
+
exports.TOOL_INPUT_SCHEMAS = exports.TOOL_INPUT_SHAPES = exports.TOOL_REQUEST_SCHEMAS = void 0;
|
|
75
79
|
exports.customToolFor = customToolFor;
|
|
80
|
+
exports.customToolForSchema = customToolForSchema;
|
|
76
81
|
const schemas = __importStar(require("../types/schemas.generated"));
|
|
77
82
|
const tool_request_schemas_1 = require("../utils/tool-request-schemas");
|
|
78
83
|
__exportStar(require("../types/schemas.generated"), exports);
|
|
79
84
|
var tool_request_schemas_2 = require("../utils/tool-request-schemas");
|
|
80
85
|
Object.defineProperty(exports, "TOOL_REQUEST_SCHEMAS", { enumerable: true, get: function () { return tool_request_schemas_2.TOOL_REQUEST_SCHEMAS; } });
|
|
81
86
|
function shapeOf(s) {
|
|
82
|
-
|
|
83
|
-
return undefined;
|
|
84
|
-
const candidate = s.shape;
|
|
87
|
+
const candidate = s?.shape;
|
|
85
88
|
return candidate && typeof candidate === 'object' ? candidate : undefined;
|
|
86
89
|
}
|
|
87
90
|
/**
|
|
@@ -93,9 +96,18 @@ function shapeOf(s) {
|
|
|
93
96
|
* registered with the framework (get_products, create_media_buy,
|
|
94
97
|
* sync_catalogs, check_governance, comply_test_controller, all five
|
|
95
98
|
* *_collection_list tools, validate_property_delivery, acquire_rights,
|
|
96
|
-
* et al.) PLUS
|
|
97
|
-
*
|
|
98
|
-
*
|
|
99
|
+
* et al.) PLUS shape-compatible custom surfaces such as `creative_approval`,
|
|
100
|
+
* `search_brands`, and `verify_brand_claims` so sellers don't have to
|
|
101
|
+
* hand-author shapes for those either.
|
|
102
|
+
*
|
|
103
|
+
* `verify_brand_claim` is intentionally not present here: its request schema
|
|
104
|
+
* is an envelope intersected with a claim-variant union, so use
|
|
105
|
+
* {@link TOOL_INPUT_SCHEMAS} with {@link customToolForSchema} to preserve the
|
|
106
|
+
* discriminated union at validation time.
|
|
107
|
+
*
|
|
108
|
+
* Known tool names retain exact `.shape` field types for IDE completion and
|
|
109
|
+
* handler inference. Arbitrary string lookups return `undefined` until callers
|
|
110
|
+
* narrow the tool name to a known key.
|
|
99
111
|
*
|
|
100
112
|
* If a future AdCP release adds a new tool with a generated request
|
|
101
113
|
* schema, add its entry here (or to `TOOL_REQUEST_SCHEMAS` if it's
|
|
@@ -103,12 +115,31 @@ function shapeOf(s) {
|
|
|
103
115
|
* map entries by diffing against the generated schemas.
|
|
104
116
|
*/
|
|
105
117
|
exports.TOOL_INPUT_SHAPES = Object.freeze({
|
|
106
|
-
...Object.fromEntries(Object.entries(tool_request_schemas_1.TOOL_REQUEST_SCHEMAS).
|
|
118
|
+
...Object.fromEntries(Object.entries(tool_request_schemas_1.TOOL_REQUEST_SCHEMAS).map(([k, s]) => {
|
|
107
119
|
const shape = shapeOf(s);
|
|
108
|
-
|
|
120
|
+
if (!shape) {
|
|
121
|
+
throw new Error(`TOOL_REQUEST_SCHEMAS["${k}"] has no .shape — schema must be a ZodObject (use merge() not and())`);
|
|
122
|
+
}
|
|
123
|
+
return [k, shape];
|
|
109
124
|
})),
|
|
110
125
|
creative_approval: schemas.CreativeApprovalRequestSchema.shape,
|
|
111
|
-
|
|
126
|
+
search_brands: schemas.SearchBrandsRequestSchema.shape,
|
|
127
|
+
verify_brand_claims: schemas.VerifyBrandClaimsRequestBulkSchema.shape,
|
|
128
|
+
});
|
|
129
|
+
/**
|
|
130
|
+
* Map of known AdCP tool names to their full generated Zod request schemas.
|
|
131
|
+
*
|
|
132
|
+
* Prefer {@link TOOL_INPUT_SHAPES} when registering a shape-compatible tool
|
|
133
|
+
* with `registerTool()`. Use this map for union/intersection request schemas,
|
|
134
|
+
* notably `verify_brand_claim`, where a raw shape would lose the correlation
|
|
135
|
+
* between `claim_type` and the corresponding `claim` payload.
|
|
136
|
+
*/
|
|
137
|
+
exports.TOOL_INPUT_SCHEMAS = Object.freeze({
|
|
138
|
+
...tool_request_schemas_1.TOOL_REQUEST_SCHEMAS,
|
|
139
|
+
creative_approval: schemas.CreativeApprovalRequestSchema,
|
|
140
|
+
search_brands: schemas.SearchBrandsRequestSchema,
|
|
141
|
+
verify_brand_claim: schemas.VerifyBrandClaimRequestSchema,
|
|
142
|
+
verify_brand_claims: schemas.VerifyBrandClaimsRequestBulkSchema,
|
|
112
143
|
});
|
|
113
144
|
/**
|
|
114
145
|
* Register a custom tool with MCP-compatible `inputSchema` + handler
|
|
@@ -130,4 +161,14 @@ function customToolFor(name, description, inputSchema, handler) {
|
|
|
130
161
|
void name;
|
|
131
162
|
return { description, inputSchema, handler };
|
|
132
163
|
}
|
|
164
|
+
/**
|
|
165
|
+
* Register a custom tool whose MCP `inputSchema` is a full Zod schema rather
|
|
166
|
+
* than a raw shape. Use this for request schemas with top-level unions or
|
|
167
|
+
* intersections, where `.shape` would either be unavailable or would weaken
|
|
168
|
+
* runtime validation.
|
|
169
|
+
*/
|
|
170
|
+
function customToolForSchema(name, description, inputSchema, handler) {
|
|
171
|
+
void name;
|
|
172
|
+
return { description, inputSchema, handler };
|
|
173
|
+
}
|
|
133
174
|
//# sourceMappingURL=index.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/schemas/index.ts"],"names":[],"mappings":";AAAA
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/schemas/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+GH,sCAgBC;AAQD,kDAYC;AAhJD,oEAAsD;AACtD,wEAAqE;AAGrE,6DAA2C;AAC3C,sEAAqE;AAA5D,4HAAA,oBAAoB,OAAA;AA0B7B,SAAS,OAAO,CAAmC,CAAgB;IACjE,MAAM,SAAS,GAAG,CAAC,EAAE,KAAK,CAAC;IAC3B,OAAO,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;AAC5E,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACU,QAAA,iBAAiB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC7C,GAAG,MAAM,CAAC,WAAW,CACnB,MAAM,CAAC,OAAO,CAAC,2CAAoB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE;QAClD,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACzB,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CACb,yBAAyB,CAAC,uEAAuE,CAClG,CAAC;QACJ,CAAC;QACD,OAAO,CAAC,CAAC,EAAE,KAAK,CAAU,CAAC;IAC7B,CAAC,CAAC,CACH;IACD,iBAAiB,EAAE,OAAO,CAAC,6BAA6B,CAAC,KAAK;IAC9D,aAAa,EAAE,OAAO,CAAC,yBAAyB,CAAC,KAAK;IACtD,mBAAmB,EAAE,OAAO,CAAC,kCAAkC,CAAC,KAAK;CACtE,CAA8B,CAAC;AAEhC;;;;;;;GAOG;AACU,QAAA,kBAAkB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC9C,GAAG,2CAAoB;IACvB,iBAAiB,EAAE,OAAO,CAAC,6BAA6B;IACxD,aAAa,EAAE,OAAO,CAAC,yBAAyB;IAChD,kBAAkB,EAAE,OAAO,CAAC,6BAA6B;IACzD,mBAAmB,EAAE,OAAO,CAAC,kCAAkC;CAChE,CAA+B,CAAC;AAEjC;;;;;;;;;;;GAWG;AACH,SAAgB,aAAa,CAC3B,IAAY,EACZ,WAAmB,EACnB,WAAmB,EACnB,OAA4F;IAM5F,yEAAyE;IACzE,wEAAwE;IACxE,uEAAuE;IACvE,8DAA8D;IAC9D,KAAK,IAAI,CAAC;IACV,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;AAC/C,CAAC;AAED;;;;;GAKG;AACH,SAAgB,mBAAmB,CACjC,IAAY,EACZ,WAAmB,EACnB,WAAoB,EACpB,OAAgF;IAMhF,KAAK,IAAI,CAAC;IACV,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;AAC/C,CAAC"}
|
|
@@ -4,5 +4,5 @@
|
|
|
4
4
|
"source_sha": "4e553ad955f83b49c7d221ab5c3ff78237ad02e3",
|
|
5
5
|
"source_tarball_sha256": "580656d6466ef9f0d1119985e6726c2efea718dc671e2ad30957fcb2fd54af0f",
|
|
6
6
|
"upstream_adcp_version": "2.5.3",
|
|
7
|
-
"synced_at": "2026-05-
|
|
7
|
+
"synced_at": "2026-05-25T02:42:20.131Z"
|
|
8
8
|
}
|