@copilotkit/runtime 1.8.5-next.1 → 1.8.5-next.3

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # @copilotkit/runtime
 
+## 1.8.5-next.3
+
+### Patch Changes
+
+- 77a7457: - feat: Add Model Context Protocol (MCP) support
+  - @copilotkit/shared@1.8.5-next.3
+
+## 1.8.5-next.2
+
+### Patch Changes
+
+- @copilotkit/shared@1.8.5-next.2
+
 ## 1.8.5-next.1
 
 ### Patch Changes

package/dist/{chunk-EH5E2IX3.mjs → chunk-2PVUPC44.mjs}

@@ -2,7 +2,7 @@ import {
   copilotRuntimeNodeHttpEndpoint,
   getRuntimeInstanceTelemetryInfo,
   telemetry_client_default
-} from "./chunk-KH52RHVR.mjs";
+} from "./chunk-UTUGZIQI.mjs";
 import {
   __name
 } from "./chunk-FHD4JECV.mjs";
@@ -22,4 +22,4 @@ __name(copilotRuntimeNodeExpressEndpoint, "copilotRuntimeNodeExpressEndpoint");
 export {
   copilotRuntimeNodeExpressEndpoint
 };
-//# sourceMappingURL=chunk-EH5E2IX3.mjs.map
+//# sourceMappingURL=chunk-2PVUPC44.mjs.map

package/dist/{chunk-FZJAYGIR.mjs → chunk-DNI7KA7Y.mjs}

@@ -1439,7 +1439,6 @@ __name(EmptyAdapter, "EmptyAdapter");
 var ExperimentalEmptyAdapter = EmptyAdapter;
 
 export {
-  RemoteChain,
   OpenAIAdapter,
   streamLangChainResponse,
   LangChainAdapter,
@@ -1447,9 +1446,10 @@ export {
   OpenAIAssistantAdapter,
   UnifyAdapter,
   GroqAdapter,
+  RemoteChain,
   AnthropicAdapter,
   ExperimentalOllamaAdapter,
   EmptyAdapter,
   ExperimentalEmptyAdapter
 };
-//# sourceMappingURL=chunk-FZJAYGIR.mjs.map
+//# sourceMappingURL=chunk-DNI7KA7Y.mjs.map

package/dist/chunk-Q6JA6YY3.mjs

@@ -0,0 +1 @@
+//# sourceMappingURL=chunk-Q6JA6YY3.mjs.map

package/dist/{chunk-CFWU64MY.mjs → chunk-TDPCQIMB.mjs}

@@ -2,7 +2,7 @@ import {
   copilotRuntimeNodeHttpEndpoint,
   getRuntimeInstanceTelemetryInfo,
   telemetry_client_default
-} from "./chunk-KH52RHVR.mjs";
+} from "./chunk-UTUGZIQI.mjs";
 import {
   __name
 } from "./chunk-FHD4JECV.mjs";
@@ -22,4 +22,4 @@ __name(copilotRuntimeNestEndpoint, "copilotRuntimeNestEndpoint");
 export {
   copilotRuntimeNestEndpoint
 };
-//# sourceMappingURL=chunk-CFWU64MY.mjs.map
+//# sourceMappingURL=chunk-TDPCQIMB.mjs.map

package/dist/{chunk-AQHJGUTA.mjs → chunk-UOCZJTXN.mjs}

@@ -2,7 +2,7 @@ import {
   getCommonConfig,
   getRuntimeInstanceTelemetryInfo,
   telemetry_client_default
-} from "./chunk-KH52RHVR.mjs";
+} from "./chunk-UTUGZIQI.mjs";
 import {
   __name
 } from "./chunk-FHD4JECV.mjs";
@@ -77,4 +77,4 @@ export {
   config,
   copilotRuntimeNextJSPagesRouterEndpoint
 };
-//# sourceMappingURL=chunk-AQHJGUTA.mjs.map
+//# sourceMappingURL=chunk-UOCZJTXN.mjs.map

package/dist/{chunk-KH52RHVR.mjs → chunk-UTUGZIQI.mjs}

