@agentscope-ai/agentscope 0.0.2

package/dist/mcp/index.mjs

@@ -0,0 +1,408 @@
+// src/mcp/http.ts
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import {
+  SSEClientTransport
+} from "@modelcontextprotocol/sdk/client/sse.js";
+import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
+import { ListToolsResultSchema } from "@modelcontextprotocol/sdk/types.js";
+
+// src/mcp/base.ts
+import { CallToolResultSchema } from "@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, 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 StreamableHTTPClientTransport(baseUrl, this.transportOpts);
+    } else {
+      this.transport = new SSEClientTransport(baseUrl, this.transportOpts);
+    }
+    this.client = new 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, 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 StreamableHTTPClientTransport(baseUrl, this.transportOpts) : new SSEClientTransport(baseUrl, this.transportOpts);
+    const client = new 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
+import { Client as Client2 } from "@modelcontextprotocol/sdk/client/index.js";
+import {
+  StdioClientTransport
+} from "@modelcontextprotocol/sdk/client/stdio.js";
+import { ListToolsResultSchema as ListToolsResultSchema2 } from "@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 StdioClientTransport(this.stdioServerParameters);
+    this.client = new Client2({
+      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, ListToolsResultSchema2);
+    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;
+  }
+};
+export {
+  HTTPMCPClient,
+  StdioMCPClient
+};
+//# sourceMappingURL=index.mjs.map

package/dist/mcp/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/mcp/http.ts","../../src/mcp/base.ts","../../src/tool/response.ts","../../src/mcp/stdio.ts"],"sourcesContent":["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":["Client","ListToolsResultSchema","Client","ListToolsResultSchema"]}

package/dist/message/index.d.mts

@@ -0,0 +1,10 @@
+export { M as Msg, c as createMsg, g as getContentBlocks, a as getTextContent } from '../message-CkN21KaY.mjs';
+export { B as Base64Source, C as ContentBlock, D as DataBlock, T as TextBlock, a as ThinkingBlock, b as ToolCallBlock, c as ToolResultBlock, U as URLSource } from '../block-VsnHrllL.mjs';
+import '../index-CAxQAkiP.mjs';
+
+declare enum GenerateReason {
+    AWAITING_TOOL_RESULT = "AWAITING_TOOL_RESULT",
+    AWAITING_USER_CONFIRMATION = "AWAITING_USER_CONFIRMATION"
+}
+
+export { GenerateReason };

package/dist/message/index.d.ts

@@ -0,0 +1,10 @@
+export { M as Msg, c as createMsg, g as getContentBlocks, a as getTextContent } from '../message-CzLeTlua.js';
+export { B as Base64Source, C as ContentBlock, D as DataBlock, T as TextBlock, a as ThinkingBlock, b as ToolCallBlock, c as ToolResultBlock, U as URLSource } from '../block-VsnHrllL.js';
+import '../index-CAxQAkiP.js';
+
+declare enum GenerateReason {
+    AWAITING_TOOL_RESULT = "AWAITING_TOOL_RESULT",
+    AWAITING_USER_CONFIRMATION = "AWAITING_USER_CONFIRMATION"
+}
+
+export { GenerateReason };

package/dist/message/index.js

