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

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

@@ -22,6 +22,8 @@ __export(create_adcp_server_exports, {
   ADCP_INSTRUCTIONS_RESOLVER: () => ADCP_INSTRUCTIONS_RESOLVER,
   ADCP_PRE_TRANSPORT: () => ADCP_PRE_TRANSPORT,
   ADCP_SIGNED_REQUESTS_STATE: () => ADCP_SIGNED_REQUESTS_STATE,
+  COMPACT_MEDIA_BUY_MUTATION_TOOLS: () => COMPACT_MEDIA_BUY_MUTATION_TOOLS,
+  MEDIA_BUY_MCP_TOOL_PROFILE: () => MEDIA_BUY_MCP_TOOL_PROFILE,
   createAdcpServer: () => createAdcpServer,
   requireSessionKey: () => requireSessionKey
 });
@@ -87,6 +89,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;
@@ -411,6 +440,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}`;
@@ -639,6 +677,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" },
@@ -1325,6 +1371,8 @@ function createAdcpServer(config) {
     name,
     version,
     adcpVersion: configuredAdcpVersion,
+    mcpToolProfile = "auto",
+    requireCompactMutationAccountScope = false,
     resolveAccount,
     resolveAccountFromAuth,
     resolveSessionKey,
@@ -1347,6 +1395,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) {
@@ -1416,6 +1469,7 @@ function createAdcpServer(config) {
     );
   }
   const protocolBundleKey = (0, import_schema_loader.resolveBundleKey)(adcpVersion);
+  const frameworkToolMeta = { adcp_version: adcpVersion };
   const servedAdcpVersion = (() => {
     const bundleKey = protocolBundleKey;
     return (0, import_protocols.bundleSupportsAdcpVersionField)(bundleKey) ? bundleKey : void 0;
@@ -2272,6 +2326,22 @@ function createAdcpServer(config) {
             );
           }
         }
+        if (COMPACT_MEDIA_BUY_MUTATION_TOOLS.has(toolName)) {
+          if (authenticatedPrincipalForContext(ctx.authInfo, ctx.agent) === void 0) {
+            return finalize(
+              (0, import_errors.adcpError)("AUTH_MISSING", {
+                message: `${toolName} requires an authenticated buyer principal`
+              })
+            );
+          }
+          if (requireCompactMutationAccountScope && ctx.account == null) {
+            return finalize(
+              (0, import_errors.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(
@@ -2962,7 +3032,8 @@ function createAdcpServer(config) {
         toolName,
         {
           inputSchema: frameworkInputSchemaFor(toolName),
-          ...meta?.annotations != null && { annotations: meta.annotations }
+          ...meta?.annotations != null && { annotations: meta.annotations },
+          _meta: frameworkToolMeta
         },
         toolHandler
       );
@@ -2974,7 +3045,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);
@@ -3050,7 +3122,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);
@@ -3298,7 +3371,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 : {};
@@ -3450,6 +3524,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 = (0, import_adcp_server.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 = (0, import_schema_loader.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"
+    );
+  }
   (0, import_credential_policy.validateCredentialPolicy)(credentialPolicy, registeredToolNames);
   const compliance = {
     async reset({
@@ -3545,6 +3659,8 @@ function createAdcpServer(config) {
   ADCP_INSTRUCTIONS_RESOLVER,
   ADCP_PRE_TRANSPORT,
   ADCP_SIGNED_REQUESTS_STATE,
+  COMPACT_MEDIA_BUY_MUTATION_TOOLS,
+  MEDIA_BUY_MCP_TOOL_PROFILE,
   createAdcpServer,
   requireSessionKey
 });