@agentscope-ai/agentscope 0.0.2

package/dist/mcp/index.js

@@ -0,0 +1,432 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/mcp/index.ts
+var mcp_exports = {};
+__export(mcp_exports, {
+  HTTPMCPClient: () => HTTPMCPClient,
+  StdioMCPClient: () => StdioMCPClient
+});
+module.exports = __toCommonJS(mcp_exports);
+
+// src/mcp/http.ts
+var import_client = require("@modelcontextprotocol/sdk/client/index.js");
+var import_sse = require("@modelcontextprotocol/sdk/client/sse.js");
+var import_streamableHttp = require("@modelcontextprotocol/sdk/client/streamableHttp.js");
+var import_types2 = require("@modelcontextprotocol/sdk/types.js");
+
+// src/mcp/base.ts
+var import_types = require("@modelcontextprotocol/sdk/types.js");
+
+// src/tool/response.ts
+function createToolResponse({
+  content,
+  state,
+  id = crypto.randomUUID(),
+  createdAt = (/* @__PURE__ */ new Date()).toISOString(),
+  metadata = {},
+  stream = false,
+  isLast = true,
+  isInterrupted = false
+}) {
+  return {
+    content,
+    id,
+    createdAt,
+    metadata,
+    state,
+    stream,
+    isLast,
+    isInterrupted
+  };
+}
+
+// src/mcp/base.ts
+var MCPTool = class {
+  name;
+  description;
+  inputSchema;
+  requireUserConfirm = false;
+  call;
+  getClient;
+  releaseClient;
+  /**
+   * Initialize an MCPTool instance
+   * @param root0
+   * @param root0.name
+   * @param root0.description
+   * @param root0.inputSchema
+   * @param root0.getClient
+   * @param root0.releaseClient
+   */
+  constructor({
+    name,
+    description,
+    inputSchema,
+    getClient,
+    releaseClient
+  }) {
+    this.name = name;
+    this.description = description;
+    this.inputSchema = inputSchema;
+    this.getClient = getClient;
+    this.releaseClient = releaseClient;
+    this.call = this._call.bind(this);
+  }
+  /**
+   * Call the MCP tool with the specified input arguments. This method sends a request to the MCP server to execute
+   * the tool and returns the result as a ToolResponse.
+   *
+   * @param arguments
+   * @param input
+   * @returns A ToolResponse object containing the result of the tool execution, or an error message if the call fails.
+   */
+  async _call(input) {
+    const client = await this.getClient();
+    try {
+      const request = {
+        method: "tools/call",
+        params: {
+          name: this.name,
+          arguments: input
+        }
+      };
+      const result = await client.request(request, import_types.CallToolResultSchema);
+      const content = [];
+      result.content.forEach((item) => {
+        if (item.type === "text") {
+          content.push({ type: "text", text: item.text, id: crypto.randomUUID() });
+        } else if (item.type === "image" || item.type === "audio") {
+          content.push({
+            id: crypto.randomUUID(),
+            type: "data",
+            source: { type: "base64", mediaType: item.mimeType, data: item.data }
+          });
+        } else {
+          console.warn(
+            `Unsupported content type '${item.type}' in tool result, skipping...`
+          );
+        }
+      });
+      return createToolResponse({ content, state: "success" });
+    } catch (error) {
+      return createToolResponse({
+        content: [
+          {
+            id: crypto.randomUUID(),
+            type: "text",
+            text: `Error calling tool '${this.name}': ${error}`
+          }
+        ],
+        state: "error"
+      });
+    } finally {
+      await this.releaseClient(client);
+    }
+  }
+};
+
+// src/mcp/http.ts
+var HTTPMCPClient = class {
+  name;
+  requestOptions;
+  client;
+  transport;
+  transportType;
+  url;
+  transportOpts;
+  stateful;
+  /**
+   * Initialize the HTTPStatefulMCPClient with the specified transport type, URL, and options.
+   *
+   * @param root0
+   * @param root0.name
+   * @param root0.transportType
+   * @param root0.url
+   * @param root0.stateful
+   * @param root0.transportOpts
+   * @param root0.requestOptions
+   */
+  constructor({
+    name,
+    transportType,
+    url,
+    stateful = true,
+    transportOpts,
+    requestOptions
+  }) {
+    this.name = name;
+    this.transportType = transportType;
+    this.transportOpts = transportOpts;
+    this.requestOptions = requestOptions;
+    this.url = url;
+    this.stateful = stateful;
+  }
+  /**
+   * Connect to the MCP server with the specified transport and URL. This method must be called before making any
+   * requests to the server.
+   */
+  async connect() {
+    if (!this.stateful) {
+      console.log(
+        `MCP client '${this.name}' initialized with stateful=false will connect and close the connection automatically for each request, no need to call 'connect()' method explicitly.`
+      );
+    } else {
+      await this._connect();
+    }
+  }
+  /**
+   * The internal method to establish the connection to the MCP server. It initializes the appropriate transport
+   * based on the specified transport type and creates a new Client instance to manage the connection and requests.
+   */
+  async _connect() {
+    const baseUrl = new URL(this.url);
+    if (this.transportType === "streamable-http") {
+      this.transport = new import_streamableHttp.StreamableHTTPClientTransport(baseUrl, this.transportOpts);
+    } else {
+      this.transport = new import_sse.SSEClientTransport(baseUrl, this.transportOpts);
+    }
+    this.client = new import_client.Client({
+      name: this.name,
+      version: "1.0.0"
+    });
+    await this.client.connect(this.transport, this.requestOptions);
+    console.log(`MCP client '${this.name}' is connected`);
+  }
+  /**
+   * List all tools available on the MCP server.
+   *
+   * @returns An array of MCPTool instances representing the tools available on the server.
+   */
+  async listTools() {
+    let listClient;
+    if (this.stateful) {
+      if (!this.client) {
+        throw new Error(
+          `Client not initialized, call 'connect()' method first for the MCP client named '${this.name}'`
+        );
+      }
+      listClient = this.client;
+    } else {
+      listClient = await this._createClient();
+    }
+    try {
+      const toolsRequest = {
+        method: "tools/list",
+        params: {}
+      };
+      const toolsResult = await listClient.request(toolsRequest, import_types2.ListToolsResultSchema);
+      if (toolsResult.tools === void 0) {
+        return [];
+      }
+      return toolsResult.tools.map((tool) => {
+        if (this.stateful) {
+          return new MCPTool({
+            name: tool.name,
+            description: tool.description || "",
+            inputSchema: tool.inputSchema,
+            getClient: async () => this.client,
+            releaseClient: async () => {
+            }
+          });
+        } else {
+          return new MCPTool({
+            name: tool.name,
+            description: tool.description || "",
+            inputSchema: tool.inputSchema,
+            getClient: () => this._createClient(),
+            releaseClient: async (c) => {
+              await c.close();
+            }
+          });
+        }
+      });
+    } finally {
+      if (!this.stateful) {
+        await listClient.close();
+      }
+    }
+  }
+  /**
+   * Close the connection to the MCP server and clean up any resources used by the client.
+   */
+  async close() {
+    if (!this.stateful) {
+      console.log(
+        `MCP client '${this.name}' initialized with stateful=false will connect and close the connection automatically for each request, no need to call 'close()' method explicitly.`
+      );
+    } else {
+      await this._close();
+    }
+  }
+  /**
+   * The internal method to close the connection to the MCP server.
+   */
+  async _close() {
+    try {
+      await this.client?.close();
+    } finally {
+      console.log(`MCP client '${this.name} is closed.'`);
+      this.client = void 0;
+      this.transport = void 0;
+    }
+  }
+  /**
+   * Create a new client instance without storing it in this.client.
+   * Used for stateless operations where each request needs its own client.
+   * @returns A new connected Client instance
+   */
+  async _createClient() {
+    const baseUrl = new URL(this.url);
+    const transport = this.transportType === "streamable-http" ? new import_streamableHttp.StreamableHTTPClientTransport(baseUrl, this.transportOpts) : new import_sse.SSEClientTransport(baseUrl, this.transportOpts);
+    const client = new import_client.Client({
+      name: this.name,
+      version: "1.0.0"
+    });
+    await client.connect(transport, this.requestOptions);
+    return client;
+  }
+  /**
+   * Get a callable function for a specific tool by its name.
+   * @param root0
+   * @param root0.name
+   * @returns An instance of MCPTool that can be called to execute the tool's functionality.
+   */
+  async getCallableFunction({ name }) {
+    if (this.stateful && !this.client) {
+      throw new Error(
+        `Client not initialized, call 'connect()' method first for the MCP client named '${this.name}'`
+      );
+    }
+    const tools = await this.listTools();
+    const targetTool = tools.find((tool) => tool.name === name);
+    if (!targetTool) {
+      throw new Error(
+        `Tool '${name}' not found in MCP server '${this.name}'. Available tools: ${tools.map((t) => t.name).join(", ")}`
+      );
+    }
+    return targetTool;
+  }
+};
+
+// src/mcp/stdio.ts
+var import_client2 = require("@modelcontextprotocol/sdk/client/index.js");
+var import_stdio = require("@modelcontextprotocol/sdk/client/stdio.js");
+var import_types3 = require("@modelcontextprotocol/sdk/types.js");
+var StdioMCPClient = class {
+  name;
+  stdioServerParameters;
+  transport;
+  client;
+  /**
+   * Initialize the StdioMCPClient with the given Stdio parameters.
+   *
+   * @param root0
+   * @param root0.name
+   */
+  constructor({
+    name,
+    ...rest
+  }) {
+    this.name = name;
+    this.stdioServerParameters = rest;
+  }
+  /**
+   * Connect to the MCP server using Stdio transport. Note the Stdio client will start an
+   * MCP server process under the hood.
+   */
+  async connect() {
+    this.transport = new import_stdio.StdioClientTransport(this.stdioServerParameters);
+    this.client = new import_client2.Client({
+      name: this.name,
+      version: "1.0.0"
+    });
+    await this.client.connect(this.transport);
+  }
+  /**
+   * Close the connection and stop the MCP server process.
+   */
+  async close() {
+    try {
+      if (this.client) {
+        await this.client.close();
+      }
+    } finally {
+      this.client = void 0;
+      this.transport = void 0;
+    }
+  }
+  /**
+   * List all tools available on the MCP server.
+   *
+   * @returns An array of MCPTool instances representing the tools available on the server.
+   */
+  async listTools() {
+    if (!this.client) {
+      throw new Error(
+        `Client not initialized, call 'connect()' method first for the MCP client named '${this.name}'`
+      );
+    }
+    const toolsRequest = {
+      method: "tools/list",
+      params: {}
+    };
+    const toolsResult = await this.client.request(toolsRequest, import_types3.ListToolsResultSchema);
+    if (toolsResult.tools === void 0) {
+      return [];
+    }
+    return toolsResult.tools.map((tool) => {
+      return new MCPTool({
+        name: tool.name,
+        description: tool.description || "",
+        inputSchema: tool.inputSchema,
+        getClient: async () => this.client,
+        releaseClient: async () => {
+        }
+      });
+    });
+  }
+  /**
+   * Get a callable function for a specific tool by its name.
+   * @param root0
+   * @param root0.name
+   * @returns An instance of MCPTool that can be called to execute the tool's functionality.
+   */
+  async getCallableFunction({ name }) {
+    if (!this.client) {
+      throw new Error(
+        `Client not initialized, call 'connect()' method first for the MCP client named '${this.name}'`
+      );
+    }
+    const tools = await this.listTools();
+    const targetTool = tools.find((tool) => tool.name === name);
+    if (!targetTool) {
+      throw new Error(
+        `Tool '${name}' not found in MCP server '${this.name}'. Available tools: ${tools.map((t) => t.name).join(", ")}`
+      );
+    }
+    return targetTool;
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  HTTPMCPClient,
+  StdioMCPClient
+});
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/mcp/index.ts","../../src/mcp/http.ts","../../src/mcp/base.ts","../../src/tool/response.ts","../../src/mcp/stdio.ts"],"sourcesContent":["export * from './http';\nexport * from './stdio';\n","import { Client } from '@modelcontextprotocol/sdk/client/index.js';\nimport {\n    SSEClientTransport,\n    SSEClientTransportOptions,\n} from '@modelcontextprotocol/sdk/client/sse.js';\nimport { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';\nimport { StreamableHTTPClientTransportOptions } from '@modelcontextprotocol/sdk/client/streamableHttp.js';\nimport type { RequestOptions } from '@modelcontextprotocol/sdk/shared/protocol.js';\nimport { ListToolsRequest, ListToolsResultSchema, Tool } from '@modelcontextprotocol/sdk/types.js';\n\nimport { MCPTool } from './base';\n\n/**\n * The HTTP MCP client class that connects to an MCP server using either Streamable HTTP or Server-Sent Events (SSE)\n * transport.\n * Note the client is stateful, meaning that developers should manually call the `connect()` and `close()` methods to\n * manage the connection lifecycle.\n */\nexport class HTTPMCPClient {\n    name: string;\n    private requestOptions?: RequestOptions;\n    private client?: Client;\n    private transport?: StreamableHTTPClientTransport | SSEClientTransport;\n    private transportType: 'streamable-http' | 'sse';\n    private url: string;\n    private transportOpts?: StreamableHTTPClientTransportOptions | SSEClientTransportOptions;\n    private stateful: boolean;\n\n    /**\n     * Initialize the HTTPStatefulMCPClient with the specified transport type, URL, and options.\n     *\n     * @param root0\n     * @param root0.name\n     * @param root0.transportType\n     * @param root0.url\n     * @param root0.stateful\n     * @param root0.transportOpts\n     * @param root0.requestOptions\n     */\n    constructor({\n        name,\n        transportType,\n        url,\n        stateful = true,\n        transportOpts,\n        requestOptions,\n    }: {\n        name: string;\n        transportType: 'streamable-http' | 'sse';\n        url: string;\n        stateful?: boolean;\n        transportOpts?: StreamableHTTPClientTransportOptions | SSEClientTransportOptions;\n        requestOptions?: RequestOptions;\n    }) {\n        this.name = name;\n        this.transportType = transportType;\n        this.transportOpts = transportOpts;\n        this.requestOptions = requestOptions;\n        this.url = url;\n        this.stateful = stateful;\n    }\n\n    /**\n     * Connect to the MCP server with the specified transport and URL. This method must be called before making any\n     * requests to the server.\n     */\n    async connect() {\n        if (!this.stateful) {\n            console.log(\n                `MCP client '${this.name}' initialized with stateful=false will connect and close the connection automatically for each request, no need to call 'connect()' method explicitly.`\n            );\n        } else {\n            await this._connect();\n        }\n    }\n\n    /**\n     * The internal method to establish the connection to the MCP server. It initializes the appropriate transport\n     * based on the specified transport type and creates a new Client instance to manage the connection and requests.\n     */\n    protected async _connect() {\n        const baseUrl = new URL(this.url);\n        if (this.transportType === 'streamable-http') {\n            this.transport = new StreamableHTTPClientTransport(baseUrl, this.transportOpts);\n        } else {\n            this.transport = new SSEClientTransport(baseUrl, this.transportOpts);\n        }\n        this.client = new Client({\n            name: this.name,\n            version: '1.0.0',\n        });\n        await this.client.connect(this.transport, this.requestOptions);\n        console.log(`MCP client '${this.name}' is connected`);\n    }\n\n    /**\n     * List all tools available on the MCP server.\n     *\n     * @returns An array of MCPTool instances representing the tools available on the server.\n     */\n    async listTools(): Promise<MCPTool[]> {\n        let listClient: Client;\n\n        if (this.stateful) {\n            if (!this.client) {\n                throw new Error(\n                    `Client not initialized, call 'connect()' method first for the MCP client named '${this.name}'`\n                );\n            }\n            listClient = this.client;\n        } else {\n            listClient = await this._createClient();\n        }\n\n        try {\n            const toolsRequest: ListToolsRequest = {\n                method: 'tools/list',\n                params: {},\n            };\n\n            const toolsResult = await listClient.request(toolsRequest, ListToolsResultSchema);\n            if (toolsResult.tools === undefined) {\n                return [];\n            }\n\n            return toolsResult.tools.map((tool: Tool) => {\n                if (this.stateful) {\n                    return new MCPTool({\n                        name: tool.name,\n                        description: tool.description || '',\n                        inputSchema: tool.inputSchema,\n                        getClient: async () => this.client!,\n                        releaseClient: async () => {},\n                    });\n                } else {\n                    return new MCPTool({\n                        name: tool.name,\n                        description: tool.description || '',\n                        inputSchema: tool.inputSchema,\n                        getClient: () => this._createClient(),\n                        releaseClient: async (c: Client) => {\n                            await c.close();\n                        },\n                    });\n                }\n            });\n        } finally {\n            if (!this.stateful) {\n                await listClient.close();\n            }\n        }\n    }\n\n    /**\n     * Close the connection to the MCP server and clean up any resources used by the client.\n     */\n    async close() {\n        if (!this.stateful) {\n            console.log(\n                `MCP client '${this.name}' initialized with stateful=false will connect and close the connection automatically for each request, no need to call 'close()' method explicitly.`\n            );\n        } else {\n            await this._close();\n        }\n    }\n\n    /**\n     * The internal method to close the connection to the MCP server.\n     */\n    protected async _close() {\n        try {\n            await this.client?.close();\n        } finally {\n            console.log(`MCP client '${this.name} is closed.'`);\n            this.client = undefined;\n            this.transport = undefined;\n        }\n    }\n\n    /**\n     * Create a new client instance without storing it in this.client.\n     * Used for stateless operations where each request needs its own client.\n     * @returns A new connected Client instance\n     */\n    protected async _createClient(): Promise<Client> {\n        const baseUrl = new URL(this.url);\n        const transport =\n            this.transportType === 'streamable-http'\n                ? new StreamableHTTPClientTransport(baseUrl, this.transportOpts)\n                : new SSEClientTransport(baseUrl, this.transportOpts);\n\n        const client = new Client({\n            name: this.name,\n            version: '1.0.0',\n        });\n        await client.connect(transport, this.requestOptions);\n        return client;\n    }\n\n    /**\n     * Get a callable function for a specific tool by its name.\n     * @param root0\n     * @param root0.name\n     * @returns An instance of MCPTool that can be called to execute the tool's functionality.\n     */\n    async getCallableFunction({ name }: { name: string }) {\n        if (this.stateful && !this.client) {\n            throw new Error(\n                `Client not initialized, call 'connect()' method first for the MCP client named '${this.name}'`\n            );\n        }\n\n        const tools = await this.listTools();\n        const targetTool = tools.find(tool => tool.name === name);\n\n        if (!targetTool) {\n            throw new Error(\n                `Tool '${name}' not found in MCP server '${this.name}'. Available tools: ${tools.map(t => t.name).join(', ')}`\n            );\n        }\n\n        return targetTool;\n    }\n}\n","import { Client } from '@modelcontextprotocol/sdk/client/index.js';\nimport { CallToolRequest, CallToolResultSchema } from '@modelcontextprotocol/sdk/types.js';\nimport z from 'zod';\n\nimport { Tool, ToolResponse } from '../tool';\nimport { createToolResponse } from '../tool/response';\nimport { ToolInputSchema } from '../type';\n\n/**\n * Type definition for getting a client instance\n */\ntype GetClient = () => Promise<Client>;\n\n/**\n * Type definition for releasing a client instance\n */\ntype ReleaseClient = (client: Client) => Promise<void>;\n\n/**\n * MCPTool class that wraps an MCP tool and provides a callable interface\n */\nexport class MCPTool implements Tool {\n    name: string;\n    description: string;\n    inputSchema: z.ZodObject | ToolInputSchema;\n    requireUserConfirm = false;\n    call: (input: Record<string, unknown>) => Promise<ToolResponse>;\n\n    private getClient: GetClient;\n    private releaseClient: ReleaseClient;\n\n    /**\n     * Initialize an MCPTool instance\n     * @param root0\n     * @param root0.name\n     * @param root0.description\n     * @param root0.inputSchema\n     * @param root0.getClient\n     * @param root0.releaseClient\n     */\n    constructor({\n        name,\n        description,\n        inputSchema,\n        getClient,\n        releaseClient,\n    }: {\n        name: string;\n        description: string;\n        inputSchema: z.ZodObject | ToolInputSchema;\n        getClient: GetClient;\n        releaseClient: ReleaseClient;\n    }) {\n        this.name = name;\n        this.description = description;\n        this.inputSchema = inputSchema;\n        this.getClient = getClient;\n        this.releaseClient = releaseClient;\n        this.call = this._call.bind(this);\n    }\n\n    /**\n     * Call the MCP tool with the specified input arguments. This method sends a request to the MCP server to execute\n     * the tool and returns the result as a ToolResponse.\n     *\n     * @param arguments\n     * @param input\n     * @returns A ToolResponse object containing the result of the tool execution, or an error message if the call fails.\n     */\n    async _call(input: Record<string, unknown>) {\n        const client = await this.getClient();\n        try {\n            const request: CallToolRequest = {\n                method: 'tools/call',\n                params: {\n                    name: this.name,\n                    arguments: input,\n                },\n            };\n            const result = await client.request(request, CallToolResultSchema);\n\n            const content: ToolResponse['content'] = [];\n            result.content.forEach(item => {\n                if (item.type === 'text') {\n                    content.push({ type: 'text', text: item.text, id: crypto.randomUUID() });\n                } else if (item.type === 'image' || item.type === 'audio') {\n                    content.push({\n                        id: crypto.randomUUID(),\n                        type: 'data',\n                        source: { type: 'base64', mediaType: item.mimeType, data: item.data },\n                    });\n                } else {\n                    console.warn(\n                        `Unsupported content type '${item.type}' in tool result, skipping...`\n                    );\n                }\n            });\n            return createToolResponse({ content, state: 'success' });\n        } catch (error) {\n            return createToolResponse({\n                content: [\n                    {\n                        id: crypto.randomUUID(),\n                        type: 'text',\n                        text: `Error calling tool '${this.name}': ${error}`,\n                    },\n                ],\n                state: 'error',\n            });\n        } finally {\n            await this.releaseClient(client);\n        }\n    }\n}\n","import { DataBlock, TextBlock } from '../message';\nimport { JSONSerializableObject } from '../type';\n\n/**\n * The tool response structure.\n */\nexport interface ToolResponse {\n    content: Array<TextBlock | DataBlock>;\n    id: string;\n    createdAt: string;\n    metadata: Record<string, JSONSerializableObject>;\n    state: 'success' | 'error' | 'interrupted' | 'running';\n    isLast: boolean;\n    isInterrupted: boolean;\n}\n\n/**\n * Create a tool response object with the given parameters.\n *\n * @param root0\n * @param root0.content\n * @param root0.state\n * @param root0.id\n * @param root0.createdAt\n * @param root0.metadata\n * @param root0.stream\n * @param root0.isLast\n * @param root0.isInterrupted\n * @returns A ToolResponse object\n */\nexport function createToolResponse({\n    content,\n    state,\n    id = crypto.randomUUID(),\n    createdAt = new Date().toISOString(),\n    metadata = {},\n    stream = false,\n    isLast = true,\n    isInterrupted = false,\n}: {\n    content: Array<TextBlock | DataBlock>;\n    state: 'success' | 'error' | 'interrupted' | 'running';\n    id?: string;\n    createdAt?: string;\n    metadata?: Record<string, JSONSerializableObject>;\n    stream?: boolean;\n    isLast?: boolean;\n    isInterrupted?: boolean;\n}) {\n    return {\n        content,\n        id,\n        createdAt,\n        metadata,\n        state,\n        stream,\n        isLast,\n        isInterrupted,\n    } as ToolResponse;\n}\n\n/**\n * If the given object conforms to the ToolResponse structure.\n *\n * @param obj\n * @returns True if the object is a ToolResponse, false otherwise\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function isToolResponse(obj: any): boolean {\n    return (\n        obj &&\n        typeof obj === 'object' &&\n        typeof obj.id === 'string' &&\n        typeof obj.createdAt === 'string' &&\n        Array.isArray(obj.content) &&\n        typeof obj.metadata === 'object' &&\n        typeof obj.stream === 'boolean' &&\n        typeof obj.isLast === 'boolean' &&\n        typeof obj.isInterrupted === 'boolean' &&\n        ['success', 'error', 'interrupted', 'running'].includes(obj.state)\n    );\n}\n","import { Client } from '@modelcontextprotocol/sdk/client/index.js';\nimport {\n    StdioClientTransport,\n    StdioServerParameters,\n} from '@modelcontextprotocol/sdk/client/stdio.js';\nimport { ListToolsRequest, ListToolsResultSchema, Tool } from '@modelcontextprotocol/sdk/types.js';\n\nimport { MCPTool } from './base';\n\n/**\n * The STDIO MCP client class.\n */\nexport class StdioMCPClient {\n    name: string;\n    private stdioServerParameters: StdioServerParameters;\n    private transport?: StdioClientTransport;\n    private client?: Client;\n\n    /**\n     * Initialize the StdioMCPClient with the given Stdio parameters.\n     *\n     * @param root0\n     * @param root0.name\n     */\n    constructor({\n        name,\n        ...rest\n    }: {\n        name: string;\n    } & StdioServerParameters) {\n        this.name = name;\n        this.stdioServerParameters = rest;\n    }\n\n    /**\n     * Connect to the MCP server using Stdio transport. Note the Stdio client will start an\n     * MCP server process under the hood.\n     */\n    async connect() {\n        this.transport = new StdioClientTransport(this.stdioServerParameters);\n        this.client = new Client({\n            name: this.name,\n            version: '1.0.0',\n        });\n        await this.client.connect(this.transport);\n    }\n\n    /**\n     * Close the connection and stop the MCP server process.\n     */\n    async close() {\n        try {\n            if (this.client) {\n                await this.client.close();\n            }\n        } finally {\n            this.client = undefined;\n            this.transport = undefined;\n        }\n    }\n\n    /**\n     * List all tools available on the MCP server.\n     *\n     * @returns An array of MCPTool instances representing the tools available on the server.\n     */\n    async listTools(): Promise<MCPTool[]> {\n        if (!this.client) {\n            throw new Error(\n                `Client not initialized, call 'connect()' method first for the MCP client named '${this.name}'`\n            );\n        }\n\n        const toolsRequest: ListToolsRequest = {\n            method: 'tools/list',\n            params: {},\n        };\n\n        const toolsResult = await this.client.request(toolsRequest, ListToolsResultSchema);\n        if (toolsResult.tools === undefined) {\n            return [];\n        }\n\n        return toolsResult.tools.map((tool: Tool) => {\n            return new MCPTool({\n                name: tool.name,\n                description: tool.description || '',\n                inputSchema: tool.inputSchema,\n                getClient: async () => this.client!,\n                releaseClient: async () => {},\n            });\n        });\n    }\n\n    /**\n     * Get a callable function for a specific tool by its name.\n     * @param root0\n     * @param root0.name\n     * @returns An instance of MCPTool that can be called to execute the tool's functionality.\n     */\n    async getCallableFunction({ name }: { name: string }) {\n        if (!this.client) {\n            throw new Error(\n                `Client not initialized, call 'connect()' method first for the MCP client named '${this.name}'`\n            );\n        }\n\n        const tools = await this.listTools();\n        const targetTool = tools.find(tool => tool.name === name);\n\n        if (!targetTool) {\n            throw new Error(\n                `Tool '${name}' not found in MCP server '${this.name}'. Available tools: ${tools.map(t => t.name).join(', ')}`\n            );\n        }\n\n        return targetTool;\n    }\n}\n"],"mappings":"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","names":["import_types","import_client","import_types"]}