@@ -0,0 +1,67 @@
+"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/message/index.ts
+var message_exports = {};
+__export(message_exports, {
+  GenerateReason: () => GenerateReason,
+  createMsg: () => createMsg,
+  getContentBlocks: () => getContentBlocks,
+  getTextContent: () => getTextContent
+});
+module.exports = __toCommonJS(message_exports);
+
+// src/message/message.ts
+function createMsg({
+  name,
+  content,
+  role,
+  metadata = {},
+  id = crypto.randomUUID(),
+  timestamp = (/* @__PURE__ */ new Date()).toISOString(),
+  usage
+}) {
+  return { id, name, role, content, metadata, timestamp, usage };
+}
+function getTextContent(msg, separator = "\n") {
+  const textBlocks = msg.content.filter((block) => block.type === "text");
+  if (textBlocks.length === 0) {
+    return null;
+  }
+  return textBlocks.map((block) => block.text).join(separator);
+}
+function getContentBlocks(msg, blockType) {
+  if (!blockType) return msg.content;
+  return msg.content.filter((block) => block.type === blockType);
+}
+
+// src/message/enums.ts
+var GenerateReason = /* @__PURE__ */ ((GenerateReason2) => {
+  GenerateReason2["AWAITING_TOOL_RESULT"] = "AWAITING_TOOL_RESULT";
+  GenerateReason2["AWAITING_USER_CONFIRMATION"] = "AWAITING_USER_CONFIRMATION";
+  return GenerateReason2;
+})(GenerateReason || {});
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  GenerateReason,
+  createMsg,
+  getContentBlocks,
+  getTextContent
+});
+//# sourceMappingURL=index.js.map