@@ -2,7 +2,7 @@ import {
   EmptyAdapter,
   RemoteChain,
   streamLangChainResponse
-} from "./chunk-FZJAYGIR.mjs";
+} from "./chunk-DNI7KA7Y.mjs";
 import {
   GuardrailsValidationFailureResponse,
   MessageStreamInterruptedResponse,
@@ -39,7 +39,7 @@ var require_package = __commonJS({
       publishConfig: {
         access: "public"
       },
-      version: "1.8.5-next.1",
+      version: "1.8.5-next.3",
       sideEffects: false,
       main: "./dist/index.js",
       module: "./dist/index.mjs",
@@ -2729,6 +2729,62 @@ __name(convertGqlInputToMessages, "convertGqlInputToMessages");
 // src/lib/runtime/copilot-runtime.ts
 import { from } from "rxjs";
 import { Client as LangGraphClient2 } from "@langchain/langgraph-sdk";
+
+// src/lib/runtime/mcp-tools-utils.ts
+function extractParametersFromSchema(toolSchema) {
+  var _a, _b;
+  const parameters = [];
+  const properties = (_a = toolSchema == null ? void 0 : toolSchema.parameters) == null ? void 0 : _a.properties;
+  const requiredParams = new Set(((_b = toolSchema == null ? void 0 : toolSchema.parameters) == null ? void 0 : _b.required) || []);
+  if (!properties) {
+    return parameters;
+  }
+  for (const paramName in properties) {
+    if (Object.prototype.hasOwnProperty.call(properties, paramName)) {
+      const paramDef = properties[paramName];
+      parameters.push({
+        name: paramName,
+        // Infer type, default to string. MCP schemas might have more complex types.
+        // This might need refinement based on common MCP schema practices.
+        type: paramDef.type || "string",
+        description: paramDef.description,
+        required: requiredParams.has(paramName)
+      });
+    }
+  }
+  return parameters;
+}
+__name(extractParametersFromSchema, "extractParametersFromSchema");
+function convertMCPToolsToActions(mcpTools, mcpEndpoint) {
+  const actions = [];
+  for (const [toolName, tool] of Object.entries(mcpTools)) {
+    const parameters = extractParametersFromSchema(tool.schema);
+    const handler = /* @__PURE__ */ __name(async (params) => {
+      try {
+        const result = await tool.execute({
+          params
+        });
+        return typeof result === "string" ? result : JSON.stringify(result);
+      } catch (error) {
+        console.error(`Error executing MCP tool '${toolName}' from endpoint ${mcpEndpoint}:`, error);
+        throw new Error(`Execution failed for MCP tool '${toolName}': ${error instanceof Error ? error.message : String(error)}`);
+      }
+    }, "handler");
+    actions.push({
+      name: toolName,
+      description: tool.description || `MCP tool: ${toolName} (from ${mcpEndpoint})`,
+      parameters,
+      handler,
+      // Add metadata for easier identification/debugging
+      _isMCPTool: true,
+      _mcpEndpoint: mcpEndpoint
+    });
+  }
+  return actions;
+}
+__name(convertMCPToolsToActions, "convertMCPToolsToActions");
+
+// src/lib/runtime/copilot-runtime.ts
 var CopilotRuntime = class {
   actions;
   remoteEndpointDefinitions;
@@ -2738,8 +2794,15 @@ var CopilotRuntime = class {
   delegateAgentProcessingToServiceAdapter;
   observability;
   availableAgents;
+  // +++ MCP Properties +++
+  mcpEndpointsConfig;
+  mcpActionCache = /* @__PURE__ */ new Map();
+  // --- MCP Properties ---
+  // +++ MCP Client Factory +++
+  createMCPClientImpl;
+  // --- MCP Client Factory ---
   constructor(params) {
-    var _a, _b;
+    var _a, _b, _c, _d;
     if ((params == null ? void 0 : params.actions) && (params == null ? void 0 : params.remoteEndpoints) && (params == null ? void 0 : params.remoteEndpoints.some((e) => e.type === EndpointType.LangGraphPlatform))) {
       console.warn("Actions set in runtime instance will not be available for the agent");
     }
@@ -2754,7 +2817,59 @@ var CopilotRuntime = class {
     this.onAfterRequest = (_b = params == null ? void 0 : params.middleware) == null ? void 0 : _b.onAfterRequest;
     this.delegateAgentProcessingToServiceAdapter = (params == null ? void 0 : params.delegateAgentProcessingToServiceAdapter) || false;
     this.observability = params == null ? void 0 : params.observability_c;
+    this.mcpEndpointsConfig = params == null ? void 0 : params.mcpEndpoints;
+    this.createMCPClientImpl = params == null ? void 0 : params.createMCPClient;
+    if (this.mcpEndpointsConfig && this.mcpEndpointsConfig.length > 0 && !this.createMCPClientImpl) {
+      throw new CopilotKitMisuseError({
+        message: "MCP Integration Error: `mcpEndpoints` were provided, but the `createMCPClient` function was not passed to the CopilotRuntime constructor. Please provide an implementation for `createMCPClient`."
+      });
+    }
+    if ((params == null ? void 0 : params.actions) && (((_c = params == null ? void 0 : params.remoteEndpoints) == null ? void 0 : _c.some((e) => e.type === EndpointType.LangGraphPlatform)) || ((_d = this.mcpEndpointsConfig) == null ? void 0 : _d.length))) {
+      console.warn("Local 'actions' defined in CopilotRuntime might not be available to remote agents (LangGraph, MCP). Consider defining actions closer to the agent implementation if needed.");
+    }
   }
+  // +++ MCP Instruction Injection Method +++
+  injectMCPToolInstructions(messages, currentActions) {
+    const mcpActionsForRequest = currentActions.filter((action) => action._isMCPTool);
+    if (!mcpActionsForRequest || mcpActionsForRequest.length === 0) {
+      return messages;
+    }
+    const mcpToolInstructions = mcpActionsForRequest.map((action) => {
+      const paramsString = action.parameters && action.parameters.length > 0 ? ` Parameters: ${action.parameters.map((p) => `${p.name}${p.required ? "*" : ""}(${p.type})`).join(", ")}` : "";
+      return `- ${action.name}:${paramsString} ${action.description || ""}`;
+    }).join("\n");
+    if (!mcpToolInstructions) {
+      return messages;
+    }
+    const instructions = "You have access to the following tools provided by external Model Context Protocol (MCP) servers:\n" + mcpToolInstructions + "\nUse them when appropriate to fulfill the user's request.";
+    const systemMessageIndex = messages.findIndex((msg) => {
+      var _a;
+      return ((_a = msg.textMessage) == null ? void 0 : _a.role) === "system";
+    });
+    const newMessages = [
+      ...messages
+    ];
+    if (systemMessageIndex !== -1) {
+      const existingMsg = newMessages[systemMessageIndex];
+      if (existingMsg.textMessage) {
+        existingMsg.textMessage.content = (existingMsg.textMessage.content ? existingMsg.textMessage.content + "\n\n" : "") + instructions;
+      }
+    } else {
+      newMessages.unshift({
+        id: randomId2(),
+        createdAt: /* @__PURE__ */ new Date(),
+        textMessage: {
+          role: MessageRole.system,
+          content: instructions
+        },
+        actionExecutionMessage: void 0,
+        resultMessage: void 0,
+        agentStateMessage: void 0
+      });
+    }
+    return newMessages;
+  }
+  // --- MCP Instruction Injection Method ---
   async processRuntimeRequest(request) {
     var _a, _b, _c, _d, _e;
     const { serviceAdapter, messages: rawMessages, actions: clientSideActionsInput, threadId, runId, outputMessagesPromise, graphqlContext, forwardedParameters, url, extensions, agentSession, agentStates, publicApiKey } = request;
@@ -2772,9 +2887,10 @@ For non-agent components like useCopilotChatSuggestions, CopilotTextarea, or Cop
 please use an LLM adapter instead.`
         });
       }
-      const messages = rawMessages.filter((message) => !message.agentStateMessage);
-      const inputMessages = convertGqlInputToMessages(messages);
       const serverSideActions = await this.getServerSideActions(request);
+      const filteredRawMessages = rawMessages.filter((message) => !message.agentStateMessage);
+      const messagesWithInjectedInstructions = this.injectMCPToolInstructions(filteredRawMessages, serverSideActions);
+      const inputMessages = convertGqlInputToMessages(messagesWithInjectedInstructions);
       if (((_a = this.observability) == null ? void 0 : _a.enabled) && publicApiKey) {
         try {
           const requestData = {
@@ -3301,7 +3417,8 @@ please use an LLM adapter instead.`
     }
   }
   async getServerSideActions(request) {
-    const { messages: rawMessages, graphqlContext, agentStates, url } = request;
+    var _a;
+    const { graphqlContext, messages: rawMessages, agentStates, url } = request;
     const inputMessages = convertGqlInputToMessages(rawMessages);
     const langserveFunctions = [];
     for (const chainPromise of this.langserve) {
@@ -3327,10 +3444,46 @@ please use an LLM adapter instead.`
       properties: graphqlContext.properties,
       url
     }) : this.actions;
+    const requestSpecificMCPActions = [];
+    if (this.createMCPClientImpl) {
+      const baseEndpoints = this.mcpEndpointsConfig || [];
+      const requestEndpoints = ((_a = graphqlContext.properties) == null ? void 0 : _a.mcpEndpoints) || [];
+      const effectiveEndpointsMap = /* @__PURE__ */ new Map();
+      [
+        ...baseEndpoints,
+        ...requestEndpoints
+      ].forEach((ep) => {
+        if (ep && ep.endpoint) {
+          effectiveEndpointsMap.set(ep.endpoint, ep);
+        }
+      });
+      const effectiveEndpoints = Array.from(effectiveEndpointsMap.values());
+      for (const config of effectiveEndpoints) {
+        const endpointUrl = config.endpoint;
+        let actionsForEndpoint = this.mcpActionCache.get(endpointUrl);
+        if (!actionsForEndpoint) {
+          let client = null;
+          try {
+            console.log(`MCP: Cache miss. Fetching tools for endpoint: ${endpointUrl}`);
+            client = await this.createMCPClientImpl(config);
+            const tools = await client.tools();
+            actionsForEndpoint = convertMCPToolsToActions(tools, endpointUrl);
+            this.mcpActionCache.set(endpointUrl, actionsForEndpoint);
+            console.log(`MCP: Fetched and cached ${actionsForEndpoint.length} tools for ${endpointUrl}`);
+          } catch (error) {
+            console.error(`MCP: Failed to fetch tools from endpoint ${endpointUrl}. Skipping. Error:`, error);
+            actionsForEndpoint = [];
+            this.mcpActionCache.set(endpointUrl, actionsForEndpoint);
+          }
+        }
+        requestSpecificMCPActions.push(...actionsForEndpoint || []);
+      }
+    }
     return [
       ...configuredActions,
       ...langserveFunctions,
-      ...remoteActions
+      ...remoteActions,
+      ...requestSpecificMCPActions
     ];
   }
   // Add helper method to detect provider
@@ -4588,13 +4741,15 @@ function copilotRuntimeNodeHttpEndpoint(options) {
 __name(copilotRuntimeNodeHttpEndpoint, "copilotRuntimeNodeHttpEndpoint");
 
 export {
-  getRuntimeInstanceTelemetryInfo,
-  telemetry_client_default,
+  extractParametersFromSchema,
+  convertMCPToolsToActions,
   CopilotRuntime,
   flattenToolCallsNoDuplicates,
   copilotKitEndpoint,
   langGraphPlatformEndpoint,
   resolveEndpointType,
+  getRuntimeInstanceTelemetryInfo,
+  telemetry_client_default,
   createLogger,
   addCustomHeaderPlugin,
   createContext,
@@ -4602,4 +4757,4 @@ export {
   getCommonConfig,
   copilotRuntimeNodeHttpEndpoint
 };
-//# sourceMappingURL=chunk-KH52RHVR.mjs.map
+//# sourceMappingURL=chunk-UTUGZIQI.mjs.map