@adcp/sdk 14.0.0-beta.0 → 14.0.0-beta.1

package/dist/lib/server/create-adcp-server.mjs

@@ -5,7 +5,7 @@ import {
   toReleasePrecisionVersion
 } from "../version.mjs";
 import { isMovingAdcpPrereleaseFamilyAlias, resolveAdcpVersion } from "../utils/adcp-version-config.mjs";
-import { getValidator, hasSchemaBundle, resolveBundleKey } from "../validation/schema-loader.mjs";
+import { getValidator, hasSchemaBundle, resolveBundleKey, getMcpProfileInputSchema } from "../validation/schema-loader.mjs";
 import { TOOL_INPUT_SHAPES } from "../schemas/index.mjs";
 import { TaskTypeValues } from "../types/enums.generated.mjs";
 import { bundleSupportsAdcpVersionField } from "../protocols/index.mjs";
@@ -16,7 +16,8 @@ import {
   wrapMcpServer,
   setSdkServerInstructions,
   setMcpAppResources,
-  wrapInitializeHandler
+  wrapInitializeHandler,
+  wrapSdkRequestHandler
 } from "./adcp-server.mjs";
 import {
   mcpAppResourceMetadata,
@@ -151,6 +152,33 @@ const ADCP_PRE_TRANSPORT = /* @__PURE__ */ Symbol.for("@adcp/client.preTransport
 const ADCP_SIGNED_REQUESTS_STATE = /* @__PURE__ */ Symbol.for("@adcp/client.signedRequestsState");
 const ADCP_INSTRUCTIONS_FN = /* @__PURE__ */ Symbol.for("@adcp/client.instructionsFn");
 const ADCP_INSTRUCTIONS_RESOLVER = /* @__PURE__ */ Symbol.for("@adcp/client.instructionsResolver");
+const MEDIA_BUY_MCP_TOOL_PROFILE = [
+  "accept_proposal",
+  "buy_products",
+  "control_media_buy",
+  "decline_proposals",
+  "get_account_financials",
+  "get_adcp_capabilities",
+  "get_media_buy_delivery",
+  "get_media_buys",
+  "get_task_status",
+  "list_accounts",
+  "list_creatives",
+  "list_products",
+  "list_tasks",
+  "log_event",
+  "provide_performance_feedback",
+  "refine_proposals",
+  "report_usage",
+  "request_proposals",
+  "sync_accounts",
+  "sync_agent_notification_configs",
+  "sync_audiences",
+  "sync_catalogs",
+  "sync_creatives",
+  "sync_event_sources",
+  "sync_governance"
+];
 function clampReplayTtl(seconds) {
   const MIN = 3600;
   const MAX = 604800;
@@ -475,6 +503,15 @@ function taskBelongsToCaller(task, accountId, ownerScope) {
   if (task.ownerScope === void 0) return ownerScope === `account:${accountId}`;
   return task.ownerScope === ownerScope;
 }
+function authenticatedPrincipalForContext(authInfo, agent) {
+  if (agent?.agent_url) return `agent:${agent.agent_url}`;
+  const credential = authInfo?.credential;
+  if (credential?.kind === "http_sig") return `http_sig:${credential.agent_url}`;
+  if (credential?.kind === "oauth") return `oauth:${credential.client_id}`;
+  if (credential?.kind === "api_key") return `api_key:${credential.key_id}`;
+  if (typeof authInfo?.clientId === "string" && authInfo.clientId.length > 0) return `client:${authInfo.clientId}`;
+  return void 0;
+}
 function taskOwnerScopeForContext(authInfo, sessionKey, agent, accountId) {
   if (sessionKey !== void 0) return `session:${sessionKey}`;
   if (agent?.agent_url) return `agent:${agent.agent_url}`;
@@ -703,6 +740,14 @@ const COMPACT_MEDIA_BUY_LIFECYCLE_TOOLS = [
   "accept_proposal",
   "control_media_buy"
 ];
+const COMPACT_MEDIA_BUY_MUTATION_TOOLS = /* @__PURE__ */ new Set([
+  "request_proposals",
+  "refine_proposals",
+  "decline_proposals",
+  "buy_products",
+  "accept_proposal",
+  "control_media_buy"
+]);
 const MEDIA_BUY_ENTRIES = [
   { handlerKey: "getProducts", toolName: "get_products" },
   { handlerKey: "listProducts", toolName: "list_products" },
@@ -1389,6 +1434,8 @@ function createAdcpServer(config) {
     name,
     version,
     adcpVersion: configuredAdcpVersion,
+    mcpToolProfile = "auto",
+    requireCompactMutationAccountScope = false,
     resolveAccount,
     resolveAccountFromAuth,
     resolveSessionKey,
@@ -1411,6 +1458,11 @@ function createAdcpServer(config) {
     testController: testControllerBridge,
     responseEnhancer
   } = config;
+  if (!["auto", "media-buy", "all"].includes(mcpToolProfile)) {
+    throw new Error(
+      `createAdcpServer: mcpToolProfile must be "auto", "media-buy", or "all"; got ${JSON.stringify(mcpToolProfile)}`
+    );
+  }
   const notificationHandlerConfigured = typeof config.protocol?.syncAgentNotificationConfigs === "function";
   const notificationCapabilitySupported = capConfig?.capability_changes?.notifications?.supported === true;
   if (notificationHandlerConfigured !== notificationCapabilitySupported) {
@@ -1480,6 +1532,7 @@ function createAdcpServer(config) {
     );
   }
   const protocolBundleKey = resolveBundleKey(adcpVersion);
+  const frameworkToolMeta = { adcp_version: adcpVersion };
   const servedAdcpVersion = (() => {
     const bundleKey = protocolBundleKey;
     return bundleSupportsAdcpVersionField(bundleKey) ? bundleKey : void 0;
@@ -2336,6 +2389,22 @@ function createAdcpServer(config) {
             );
           }
         }
+        if (COMPACT_MEDIA_BUY_MUTATION_TOOLS.has(toolName)) {
+          if (authenticatedPrincipalForContext(ctx.authInfo, ctx.agent) === void 0) {
+            return finalize(
+              adcpError("AUTH_MISSING", {
+                message: `${toolName} requires an authenticated buyer principal`
+              })
+            );
+          }
+          if (requireCompactMutationAccountScope && ctx.account == null) {
+            return finalize(
+              adcpError("ACCOUNT_NOT_FOUND", {
+                message: `${toolName} requires a resolved account scope`
+              })
+            );
+          }
+        }
         if (toolName === "refine_proposals") {
           if (ctx.authInfo === void 0 && ctx.agent === void 0) {
             return finalize(
@@ -3026,7 +3095,8 @@ function createAdcpServer(config) {
         toolName,
         {
           inputSchema: frameworkInputSchemaFor(toolName),
-          ...meta?.annotations != null && { annotations: meta.annotations }
+          ...meta?.annotations != null && { annotations: meta.annotations },
+          _meta: frameworkToolMeta
         },
         toolHandler
       );
@@ -3038,7 +3108,8 @@ function createAdcpServer(config) {
       "get_task_status",
       {
         inputSchema: frameworkInputSchemaFor("get_task_status"),
-        annotations: RO
+        annotations: RO,
+        _meta: frameworkToolMeta
       },
       (async (params, extra) => {
         const credentialError = taskToolCredentialPolicyError("get_task_status", params ?? {}, extra);
@@ -3114,7 +3185,8 @@ function createAdcpServer(config) {
       "list_tasks",
       {
         inputSchema: frameworkInputSchemaFor("list_tasks"),
-        annotations: RO
+        annotations: RO,
+        _meta: frameworkToolMeta
       },
       (async (params, extra) => {
         const credentialError = taskToolCredentialPolicyError("list_tasks", params ?? {}, extra);
@@ -3362,7 +3434,8 @@ function createAdcpServer(config) {
     "get_adcp_capabilities",
     {
       inputSchema: frameworkInputSchemaFor("get_adcp_capabilities"),
-      annotations: { readOnlyHint: true }
+      annotations: { readOnlyHint: true },
+      _meta: frameworkToolMeta
     },
     (async (params, extra = {}) => {
       const requestParams = isPlainObject(params) ? params : {};
@@ -3514,6 +3587,46 @@ function createAdcpServer(config) {
     })
   );
   registeredToolNames.add("get_adcp_capabilities");
+  const configuredRelease = parseAdcpRelease(protocolBundleKey);
+  const serves32OrNewer = configuredRelease !== void 0 && (configuredRelease.major > 3 || configuredRelease.major === 3 && configuredRelease.minor >= 2);
+  if (mcpToolProfile === "media-buy" && !serves32OrNewer) {
+    throw new Error('createAdcpServer: mcpToolProfile="media-buy" requires adcpVersion 3.2 or newer');
+  }
+  const activeMcpToolProfile = mcpToolProfile === "media-buy" || mcpToolProfile === "auto" && serves32OrNewer && compactLifecycleTools.length > 0 ? "media-buy" : "all";
+  const mediaBuyProfileTools = new Set(MEDIA_BUY_MCP_TOOL_PROFILE);
+  const wrappedToolsList = wrapSdkRequestHandler(server, "tools/list", async (original, request, extra) => {
+    const response = await original(request, extra);
+    if (response == null || typeof response !== "object") return response;
+    const tools = response.tools;
+    if (!Array.isArray(tools)) return response;
+    const visibleTools = tools.filter((tool) => {
+      const toolName = tool?.name;
+      if (typeof toolName !== "string") return true;
+      if (!serves32OrNewer && COMPACT_MEDIA_BUY_LIFECYCLE_TOOLS.includes(toolName)) return false;
+      return activeMcpToolProfile === "all" || mediaBuyProfileTools.has(toolName);
+    });
+    const projectedTools = visibleTools.map((tool) => {
+      if (activeMcpToolProfile !== "media-buy") return tool;
+      const toolName = tool?.name;
+      if (typeof toolName !== "string") return tool;
+      const inputSchema = getMcpProfileInputSchema(toolName, "media-buy", adcpVersion);
+      return inputSchema ? { ...tool, inputSchema } : tool;
+    });
+    return {
+      ...response,
+      tools: projectedTools,
+      _meta: {
+        ...response._meta ?? {},
+        adcp_version: adcpVersion,
+        adcp_profile: activeMcpToolProfile
+      }
+    };
+  });
+  if (!wrappedToolsList) {
+    throw new Error(
+      "createAdcpServer: failed to install MCP tools/list profile filtering; the MCP SDK request-handler internals may have changed"
+    );
+  }
   validateCredentialPolicy(credentialPolicy, registeredToolNames);
   const compliance = {
     async reset({
@@ -3608,6 +3721,8 @@ export {
   ADCP_INSTRUCTIONS_RESOLVER,
   ADCP_PRE_TRANSPORT,
   ADCP_SIGNED_REQUESTS_STATE,
+  COMPACT_MEDIA_BUY_MUTATION_TOOLS,
+  MEDIA_BUY_MCP_TOOL_PROFILE,
   createAdcpServer,
   requireSessionKey
 };