package/dist/message/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/message/index.ts","../../src/message/message.ts","../../src/message/enums.ts"],"sourcesContent":["export { Msg, createMsg, getTextContent, getContentBlocks } from './message';\nexport {\n    TextBlock,\n    ThinkingBlock,\n    ToolCallBlock,\n    ToolResultBlock,\n    ContentBlock,\n    Base64Source,\n    URLSource,\n    DataBlock,\n} from './block';\nexport { GenerateReason } from './enums';\n","import { JSONSerializableObject } from '../type';\nimport {\n    ContentBlock,\n    TextBlock,\n    ThinkingBlock,\n    ToolResultBlock,\n    ToolCallBlock,\n    DataBlock,\n} from './block';\n\n/** A chat message exchanged between agents or between an agent and a model. */\nexport interface Msg {\n    /** Unique identifier for the message. */\n    id: string;\n    /** Display name of the message sender. */\n    name: string;\n    /** Conversation role of the sender. */\n    role: 'user' | 'assistant' | 'system';\n    /** Message body. */\n    content: ContentBlock[];\n    /** Arbitrary key-value metadata attached to the message. */\n    metadata: Record<string, JSONSerializableObject>;\n    /** ISO-8601 creation timestamp. */\n    timestamp: string;\n    /** Usage information for the message, such as token counts. */\n    usage?: {\n        inputTokens: number;\n        outputTokens: number;\n    };\n}\n\n/**\n * Create a new {@link Msg} object, filling in `id` and `timestamp` when omitted.\n *\n * @param root0\n * @param root0.name\n * @param root0.content\n * @param root0.role\n * @param root0.metadata\n * @param root0.id\n * @param root0.timestamp\n * @param root0.usage\n * @returns A fully-populated {@link Msg} object.\n */\nexport function createMsg({\n    name,\n    content,\n    role,\n    metadata = {},\n    id = crypto.randomUUID(),\n    timestamp = new Date().toISOString(),\n    usage,\n}: Omit<Msg, 'id' | 'timestamp' | 'metadata'> &\n    Partial<Pick<Msg, 'id' | 'timestamp' | 'metadata'>>): Msg {\n    return { id, name, role, content, metadata, timestamp, usage } as Msg;\n}\n\n/**\n * Extract the plain-text content from a message.\n *\n * When `content` is a string it is returned as-is. When it is an array of\n * content blocks, all {@link TextBlock} texts are joined with `separator`.\n *\n * @param msg - The message to read.\n * @param separator - String inserted between consecutive text blocks. Defaults to `'\\n'`.\n * @returns The concatenated text, or `null` when no text blocks are present.\n */\nexport function getTextContent(msg: Msg, separator: string = '\\n'): string | null {\n    const textBlocks = msg.content.filter(block => block.type === 'text');\n    if (textBlocks.length === 0) {\n        return null;\n    }\n    return textBlocks.map(block => (block as TextBlock).text).join(separator);\n}\n\n/**\n * Return all content blocks from a message, regardless of type.\n *\n * When `content` is a plain string it is wrapped in a single {@link TextBlock}.\n *\n * @param msg - The message to read.\n * @returns An array of all {@link ContentBlock} objects.\n */\nexport function getContentBlocks(msg: Msg): ContentBlock[];\n/**\n * Return all {@link TextBlock} objects from a message.\n *\n * @param msg - The message to read.\n * @param blockType - `'text'`\n * @returns An array of {@link TextBlock} objects.\n */\nexport function getContentBlocks(msg: Msg, blockType: 'text'): TextBlock[];\n/**\n * Return all {@link ThinkingBlock} objects from a message.\n *\n * @param msg - The message to read.\n * @param blockType - `'thinking'`\n * @returns An array of {@link ThinkingBlock} objects.\n */\nexport function getContentBlocks(msg: Msg, blockType: 'thinking'): ThinkingBlock[];\n/**\n * Return all {@link DataBlock} objects from a message.\n *\n * @param msg - The message to read.\n * @param blockType - `'video'`\n * @returns An array of {@link DataBlock} objects.\n */\nexport function getContentBlocks(msg: Msg, blockType: 'data'): DataBlock[];\n/**\n * Return all {@link ToolCallBlock} objects from a message.\n *\n * @param msg - The message to read.\n * @param blockType - `'tool_call'`\n * @returns An array of {@link ToolCallBlock} objects.\n */\nexport function getContentBlocks(msg: Msg, blockType: 'tool_call'): ToolCallBlock[];\n/**\n * Return all {@link ToolResultBlock} objects from a message.\n *\n * @param msg - The message to read.\n * @param blockType - `'tool_result'`\n * @returns An array of {@link ToolResultBlock} objects.\n */\nexport function getContentBlocks(msg: Msg, blockType: 'tool_result'): ToolResultBlock[];\nexport function getContentBlocks(\n    msg: Msg,\n    blockType?: 'text' | 'thinking' | 'data' | 'tool_call' | 'tool_result'\n): ContentBlock[] {\n    if (!blockType) return msg.content;\n    return msg.content.filter(block => block.type === blockType);\n}\n","export enum GenerateReason {\n    AWAITING_TOOL_RESULT = 'AWAITING_TOOL_RESULT',\n    AWAITING_USER_CONFIRMATION = 'AWAITING_USER_CONFIRMATION',\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;AC4CO,SAAS,UAAU;AAAA,EACtB;AAAA,EACA;AAAA,EACA;AAAA,EACA,WAAW,CAAC;AAAA,EACZ,KAAK,OAAO,WAAW;AAAA,EACvB,aAAY,oBAAI,KAAK,GAAE,YAAY;AAAA,EACnC;AACJ,GAC8D;AAC1D,SAAO,EAAE,IAAI,MAAM,MAAM,SAAS,UAAU,WAAW,MAAM;AACjE;AAYO,SAAS,eAAe,KAAU,YAAoB,MAAqB;AAC9E,QAAM,aAAa,IAAI,QAAQ,OAAO,WAAS,MAAM,SAAS,MAAM;AACpE,MAAI,WAAW,WAAW,GAAG;AACzB,WAAO;AAAA,EACX;AACA,SAAO,WAAW,IAAI,WAAU,MAAoB,IAAI,EAAE,KAAK,SAAS;AAC5E;AAmDO,SAAS,iBACZ,KACA,WACc;AACd,MAAI,CAAC,UAAW,QAAO,IAAI;AAC3B,SAAO,IAAI,QAAQ,OAAO,WAAS,MAAM,SAAS,SAAS;AAC/D;;;AClIO,IAAK,iBAAL,kBAAKA,oBAAL;AACH,EAAAA,gBAAA,0BAAuB;AACvB,EAAAA,gBAAA,gCAA6B;AAFrB,SAAAA;AAAA,GAAA;","names":["GenerateReason"]}

package/dist/message/index.mjs

@@ -0,0 +1,37 @@
+// src/message/message.ts
+function createMsg({
+  name,
+  content,
+  role,
+  metadata = {},
+  id = crypto.randomUUID(),
+  timestamp = (/* @__PURE__ */ new Date()).toISOString(),
+  usage
+}) {
+  return { id, name, role, content, metadata, timestamp, usage };
+}
+function getTextContent(msg, separator = "\n") {
+  const textBlocks = msg.content.filter((block) => block.type === "text");
+  if (textBlocks.length === 0) {
+    return null;
+  }
+  return textBlocks.map((block) => block.text).join(separator);
+}
+function getContentBlocks(msg, blockType) {
+  if (!blockType) return msg.content;
+  return msg.content.filter((block) => block.type === blockType);
+}
+
+// src/message/enums.ts
+var GenerateReason = /* @__PURE__ */ ((GenerateReason2) => {
+  GenerateReason2["AWAITING_TOOL_RESULT"] = "AWAITING_TOOL_RESULT";
+  GenerateReason2["AWAITING_USER_CONFIRMATION"] = "AWAITING_USER_CONFIRMATION";
+  return GenerateReason2;
+})(GenerateReason || {});
+export {
+  GenerateReason,
+  createMsg,
+  getContentBlocks,
+  getTextContent
+};
+//# sourceMappingURL=index.mjs.map

package/dist/message/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/message/message.ts","../../src/message/enums.ts"],"sourcesContent":["import { JSONSerializableObject } from '../type';\nimport {\n    ContentBlock,\n    TextBlock,\n    ThinkingBlock,\n    ToolResultBlock,\n    ToolCallBlock,\n    DataBlock,\n} from './block';\n\n/** A chat message exchanged between agents or between an agent and a model. */\nexport interface Msg {\n    /** Unique identifier for the message. */\n    id: string;\n    /** Display name of the message sender. */\n    name: string;\n    /** Conversation role of the sender. */\n    role: 'user' | 'assistant' | 'system';\n    /** Message body. */\n    content: ContentBlock[];\n    /** Arbitrary key-value metadata attached to the message. */\n    metadata: Record<string, JSONSerializableObject>;\n    /** ISO-8601 creation timestamp. */\n    timestamp: string;\n    /** Usage information for the message, such as token counts. */\n    usage?: {\n        inputTokens: number;\n        outputTokens: number;\n    };\n}\n\n/**\n * Create a new {@link Msg} object, filling in `id` and `timestamp` when omitted.\n *\n * @param root0\n * @param root0.name\n * @param root0.content\n * @param root0.role\n * @param root0.metadata\n * @param root0.id\n * @param root0.timestamp\n * @param root0.usage\n * @returns A fully-populated {@link Msg} object.\n */\nexport function createMsg({\n    name,\n    content,\n    role,\n    metadata = {},\n    id = crypto.randomUUID(),\n    timestamp = new Date().toISOString(),\n    usage,\n}: Omit<Msg, 'id' | 'timestamp' | 'metadata'> &\n    Partial<Pick<Msg, 'id' | 'timestamp' | 'metadata'>>): Msg {\n    return { id, name, role, content, metadata, timestamp, usage } as Msg;\n}\n\n/**\n * Extract the plain-text content from a message.\n *\n * When `content` is a string it is returned as-is. When it is an array of\n * content blocks, all {@link TextBlock} texts are joined with `separator`.\n *\n * @param msg - The message to read.\n * @param separator - String inserted between consecutive text blocks. Defaults to `'\\n'`.\n * @returns The concatenated text, or `null` when no text blocks are present.\n */\nexport function getTextContent(msg: Msg, separator: string = '\\n'): string | null {\n    const textBlocks = msg.content.filter(block => block.type === 'text');\n    if (textBlocks.length === 0) {\n        return null;\n    }\n    return textBlocks.map(block => (block as TextBlock).text).join(separator);\n}\n\n/**\n * Return all content blocks from a message, regardless of type.\n *\n * When `content` is a plain string it is wrapped in a single {@link TextBlock}.\n *\n * @param msg - The message to read.\n * @returns An array of all {@link ContentBlock} objects.\n */\nexport function getContentBlocks(msg: Msg): ContentBlock[];\n/**\n * Return all {@link TextBlock} objects from a message.\n *\n * @param msg - The message to read.\n * @param blockType - `'text'`\n * @returns An array of {@link TextBlock} objects.\n */\nexport function getContentBlocks(msg: Msg, blockType: 'text'): TextBlock[];\n/**\n * Return all {@link ThinkingBlock} objects from a message.\n *\n * @param msg - The message to read.\n * @param blockType - `'thinking'`\n * @returns An array of {@link ThinkingBlock} objects.\n */\nexport function getContentBlocks(msg: Msg, blockType: 'thinking'): ThinkingBlock[];\n/**\n * Return all {@link DataBlock} objects from a message.\n *\n * @param msg - The message to read.\n * @param blockType - `'video'`\n * @returns An array of {@link DataBlock} objects.\n */\nexport function getContentBlocks(msg: Msg, blockType: 'data'): DataBlock[];\n/**\n * Return all {@link ToolCallBlock} objects from a message.\n *\n * @param msg - The message to read.\n * @param blockType - `'tool_call'`\n * @returns An array of {@link ToolCallBlock} objects.\n */\nexport function getContentBlocks(msg: Msg, blockType: 'tool_call'): ToolCallBlock[];\n/**\n * Return all {@link ToolResultBlock} objects from a message.\n *\n * @param msg - The message to read.\n * @param blockType - `'tool_result'`\n * @returns An array of {@link ToolResultBlock} objects.\n */\nexport function getContentBlocks(msg: Msg, blockType: 'tool_result'): ToolResultBlock[];\nexport function getContentBlocks(\n    msg: Msg,\n    blockType?: 'text' | 'thinking' | 'data' | 'tool_call' | 'tool_result'\n): ContentBlock[] {\n    if (!blockType) return msg.content;\n    return msg.content.filter(block => block.type === blockType);\n}\n","export enum GenerateReason {\n    AWAITING_TOOL_RESULT = 'AWAITING_TOOL_RESULT',\n    AWAITING_USER_CONFIRMATION = 'AWAITING_USER_CONFIRMATION',\n}\n"],"mappings":";AA4CO,SAAS,UAAU;AAAA,EACtB;AAAA,EACA;AAAA,EACA;AAAA,EACA,WAAW,CAAC;AAAA,EACZ,KAAK,OAAO,WAAW;AAAA,EACvB,aAAY,oBAAI,KAAK,GAAE,YAAY;AAAA,EACnC;AACJ,GAC8D;AAC1D,SAAO,EAAE,IAAI,MAAM,MAAM,SAAS,UAAU,WAAW,MAAM;AACjE;AAYO,SAAS,eAAe,KAAU,YAAoB,MAAqB;AAC9E,QAAM,aAAa,IAAI,QAAQ,OAAO,WAAS,MAAM,SAAS,MAAM;AACpE,MAAI,WAAW,WAAW,GAAG;AACzB,WAAO;AAAA,EACX;AACA,SAAO,WAAW,IAAI,WAAU,MAAoB,IAAI,EAAE,KAAK,SAAS;AAC5E;AAmDO,SAAS,iBACZ,KACA,WACc;AACd,MAAI,CAAC,UAAW,QAAO,IAAI;AAC3B,SAAO,IAAI,QAAQ,OAAO,WAAS,MAAM,SAAS,SAAS;AAC/D;;;AClIO,IAAK,iBAAL,kBAAKA,oBAAL;AACH,EAAAA,gBAAA,0BAAuB;AACvB,EAAAA,gBAAA,gCAA6B;AAFrB,SAAAA;AAAA,GAAA;","names":["GenerateReason"]}