@copilotkit/runtime 0.0.0-feat-enable-setting-recursion-limit-20250424165940 → 0.0.0-feat-enable-setting-recursion-limit-20250428151824

package/CHANGELOG.md

@@ -1,12 +1,52 @@
 # @copilotkit/runtime
 
-## 0.0.0-feat-enable-setting-recursion-limit-20250424165940
+## 0.0.0-feat-enable-setting-recursion-limit-20250428151824
 
 ### Patch Changes
 
 - 1d2ae5a: - feat: enable setting langgraph config from ui
   - chore: document usage of new config
-  - @copilotkit/shared@0.0.0-feat-enable-setting-recursion-limit-20250424165940
+  - @copilotkit/shared@0.0.0-feat-enable-setting-recursion-limit-20250428151824
+
+## 1.8.9
+
+### Patch Changes
+
+- f81a526: - Fix MCP tool schema structure to match interface requirements
+  - add utils
+  - @copilotkit/shared@1.8.9
+
+## 1.8.9-next.0
+
+### Patch Changes
+
+- f81a526: - Fix MCP tool schema structure to match interface requirements
+  - add utils
+  - @copilotkit/shared@1.8.9-next.0
+
+## 1.8.8
+
+### Patch Changes
+
+- 8c26335: - fix: update MCP tool parameter extraction to handle full tool objects
+- dfb67c3: - refactor: rename mcpEndpoints to mcpServers for naming consistency
+  - doc changes
+  - @copilotkit/shared@1.8.8
+
+## 1.8.8-next.1
+
+### Patch Changes
+
+- 8c26335: - fix: update MCP tool parameter extraction to handle full tool objects
+  - @copilotkit/shared@1.8.8-next.1
+
+## 1.8.8-next.0
+
+### Patch Changes
+
+- dfb67c3: - refactor: rename mcpEndpoints to mcpServers for naming consistency
+  - doc changes
+  - @copilotkit/shared@1.8.8-next.0
 
 ## 1.8.7
 

package/dist/{chunk-E5I25B3L.mjs → chunk-6N7YZABI.mjs}

@@ -2,7 +2,7 @@ import {
   copilotRuntimeNodeHttpEndpoint,
   getRuntimeInstanceTelemetryInfo,
   telemetry_client_default
-} from "./chunk-NOBEZQXE.mjs";
+} from "./chunk-UYOLJP2E.mjs";
 import {
   __name
 } from "./chunk-FHD4JECV.mjs";
@@ -22,4 +22,4 @@ __name(copilotRuntimeNestEndpoint, "copilotRuntimeNestEndpoint");
 export {
   copilotRuntimeNestEndpoint
 };
-//# sourceMappingURL=chunk-E5I25B3L.mjs.map
+//# sourceMappingURL=chunk-6N7YZABI.mjs.map

package/dist/{chunk-P4G7CDGG.mjs → chunk-RESUQNFX.mjs}

@@ -2,7 +2,7 @@ import {
   copilotRuntimeNodeHttpEndpoint,
   getRuntimeInstanceTelemetryInfo,
   telemetry_client_default
-} from "./chunk-NOBEZQXE.mjs";
+} from "./chunk-UYOLJP2E.mjs";
 import {
   __name
 } from "./chunk-FHD4JECV.mjs";
@@ -22,4 +22,4 @@ __name(copilotRuntimeNodeExpressEndpoint, "copilotRuntimeNodeExpressEndpoint");
 export {
   copilotRuntimeNodeExpressEndpoint
 };
-//# sourceMappingURL=chunk-P4G7CDGG.mjs.map
+//# sourceMappingURL=chunk-RESUQNFX.mjs.map

package/dist/{chunk-JMLO6ZET.mjs → chunk-UXFLLVRF.mjs}

@@ -2,7 +2,7 @@ import {
   getCommonConfig,
   getRuntimeInstanceTelemetryInfo,
   telemetry_client_default
-} from "./chunk-NOBEZQXE.mjs";
+} from "./chunk-UYOLJP2E.mjs";
 import {
   __name
 } from "./chunk-FHD4JECV.mjs";
@@ -77,4 +77,4 @@ export {
   config,
   copilotRuntimeNextJSPagesRouterEndpoint
 };
-//# sourceMappingURL=chunk-JMLO6ZET.mjs.map
+//# sourceMappingURL=chunk-UXFLLVRF.mjs.map

package/dist/{chunk-NOBEZQXE.mjs → chunk-UYOLJP2E.mjs}

