@mcp-use/client 2.4.1 → 2.4.2-canary.0

package/dist/code-mode/connector.d.ts

@@ -1,4 +1,4 @@
-import type { CallToolResult, Tool } from "@modelcontextprotocol/client";
+import type { CallToolResult, ProtocolEra, RequestOptions, Tool } from "@modelcontextprotocol/client";
 import type { MCPClient } from "../core/node.js";
 import { BaseConnector } from "../transport/base.js";
 export declare const CODE_MODE_AGENT_PROMPT = "\n## MCP Code Mode Tool Usage Guide\n\nYou have access to an MCP Code Mode Client that allows you to execute JavaScript/TypeScript code with access to registered tools. Follow this workflow:\n\n### 1. Tool Discovery Phase\n**Always start by discovering available tools:**\n- Tools are organized by server namespace (e.g., `server_name.tool_name`)\n- Use the `search_tools(query, detail_level)` function to find available tools\n- You can access `__tool_namespaces` to see all available server namespaces\n\n```javascript\n// Find all GitHub-related tools\nconst tools = await search_tools(\"github\");\nfor (const tool of tools) {\n    console.log(`${tool.server}.${tool.name}: ${tool.description}`);\n}\n\n// Get only tool names for quick overview\nconst tools = await search_tools(\"\", \"names\");\n```\n\n### 2. Interface Introspection\n**Understand tool contracts before using them:**\n- Use `search_tools` to get tool descriptions and input schemas\n- Look for \"Access as: server.tool(args)\" patterns in descriptions\n\n### 3. Code Execution Guidelines\n**When writing code:**\n- Use `await server.tool({ param: value })` syntax for all tool calls\n- Tools are async functions that return promises\n- You have access to standard JavaScript globals: `console`, `JSON`, `Math`, `Date`, etc.\n- All console output (`console.log`, `console.error`, etc.) is automatically captured and returned\n- Build properly structured input objects based on interface definitions\n- Handle errors appropriately with try/catch blocks\n- Chain tool calls by using results from previous calls\n\n### 4. Best Practices\n- **Discover first, code second**: Always explore available tools before writing execution code\n- **Respect namespaces**: Use full `server.tool` names to avoid conflicts\n- **Minimize Context**: Process large data in code, return only essential results\n- **Error handling**: Wrap tool calls in try/catch for robustness\n- **Data flow**: Chain tools by passing outputs as inputs to subsequent tools\n\n### 5. Available Runtime Context\n- `search_tools(query, detail_level)`: Function to discover tools\n- `__tool_namespaces`: Array of available server namespaces\n- All registered tools as `server.tool` functions\n- Standard JavaScript built-ins for data processing\n\n### Example Workflow\n\n```javascript\n// 1. Discover available tools\nconst github_tools = await search_tools(\"github pull request\");\nconsole.log(`Available GitHub PR tools: ${github_tools.map(t => t.name)}`);\n\n// 2. Call tools with proper parameters\nconst pr = await github.get_pull_request({\n    owner: \"facebook\",\n    repo: \"react\",\n    number: 12345\n});\n\n// 3. Process results\nlet result;\nif (pr.state === 'open' && pr.labels.some(l => l.name === 'bug')) {\n    // 4. Chain with other tools\n    await slack.post_message({\n        channel: \"#bugs\",\n        text: `\uD83D\uDC1B Bug PR needs review: ${pr.title}`\n    });\n    result = \"Notification sent\";\n} else {\n    result = \"No action needed\";\n}\n\n// 5. Return structured results\nreturn {\n    pr_number: pr.number,\n    pr_title: pr.title,\n    action_taken: result\n};\n```\n\nRemember: Always discover and understand available tools before attempting to use them in code execution.\n";
@@ -20,7 +20,57 @@ export declare class CodeModeConnector extends BaseConnector {
     get publicIdentifier(): Record<string, string>;
     private _createToolsList;
     get tools(): Tool[];
+    /**
+     * Returns fresh tools available in code mode.
+     *
+     * @param options - Optional per-request options (e.g. abort signal).
+     * @returns List of Tool objects for execute_code and search_tools.
+     */
+    listTools(options?: RequestOptions): Promise<Tool[]>;
+    get protocolEra(): ProtocolEra | undefined;
+    get negotiatedProtocolVersion(): string | undefined;
     initialize(): Promise<any>;
-    callTool(name: string, args: Record<string, any>): Promise<CallToolResult>;
+    /**
+     * Code mode internal server does not expose resources. Returns an empty list.
+     *
+     * @param _cursor - Optional pagination cursor (unused).
+     * @param options - Optional request options.
+     * @returns Empty resource list.
+     */
+    listResources(_cursor?: string, options?: RequestOptions): Promise<{
+        /** Empty resource list in code mode. */
+        resources: any[];
+    }>;
+    /**
+     * Code mode internal server does not expose resources. Returns an empty list.
+     *
+     * @param options - Optional request options.
+     * @returns Empty resource list.
+     */
+    listAllResources(options?: RequestOptions): Promise<{
+        /** Empty resource list in code mode. */
+        resources: any[];
+    }>;
+    /**
+     * Code mode internal server does not expose resource templates. Returns an empty list.
+     *
+     * @param options - Optional request options.
+     * @returns Empty resource template list.
+     */
+    listResourceTemplates(options?: RequestOptions): Promise<{
+        /** Empty resource template list in code mode. */
+        resourceTemplates: any[];
+    }>;
+    /**
+     * Code mode internal server does not expose prompts. Returns an empty list.
+     *
+     * @param options - Optional request options.
+     * @returns Empty prompt list.
+     */
+    listPrompts(options?: RequestOptions): Promise<{
+        /** Empty prompt list in code mode. */
+        prompts: any[];
+    }>;
+    callTool(name: string, args: Record<string, any>, options?: RequestOptions): Promise<CallToolResult>;
 }
 //# sourceMappingURL=connector.d.ts.map

