@copilotkit/runtime 1.8.5-next.2 → 1.8.5-next.4

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @copilotkit/runtime
 
+## 1.8.5-next.4
+
+### Patch Changes
+
+- 76d9ef9: - fix: handle langgraph client specific errors when running lgc stream
+  - @copilotkit/shared@1.8.5-next.4
+
+## 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

package/dist/{chunk-PJX3FQOX.mjs → chunk-574FKWP5.mjs}

@@ -2,7 +2,7 @@ import {
   copilotRuntimeNodeHttpEndpoint,
   getRuntimeInstanceTelemetryInfo,
   telemetry_client_default
-} from "./chunk-A4MGCX6X.mjs";
+} from "./chunk-PKO7BUPS.mjs";
 import {
   __name
 } from "./chunk-FHD4JECV.mjs";
@@ -22,4 +22,4 @@ __name(copilotRuntimeNodeExpressEndpoint, "copilotRuntimeNodeExpressEndpoint");
 export {
   copilotRuntimeNodeExpressEndpoint
 };
-//# sourceMappingURL=chunk-PJX3FQOX.mjs.map
+//# sourceMappingURL=chunk-574FKWP5.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-A7E5UM7B.mjs → chunk-GGXHVDCG.mjs}

@@ -2,7 +2,7 @@ import {
   getCommonConfig,
   getRuntimeInstanceTelemetryInfo,
   telemetry_client_default
-} from "./chunk-A4MGCX6X.mjs";
+} from "./chunk-PKO7BUPS.mjs";
 import {
   __name
 } from "./chunk-FHD4JECV.mjs";
@@ -77,4 +77,4 @@ export {
   config,
   copilotRuntimeNextJSPagesRouterEndpoint
 };
-//# sourceMappingURL=chunk-A7E5UM7B.mjs.map
+//# sourceMappingURL=chunk-GGXHVDCG.mjs.map

package/dist/{chunk-A4MGCX6X.mjs → chunk-PKO7BUPS.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.2",
+      version: "1.8.5-next.4",
       sideEffects: false,
       main: "./dist/index.js",
       module: "./dist/index.mjs",
@@ -1687,7 +1687,7 @@ import { Client as LangGraphClient } from "@langchain/langgraph-sdk";
 import { createHash } from "crypto";
 import { isValidUUID, randomUUID } from "@copilotkit/shared";
 import { parse as parsePartialJson } from "partial-json";
-import { parseJson } from "@copilotkit/shared";
+import { parseJson, CopilotKitMisuseError } from "@copilotkit/shared";
 import { RemoveMessage } from "@langchain/core/messages";
 var activeInterruptEvent = false;
 async function execute(args) {
@@ -1697,6 +1697,23 @@ async function execute(args) {
         await streamEvents(controller, args);
         controller.close();
       } catch (err) {
+        const cause = err == null ? void 0 : err.cause;
+        const errorCode = (cause == null ? void 0 : cause.code) || (err == null ? void 0 : err.code);
+        if (errorCode === "ECONNREFUSED") {
+          throw new CopilotKitMisuseError({
+            message: `
+              The LangGraph client could not connect to the graph. Please further check previous logs, which includes further details.
+              
+              See more: https://docs.copilotkit.ai/troubleshooting/common-issues`
+          });
+        } else {
+          throw new CopilotKitMisuseError({
+            message: `
+              The LangGraph client threw unhandled error ${err}.
+              
+              See more: https://docs.copilotkit.ai/troubleshooting/common-issues`
+          });
+        }
       }
     }
   });
@@ -2674,7 +2691,7 @@ __name(setupRemoteActions, "setupRemoteActions");
 import { createHash as createHash3 } from "crypto";
 
 // src/lib/runtime/copilot-runtime.ts
-import { actionParametersToJsonSchema, ResolvedCopilotKitError as ResolvedCopilotKitError3, CopilotKitApiDiscoveryError as CopilotKitApiDiscoveryError2, randomId as randomId2, CopilotKitError as CopilotKitError3, CopilotKitLowLevelError as CopilotKitLowLevelError3, CopilotKitAgentDiscoveryError, CopilotKitMisuseError } from "@copilotkit/shared";
+import { actionParametersToJsonSchema, ResolvedCopilotKitError as ResolvedCopilotKitError3, CopilotKitApiDiscoveryError as CopilotKitApiDiscoveryError2, randomId as randomId2, CopilotKitError as CopilotKitError3, CopilotKitLowLevelError as CopilotKitLowLevelError3, CopilotKitAgentDiscoveryError, CopilotKitMisuseError as CopilotKitMisuseError2 } from "@copilotkit/shared";
 
 // src/service-adapters/conversion.ts
 import { plainToInstance } from "class-transformer";
@@ -2729,6 +2746,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 +2811,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 +2834,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 CopilotKitMisuseError2({
+        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;
@@ -2766,15 +2898,16 @@ var CopilotRuntime = class {
         return await this.processAgentRequest(request);
       }
       if (serviceAdapter instanceof EmptyAdapter) {
-        throw new CopilotKitMisuseError({
+        throw new CopilotKitMisuseError2({
           message: `Invalid adapter configuration: EmptyAdapter is only meant to be used with agent lock mode. 
 For non-agent components like useCopilotChatSuggestions, CopilotTextarea, or CopilotTask, 
 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 = {
@@ -2955,7 +3088,7 @@ please use an LLM adapter instead.`
             });
           }
         } catch (e) {
-          throw new CopilotKitMisuseError({
+          throw new CopilotKitMisuseError2({
             message: `
               Failed to find or contact remote endpoint at url ${endpoint.deploymentUrl}.
               Make sure the API is running and that it's indeed a LangGraph platform url.
@@ -3301,7 +3434,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 +3461,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 +4758,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 +4774,4 @@ export {
   getCommonConfig,
   copilotRuntimeNodeHttpEndpoint
 };
-//# sourceMappingURL=chunk-A4MGCX6X.mjs.map
+//# sourceMappingURL=chunk-PKO7BUPS.mjs.map