@@ -40,7 +40,7 @@ var require_package = __commonJS({
       publishConfig: {
         access: "public"
       },
-      version: "1.8.7",
+      version: "1.8.9",
       sideEffects: false,
       main: "./dist/index.js",
       module: "./dist/index.mjs",
@@ -1796,7 +1796,7 @@ async function execute(args) {
 __name(execute, "execute");
 async function streamEvents(controller, args) {
   var _a, _b, _c, _d, _e, _f, _g, _h, _i;
-  const { deploymentUrl, langsmithApiKey, threadId: argsInitialThreadId, agent, nodeName: initialNodeName, state: initialState, config, messages, actions, logger: logger2, properties, metaEvents } = args;
+  const { deploymentUrl, langsmithApiKey, threadId: argsInitialThreadId, agent, nodeName: initialNodeName, state: initialState, config: explicitConfig, messages, actions, logger: logger2, properties, metaEvents } = args;
   let nodeName = initialNodeName;
   let state = initialState;
   const { name, assistantId: initialAssistantId } = agent;
@@ -1893,11 +1893,15 @@ async function streamEvents(controller, args) {
   const graphInfo = await client.assistants.getGraph(assistantId);
   const graphSchema = await client.assistants.getSchemas(assistantId);
   const schemaKeys = getSchemaKeys(graphSchema);
-  if (config == null ? void 0 : config.configurable) {
-    const filteredConfigurable = (schemaKeys == null ? void 0 : schemaKeys.config) ? filterObjectBySchemaKeys(config == null ? void 0 : config.configurable, schemaKeys == null ? void 0 : schemaKeys.config) : config == null ? void 0 : config.configurable;
+  if (explicitConfig) {
+    let filteredConfigurable = retrievedAssistant.config.configurable ?? {};
+    if (explicitConfig.configurable) {
+      filteredConfigurable = (schemaKeys == null ? void 0 : schemaKeys.config) ? filterObjectBySchemaKeys(explicitConfig == null ? void 0 : explicitConfig.configurable, schemaKeys == null ? void 0 : schemaKeys.config) : explicitConfig == null ? void 0 : explicitConfig.configurable;
+    }
     await client.assistants.update(assistantId, {
       config: {
-        ...config,
+        ...retrievedAssistant.config,
+        ...explicitConfig,
         configurable: filteredConfigurable
       }
     });
@@ -2959,11 +2963,13 @@ 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;
+function extractParametersFromSchema(toolOrSchema) {
+  var _a;
   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) || []);
+  const schema = "schema" in (toolOrSchema || {}) ? toolOrSchema.schema : toolOrSchema;
+  const toolParameters = (schema == null ? void 0 : schema.parameters) || ((_a = schema == null ? void 0 : schema.parameters) == null ? void 0 : _a.jsonSchema);
+  const properties = toolParameters == null ? void 0 : toolParameters.properties;
+  const requiredParams = new Set((toolParameters == null ? void 0 : toolParameters.required) || []);
   if (!properties) {
     return parameters;
   }
@@ -2986,7 +2992,7 @@ __name(extractParametersFromSchema, "extractParametersFromSchema");
 function convertMCPToolsToActions(mcpTools, mcpEndpoint) {
   const actions = [];
   for (const [toolName, tool] of Object.entries(mcpTools)) {
-    const parameters = extractParametersFromSchema(tool.schema);
+    const parameters = extractParametersFromSchema(tool);
     const handler = /* @__PURE__ */ __name(async (params) => {
       try {
         const result = await tool.execute({
@@ -3011,6 +3017,47 @@ function convertMCPToolsToActions(mcpTools, mcpEndpoint) {
   return actions;
 }
 __name(convertMCPToolsToActions, "convertMCPToolsToActions");
+function generateMcpToolInstructions(toolsMap) {
+  if (!toolsMap || Object.keys(toolsMap).length === 0) {
+    return "";
+  }
+  const toolEntries = Object.entries(toolsMap);
+  const toolsDoc = toolEntries.map(([name, tool]) => {
+    let paramsDoc = "    No parameters required";
+    try {
+      if (tool.schema && typeof tool.schema === "object") {
+        const schema = tool.schema;
+        if (schema.properties) {
+          const requiredParams = schema.required || [];
+          const paramsList = Object.entries(schema.properties).map(([paramName, propSchema]) => {
+            const propDetails = propSchema;
+            const requiredMark = requiredParams.includes(paramName) ? "*" : "";
+            const typeInfo = propDetails.type || "any";
+            const description = propDetails.description ? ` - ${propDetails.description}` : "";
+            return `    - ${paramName}${requiredMark} (${typeInfo})${description}`;
+          });
+          if (paramsList.length > 0) {
+            paramsDoc = paramsList.join("\n");
+          }
+        }
+      }
+    } catch (e) {
+      console.error(`Error parsing schema for tool ${name}:`, e);
+    }
+    return `- ${name}: ${tool.description || ""}
+${paramsDoc}`;
+  }).join("\n\n");
+  return `You have access to the following external tools provided by Model Context Protocol (MCP) servers:
+
+${toolsDoc}
+
+When using these tools:
+1. Only provide valid parameters according to their type requirements
+2. Required parameters are marked with *
+3. Format API calls correctly with the expected parameter structure
+4. Always check tool responses to determine your next action`;
+}
+__name(generateMcpToolInstructions, "generateMcpToolInstructions");
 
 // src/lib/runtime/copilot-runtime.ts
 var CopilotRuntime = class {
@@ -3024,7 +3071,7 @@ var CopilotRuntime = class {
   observability;
   availableAgents;
   // +++ MCP Properties +++
-  mcpEndpointsConfig;
+  mcpServersConfig;
   mcpActionCache = /* @__PURE__ */ new Map();
   // --- MCP Properties ---
   // +++ MCP Client Factory +++
@@ -3047,14 +3094,14 @@ var CopilotRuntime = class {
     this.delegateAgentProcessingToServiceAdapter = (params == null ? void 0 : params.delegateAgentProcessingToServiceAdapter) || false;
     this.observability = params == null ? void 0 : params.observability_c;
     this.agents = (params == null ? void 0 : params.agents) ?? {};
-    this.mcpEndpointsConfig = params == null ? void 0 : params.mcpEndpoints;
+    this.mcpServersConfig = params == null ? void 0 : params.mcpServers;
     this.createMCPClientImpl = params == null ? void 0 : params.createMCPClient;
-    if (this.mcpEndpointsConfig && this.mcpEndpointsConfig.length > 0 && !this.createMCPClientImpl) {
+    if (this.mcpServersConfig && this.mcpServersConfig.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`."
+        message: "MCP Integration Error: `mcpServers` 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))) {
+    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.mcpServersConfig) == 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.");
     }
   }
@@ -3064,10 +3111,30 @@ var CopilotRuntime = class {
     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");
+    const uniqueMcpTools = /* @__PURE__ */ new Map();
+    mcpActionsForRequest.forEach((action) => {
+      uniqueMcpTools.set(action.name, action);
+    });
+    const toolsMap = {};
+    Array.from(uniqueMcpTools.values()).forEach((action) => {
+      toolsMap[action.name] = {
+        description: action.description || "",
+        schema: action.parameters ? {
+          parameters: {
+            properties: action.parameters.reduce((acc, p) => ({
+              ...acc,
+              [p.name]: {
+                type: p.type,
+                description: p.description
+              }
+            }), {}),
+            required: action.parameters.filter((p) => p.required).map((p) => p.name)
+          }
+        } : {},
+        execute: async () => ({})
+      };
+    });
+    const mcpToolInstructions = generateMcpToolInstructions(toolsMap);
     if (!mcpToolInstructions) {
       return messages;
     }
@@ -3647,7 +3714,7 @@ please use an LLM adapter instead.`
     }
   }
   async getServerSideActions(request) {
-    var _a;
+    var _a, _b;
     const { graphqlContext, messages: rawMessages, agentStates, url } = request;
     const inputMessages = convertGqlInputToMessages(rawMessages);
     const langserveFunctions = [];
@@ -3677,11 +3744,17 @@ please use an LLM adapter instead.`
     }) : this.actions;
     const requestSpecificMCPActions = [];
     if (this.createMCPClientImpl) {
-      const baseEndpoints = this.mcpEndpointsConfig || [];
-      const requestEndpoints = ((_a = graphqlContext.properties) == null ? void 0 : _a.mcpEndpoints) || [];
+      const baseEndpoints = this.mcpServersConfig || [];
+      const requestEndpoints = ((_a = graphqlContext.properties) == null ? void 0 : _a.mcpServers) || ((_b = graphqlContext.properties) == null ? void 0 : _b.mcpEndpoints) || [];
       const effectiveEndpointsMap = /* @__PURE__ */ new Map();
       [
-        ...baseEndpoints,
+        ...baseEndpoints
+      ].forEach((ep) => {
+        if (ep && ep.endpoint) {
+          effectiveEndpointsMap.set(ep.endpoint, ep);
+        }
+      });
+      [
         ...requestEndpoints
       ].forEach((ep) => {
         if (ep && ep.endpoint) {
@@ -3695,12 +3768,10 @@ please use an LLM adapter instead.`
         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 = [];
@@ -4974,6 +5045,7 @@ __name(copilotRuntimeNodeHttpEndpoint, "copilotRuntimeNodeHttpEndpoint");
 export {
   extractParametersFromSchema,
   convertMCPToolsToActions,
+  generateMcpToolInstructions,
   CopilotRuntime,
   flattenToolCallsNoDuplicates,
   copilotKitEndpoint,
@@ -4988,4 +5060,4 @@ export {
   getCommonConfig,
   copilotRuntimeNodeHttpEndpoint
 };
-//# sourceMappingURL=chunk-NOBEZQXE.mjs.map
+//# sourceMappingURL=chunk-UYOLJP2E.mjs.map