package/dist/code-mode/connector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connector.d.ts","sourceRoot":"","sources":["../../src/code-mode/connector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,eAAO,MAAM,sBAAsB,0rGAsFlC,CAAC;AAKF;;;;;;;;;GASG;AACH,qBAAa,iBAAkB,SAAQ,aAAa;IAClD,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,SAAS;cAOJ,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5D,IAAI,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAE7C;IAED,OAAO,CAAC,gBAAgB;IA4DxB,IAAI,KAAK,IAAI,IAAI,EAAE,CAElB;IAEK,UAAU,IAAI,OAAO,CAAC,GAAG,CAAC;IAK1B,QAAQ,CACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACxB,OAAO,CAAC,cAAc,CAAC;CAyC3B"}
+{"version":3,"file":"connector.d.ts","sourceRoot":"","sources":["../../src/code-mode/connector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,WAAW,EACX,cAAc,EACd,IAAI,EACL,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,eAAO,MAAM,sBAAsB,0rGAsFlC,CAAC;AAkDF;;;;;;;;;GASG;AACH,qBAAa,iBAAkB,SAAQ,aAAa;IAClD,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,SAAS;cAcJ,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5D,IAAI,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAE7C;IAED,OAAO,CAAC,gBAAgB;IA4DxB,IAAa,KAAK,IAAI,IAAI,EAAE,CAE3B;IAED;;;;;OAKG;IACY,SAAS,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAQnE,IAAa,WAAW,IAAI,WAAW,GAAG,SAAS,CAElD;IAED,IAAa,yBAAyB,IAAI,MAAM,GAAG,SAAS,CAE3D;IAEc,UAAU,IAAI,OAAO,CAAC,GAAG,CAAC;IAezC;;;;;;OAMG;IACY,aAAa,CAC1B,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC;QACT,wCAAwC;QACxC,SAAS,EAAE,GAAG,EAAE,CAAC;KAClB,CAAC;IAQF;;;;;OAKG;IACY,gBAAgB,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC;QACjE,wCAAwC;QACxC,SAAS,EAAE,GAAG,EAAE,CAAC;KAClB,CAAC;IAQF;;;;;OAKG;IACY,qBAAqB,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC;QACtE,iDAAiD;QACjD,iBAAiB,EAAE,GAAG,EAAE,CAAC;KAC1B,CAAC;IAQF;;;;;OAKG;IACY,WAAW,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC;QAC5D,sCAAsC;QACtC,OAAO,EAAE,GAAG,EAAE,CAAC;KAChB,CAAC;IAQa,QAAQ,CACrB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,cAAc,CAAC;CAoD3B"}

package/dist/index-browser.js

@@ -128,7 +128,7 @@ var Logger = class {
 var logger = Logger.get();
 
 // src/utils/version.ts
-var VERSION = "2.4.1";
+var VERSION = "2.4.2-canary.0";
 function getPackageVersion() {
   return VERSION;
 }

package/dist/index.js

@@ -1559,7 +1559,7 @@ init_connector_telemetry();
 init_logging();
 
 // src/utils/version.ts
-var VERSION = "2.4.1";
+var VERSION = "2.4.2-canary.0";
 function getPackageVersion() {
   return VERSION;
 }
@@ -5385,6 +5385,40 @@ return {
 Remember: Always discover and understand available tools before attempting to use them in code execution.
 `;
 var DETAIL_LEVELS = /* @__PURE__ */ new Set(["names", "descriptions", "full"]);
+function throwIfAborted(signal) {
+  if (!signal?.aborted) return;
+  if (typeof signal.throwIfAborted === "function") {
+    signal.throwIfAborted();
+  }
+  throw signal.reason ?? new Error("This operation was aborted");
+}
+function raceAbort(promise, signal) {
+  if (!signal) {
+    return promise;
+  }
+  throwIfAborted(signal);
+  return new Promise((resolve, reject) => {
+    const onAbort = () => {
+      signal.removeEventListener("abort", onAbort);
+      try {
+        throwIfAborted(signal);
+      } catch (err) {
+        reject(err);
+      }
+    };
+    signal.addEventListener("abort", onAbort, { once: true });
+    promise.then(
+      (value) => {
+        signal.removeEventListener("abort", onAbort);
+        resolve(value);
+      },
+      (error) => {
+        signal.removeEventListener("abort", onAbort);
+        reject(error);
+      }
+    );
+  });
+}
 var CodeModeConnector = class extends BaseConnector {
   mcpClient;
   _tools;
@@ -5393,6 +5427,13 @@ var CodeModeConnector = class extends BaseConnector {
     this.mcpClient = client;
     this.connected = true;
     this._tools = this._createToolsList();
+    this.toolsCache = this._tools;
+    this.capabilitiesCache = { tools: {} };
+    this.serverInfoCache = {
+      name: "code_mode",
+      version: "1.0.0",
+      description: "MCP Code Mode Internal Server"
+    };
   }
   async establishTransport() {
   }
@@ -5446,15 +5487,104 @@ var CodeModeConnector = class extends BaseConnector {
   get tools() {
     return this._tools;
   }
+  /**
+   * Returns fresh tools available in code mode.
+   *
+   * @param options - Optional per-request options (e.g. abort signal).
+   * @returns List of Tool objects for execute_code and search_tools.
+   */
+  async listTools(options) {
+    if (!this.connected) {
+      throw new Error("MCP client is not connected");
+    }
+    throwIfAborted(options?.signal);
+    return [...this._tools];
+  }
+  get protocolEra() {
+    return this.connected ? "modern" : void 0;
+  }
+  get negotiatedProtocolVersion() {
+    return this.connected ? "2026-07-28" : void 0;
+  }
   async initialize() {
     this.toolsCache = this._tools;
-    return { capabilities: {}, version: "1.0.0" };
+    this.capabilitiesCache = { tools: {} };
+    this.serverInfoCache = {
+      name: "code_mode",
+      version: "1.0.0",
+      description: "MCP Code Mode Internal Server"
+    };
+    return {
+      capabilities: this.capabilitiesCache,
+      serverInfo: this.serverInfoCache,
+      protocolVersion: "2026-07-28"
+    };
   }
-  async callTool(name, args) {
+  /**
+   * Code mode internal server does not expose resources. Returns an empty list.
+   *
+   * @param _cursor - Optional pagination cursor (unused).
+   * @param options - Optional request options.
+   * @returns Empty resource list.
+   */
+  async listResources(_cursor, options) {
+    if (!this.connected) {
+      throw new Error("MCP client is not connected");
+    }
+    throwIfAborted(options?.signal);
+    return { resources: [] };
+  }
+  /**
+   * Code mode internal server does not expose resources. Returns an empty list.
+   *
+   * @param options - Optional request options.
+   * @returns Empty resource list.
+   */
+  async listAllResources(options) {
+    if (!this.connected) {
+      throw new Error("MCP client is not connected");
+    }
+    throwIfAborted(options?.signal);
+    return { resources: [] };
+  }
+  /**
+   * Code mode internal server does not expose resource templates. Returns an empty list.
+   *
+   * @param options - Optional request options.
+   * @returns Empty resource template list.
+   */
+  async listResourceTemplates(options) {
+    if (!this.connected) {
+      throw new Error("MCP client is not connected");
+    }
+    throwIfAborted(options?.signal);
+    return { resourceTemplates: [] };
+  }
+  /**
+   * Code mode internal server does not expose prompts. Returns an empty list.
+   *
+   * @param options - Optional request options.
+   * @returns Empty prompt list.
+   */
+  async listPrompts(options) {
+    if (!this.connected) {
+      throw new Error("MCP client is not connected");
+    }
+    throwIfAborted(options?.signal);
+    return { prompts: [] };
+  }
+  async callTool(name, args, options) {
+    if (!this.connected) {
+      throw new Error("MCP client is not connected");
+    }
+    throwIfAborted(options?.signal);
     if (name === "execute_code") {
       const code = args.code;
       const timeout = args.timeout || 3e4;
-      const result = await this.mcpClient.executeCode(code, timeout);
+      const result = await raceAbort(
+        this.mcpClient.executeCode(code, timeout),
+        options?.signal
+      );
       return {
         content: [
           {
@@ -5466,9 +5596,12 @@ var CodeModeConnector = class extends BaseConnector {
     } else if (name === "search_tools") {
       const query = args.query || "";
       const detailLevel = args.detail_level;
-      const result = await this.mcpClient.searchTools(
-        query,
-        DETAIL_LEVELS.has(detailLevel) ? detailLevel : "full"
+      const result = await raceAbort(
+        this.mcpClient.searchTools(
+          query,
+          DETAIL_LEVELS.has(detailLevel) ? detailLevel : "full"
+        ),
+        options?.signal
       );
       return {
         content: [