@aigne/core 1.73.0-beta → 1.74.0-beta

package/dist/agents/mcp-agent.mjs

@@ -0,0 +1,303 @@
+import { logger } from "../utils/logger.mjs";
+import { checkArguments, createAccessorArray } from "../utils/type-utils.mjs";
+import { Agent } from "./agent.mjs";
+import { promptFromMCPPrompt, resourceFromMCPResource, toolFromMCPTool } from "../utils/mcp-utils.mjs";
+import { nodejs } from "@aigne/utils/nodejs";
+import { z as z$1 } from "zod";
+import { optionalize } from "@aigne/afs/utils/zod";
+import { createStdioClientTransport } from "@aigne/utils/mcp/stdio-client-transport";
+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 { UriTemplate } from "@modelcontextprotocol/sdk/shared/uriTemplate.js";
+
+//#region src/agents/mcp-agent.ts
+const MCP_AGENT_CLIENT_NAME = "AIGNE/MCPAgent";
+const MCP_AGENT_CLIENT_VERSION = "1.10.0";
+const DEFAULT_MAX_RECONNECTS = 10;
+const DEFAULT_TIMEOUT = () => z$1.coerce.number().int().min(0).safeParse(nodejs.env.MCP_TIMEOUT || nodejs.env.TIMEOUT).data || 6e4;
+function isSSEServerParameters(options) {
+	return "url" in options && typeof options.url === "string";
+}
+function isStdioServerParameters(options) {
+	return "command" in options && typeof options.command === "string";
+}
+function getMCPServerString(options) {
+	if (isSSEServerParameters(options)) return options.url;
+	if (isStdioServerParameters(options)) return `${options.command} ${options.args?.join(" ") || ""}`;
+	return "unknown";
+}
+/**
+* MCPAgent is a specialized agent for interacting with MCP (Model Context Protocol) servers.
+* It provides the ability to connect to remote MCP servers using different transport methods,
+* and access their tools, prompts, and resources.
+*
+* MCPAgent serves as a bridge between your application and MCP servers, allowing you to:
+* - Connect to MCP servers over HTTP/SSE or stdio
+* - Access server tools as agent skills
+* - Utilize server prompts and resources
+* - Manage server connections with automatic reconnection
+*
+* @example
+* Here's an example of creating an MCPAgent with SSE transport:
+* {@includeCode ../../test/agents/mcp-agent.test.ts#example-mcp-agent-from-sse}
+*/
+var MCPAgent = class MCPAgent extends Agent {
+	tag = "MCPAgent";
+	static schema() {
+		return z$1.object({
+			url: optionalize(z$1.string()),
+			command: optionalize(z$1.string()),
+			args: optionalize(z$1.array(z$1.string()))
+		});
+	}
+	static async load(options) {
+		const valid = await MCPAgent.schema().parseAsync(options.parsed);
+		if (!valid.url && !valid.command) throw new Error(`Missing url or command in mcp agent: ${options.filepath}`);
+		return MCPAgent.from({
+			...options.parsed,
+			...valid
+		});
+	}
+	static from(options) {
+		checkArguments("MCPAgent.from", mcpAgentOptionsSchema, options);
+		if (isSSEServerParameters(options)) {
+			const transport = () => {
+				if (options.transport === "streamableHttp") return new StreamableHTTPClientTransport(new URL(options.url), options.opts);
+				return new SSEClientTransport(new URL(options.url), options.opts);
+			};
+			return MCPAgent.fromTransport(transport, options);
+		}
+		if (isStdioServerParameters(options)) {
+			const transport = async () => createStdioClientTransport(options);
+			return MCPAgent.fromTransport(transport, options);
+		}
+		return new MCPAgent(options);
+	}
+	static async fromTransport(transportCreator, options) {
+		const client = new ClientWithReconnect({
+			name: MCP_AGENT_CLIENT_NAME,
+			version: MCP_AGENT_CLIENT_VERSION
+		}, void 0, isSSEServerParameters(options) ? {
+			transportCreator,
+			...options
+		} : void 0);
+		const transport = await transportCreator();
+		logger.debug(`Connecting to MCP server: ${getMCPServerString(options)}`);
+		await client.connect(transport);
+		const mcpServer = getMCPServerName(client);
+		const { tools: isToolsAvailable, prompts: isPromptsAvailable, resources: isResourcesAvailable } = client.getServerCapabilities() ?? {};
+		logger.debug(`Listing tools from ${mcpServer}`);
+		const skills = isToolsAvailable ? await client.listTools().then(({ tools }) => {
+			logger.debug(`Listing tools from ${mcpServer} completed %O`, tools?.map((i) => i.name));
+			return tools.map((tool) => toolFromMCPTool(tool, { client }));
+		}) : void 0;
+		logger.debug(`Listing prompts from ${mcpServer}`);
+		const prompts = isPromptsAvailable ? await client.listPrompts().then(({ prompts: prompts$1 }) => {
+			logger.debug(`Listing prompts from ${mcpServer} completed %O`, prompts$1?.map((i) => i.name));
+			return prompts$1.map((prompt) => promptFromMCPPrompt(prompt, { client }));
+		}) : void 0;
+		logger.debug(`Listing resources from ${mcpServer}`);
+		const resources = isResourcesAvailable ? await Promise.all([client.listResources().catch(() => ({ resources: [] })), client.listResourceTemplates().catch(() => ({ resourceTemplates: [] }))]).then(([{ resources: resources$1 }, { resourceTemplates }]) => {
+			const result = [...resources$1, ...resourceTemplates].map((resource) => resourceFromMCPResource(resource, { client }));
+			logger.debug(`Listing resources from ${mcpServer} completed %O`, result.map((i) => i.name));
+			return result;
+		}) : void 0;
+		return new MCPAgent({
+			name: client.getServerVersion()?.name,
+			client,
+			skills,
+			prompts,
+			resources
+		});
+	}
+	/**
+	* Create an MCPAgent instance directly with a configured client.
+	*
+	* @param options MCPAgent configuration options, including client instance
+	*
+	* @example
+	* Here's an example of creating an MCPAgent with an existing client:
+	* {@includeCode ../../test/agents/mcp-agent.test.ts#example-mcp-agent-direct}
+	*/
+	constructor(options) {
+		super(options);
+		this.client = options.client;
+		if (options.prompts?.length) this.prompts.push(...options.prompts);
+		if (options.resources?.length) this.resources.push(...options.resources);
+	}
+	/**
+	* The MCP client instance used for communication with the MCP server.
+	*
+	* This client manages the connection to the MCP server and provides
+	* methods for interacting with server-provided functionality.
+	*/
+	client;
+	/**
+	* Array of MCP prompts available from the connected server.
+	*
+	* Prompts can be accessed by index or by name.
+	*
+	* @example
+	* Here's an example of accessing prompts:
+	* {@includeCode ../../test/agents/mcp-agent.test.ts#example-mcp-agent-prompts}
+	*/
+	prompts = createAccessorArray([], (arr, name) => arr.find((i) => i.name === name));
+	/**
+	* Array of MCP resources available from the connected server.
+	*
+	* Resources can be accessed by index or by name.
+	*
+	* @example
+	* Here's an example of accessing resources:
+	* {@includeCode ../../test/agents/mcp-agent.test.ts#example-mcp-agent-resources}
+	*/
+	resources = createAccessorArray([], (arr, name) => arr.find((i) => i.name === name));
+	/**
+	* Check if the agent is invokable.
+	*
+	* MCPAgent itself is not directly invokable as it acts as a container
+	* for tools, prompts, and resources. Always returns false.
+	*/
+	get isInvokable() {
+		return false;
+	}
+	/**
+	* Process method required by Agent interface.
+	*
+	* Since MCPAgent itself is not directly invokable, this method
+	* throws an error if called.
+	*
+	* @param _input Input message (unused)
+	* @param _options AgentInvokeOptions (unused)
+	* @throws Error This method always throws an error since MCPAgent is not directly invokable
+	*/
+	async process(_input, _options) {
+		throw new Error("Method not implemented.");
+	}
+	/**
+	* Shut down the agent and close the MCP connection.
+	*
+	* This method cleans up resources and closes the connection
+	* to the MCP server.
+	*
+	* @example
+	* Here's an example of shutting down an MCPAgent:
+	* {@includeCode ../../test/agents/mcp-agent.test.ts#example-mcp-agent-shutdown}
+	*
+	* @example
+	* Here's an example of shutting down an MCPAgent by using statement:
+	* {@includeCode ../../test/agents/mcp-agent.test.ts#example-mcp-agent-shutdown-by-using}
+	*/
+	async shutdown() {
+		await super.shutdown();
+		await this.client.close();
+	}
+};
+var ClientWithReconnect = class extends Client {
+	constructor(info, options, reconnectOptions) {
+		super(info, options);
+		this.reconnectOptions = reconnectOptions;
+	}
+	shouldReconnect({ error }) {
+		const { transportCreator, shouldReconnect, maxReconnects } = this.reconnectOptions || {};
+		if (!transportCreator || maxReconnects === 0) return false;
+		if (!shouldReconnect) return true;
+		return shouldReconnect(error);
+	}
+	async reconnect() {
+		const transportCreator = this.reconnectOptions?.transportCreator;
+		if (!transportCreator) throw new Error("reconnect requires a transportCreator");
+		await (await import("p-retry")).default(async () => {
+			await this.close();
+			await this.connect(await transportCreator(), { timeout: this.reconnectOptions?.timeout ?? DEFAULT_TIMEOUT() });
+		}, {
+			retries: this.reconnectOptions?.maxReconnects ?? DEFAULT_MAX_RECONNECTS,
+			shouldRetry: this.shouldReconnect,
+			onFailedAttempt: (error) => logger.error("Reconnect attempt failed: %O", error)
+		});
+	}
+	async request(request, resultSchema, options) {
+		const mergedOptions = {
+			...options,
+			timeout: options?.timeout ?? DEFAULT_TIMEOUT()
+		};
+		try {
+			return await super.request(request, resultSchema, mergedOptions);
+		} catch (error) {
+			if (this.shouldReconnect(error)) {
+				logger.error("Error occurred, reconnecting to MCP server: %O", error);
+				await this.reconnect();
+				return await super.request(request, resultSchema, mergedOptions);
+			}
+			throw error;
+		}
+	}
+};
+var MCPBase = class extends Agent {
+	tag = "MCPBase";
+	constructor(options) {
+		super(options);
+		this.client = options.client;
+	}
+	client;
+};
+var MCPTool = class extends MCPBase {
+	tag = "MCPTool";
+	async process(input) {
+		return await this.client.callTool({
+			name: this.name,
+			arguments: input
+		});
+	}
+};
+var MCPPrompt = class extends MCPBase {
+	tag = "MCPPrompt";
+	async process(input) {
+		return await this.client.getPrompt({
+			name: this.name,
+			arguments: input
+		});
+	}
+};
+var MCPResource = class extends MCPBase {
+	tag = "MCPResource";
+	constructor(options) {
+		super(options);
+		this.uri = options.uri;
+	}
+	uri;
+	async process(input) {
+		const uri = new UriTemplate(this.uri).expand(input);
+		return await this.client.readResource({ uri });
+	}
+};
+function getMCPServerName(client) {
+	const info = client.getServerVersion();
+	if (!info) return void 0;
+	const { name, version } = info;
+	return `${name}@${version}`;
+}
+const mcpAgentOptionsSchema = z$1.union([
+	z$1.object({
+		client: z$1.instanceof(Client),
+		prompts: z$1.array(z$1.instanceof(MCPPrompt)).optional(),
+		resources: z$1.array(z$1.instanceof(MCPResource)).optional()
+	}),
+	z$1.object({
+		url: z$1.string(),
+		opts: z$1.object({}).optional(),
+		timeout: z$1.number().optional(),
+		maxReconnects: z$1.number().optional(),
+		shouldReconnect: z$1.custom().optional()
+	}),
+	z$1.object({
+		command: z$1.string(),
+		args: z$1.array(z$1.string()).optional(),
+		env: z$1.record(z$1.string(), z$1.string()).optional()
+	})
+]);
+
+//#endregion
+export { MCPAgent, MCPBase, MCPPrompt, MCPResource, MCPTool };
+//# sourceMappingURL=mcp-agent.mjs.map

package/dist/agents/mcp-agent.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-agent.mjs","names":["z","prompts","resources"],"sources":["../../src/agents/mcp-agent.ts"],"sourcesContent":["import { optionalize } from \"@aigne/afs/utils/zod\";\nimport { createStdioClientTransport } from \"@aigne/utils/mcp/stdio-client-transport\";\nimport { nodejs } from \"@aigne/utils/nodejs\";\nimport { Client, type ClientOptions } from \"@modelcontextprotocol/sdk/client/index.js\";\nimport {\n  SSEClientTransport,\n  type SSEClientTransportOptions,\n} from \"@modelcontextprotocol/sdk/client/sse.js\";\nimport type { StdioServerParameters } from \"@modelcontextprotocol/sdk/client/stdio.js\";\nimport {\n  StreamableHTTPClientTransport,\n  type StreamableHTTPClientTransportOptions,\n} from \"@modelcontextprotocol/sdk/client/streamableHttp.js\";\nimport type { RequestOptions } from \"@modelcontextprotocol/sdk/shared/protocol.js\";\nimport type { Transport } from \"@modelcontextprotocol/sdk/shared/transport.js\";\nimport { UriTemplate } from \"@modelcontextprotocol/sdk/shared/uriTemplate.js\";\nimport type {\n  CallToolResult,\n  GetPromptResult,\n  Implementation,\n  ReadResourceResult,\n  Request,\n} from \"@modelcontextprotocol/sdk/types.js\";\nimport type { RetryContext } from \"p-retry\";\nimport { type ZodType, z } from \"zod\";\nimport { logger } from \"../utils/logger.js\";\nimport {\n  promptFromMCPPrompt,\n  resourceFromMCPResource,\n  toolFromMCPTool,\n} from \"../utils/mcp-utils.js\";\nimport { checkArguments, createAccessorArray, type PromiseOrValue } from \"../utils/type-utils.js\";\nimport { Agent, type AgentInvokeOptions, type AgentOptions, type Message } from \"./agent.js\";\n\nconst MCP_AGENT_CLIENT_NAME = \"AIGNE/MCPAgent\";\nconst MCP_AGENT_CLIENT_VERSION = \"1.10.0\"; // This should match the version in package.json\nconst DEFAULT_MAX_RECONNECTS = 10;\nconst DEFAULT_TIMEOUT = () =>\n  z.coerce\n    .number()\n    .int()\n    .min(0)\n    .safeParse(nodejs.env.MCP_TIMEOUT || nodejs.env.TIMEOUT).data || 60e3;\n\nexport interface MCPAgentOptions extends AgentOptions {\n  client: Client;\n\n  prompts?: MCPPrompt[];\n\n  resources?: MCPResource[];\n}\n\nexport type MCPServerOptions = SSEServerParameters | StdioServerParameters;\n\nexport type SSEServerParameters = {\n  url: string;\n\n  /**\n   * Whether to use the StreamableHTTPClientTransport instead of the SSEClientTransport.\n   * @default \"sse\"\n   */\n  transport?: \"sse\" | \"streamableHttp\";\n\n  /**\n   * Additional options to pass to the SSEClientTransport or StreamableHTTPClientTransport.\n   */\n  opts?: SSEClientTransportOptions | StreamableHTTPClientTransportOptions;\n  /**\n   * The timeout for requests to the server, in milliseconds.\n   * @default 60000\n   */\n  timeout?: number;\n  /**\n   * Whether to automatically reconnect to the server if the connection is lost.\n   * @default 10 set to 0 to disable automatic reconnection\n   */\n  maxReconnects?: number;\n  /**\n   * A function that determines whether to reconnect to the server based on the error.\n   * default to reconnect on all errors.\n   */\n  shouldReconnect?: (error: Error) => boolean;\n};\n\nfunction isSSEServerParameters(\n  options: MCPAgentOptions | MCPServerOptions,\n): options is SSEServerParameters {\n  return \"url\" in options && typeof options.url === \"string\";\n}\n\nfunction isStdioServerParameters(\n  options: MCPAgentOptions | MCPServerOptions,\n): options is StdioServerParameters {\n  return \"command\" in options && typeof options.command === \"string\";\n}\n\nfunction getMCPServerString(options: MCPAgentOptions | MCPServerOptions): string {\n  if (isSSEServerParameters(options)) {\n    return options.url;\n  }\n\n  if (isStdioServerParameters(options)) {\n    return `${options.command} ${options.args?.join(\" \") || \"\"}`;\n  }\n\n  return \"unknown\";\n}\n\n/**\n * MCPAgent is a specialized agent for interacting with MCP (Model Context Protocol) servers.\n * It provides the ability to connect to remote MCP servers using different transport methods,\n * and access their tools, prompts, and resources.\n *\n * MCPAgent serves as a bridge between your application and MCP servers, allowing you to:\n * - Connect to MCP servers over HTTP/SSE or stdio\n * - Access server tools as agent skills\n * - Utilize server prompts and resources\n * - Manage server connections with automatic reconnection\n *\n * @example\n * Here's an example of creating an MCPAgent with SSE transport:\n * {@includeCode ../../test/agents/mcp-agent.test.ts#example-mcp-agent-from-sse}\n */\nexport class MCPAgent extends Agent {\n  override tag = \"MCPAgent\";\n\n  static schema() {\n    return z.object({\n      url: optionalize(z.string()),\n      command: optionalize(z.string()),\n      args: optionalize(z.array(z.string())),\n    });\n  }\n\n  static override async load<I extends Message = any, O extends Message = any>(options: {\n    filepath: string;\n    parsed: object;\n  }): Promise<Agent<I, O>> {\n    const valid = await MCPAgent.schema().parseAsync(options.parsed);\n\n    if (!valid.url && !valid.command) {\n      throw new Error(`Missing url or command in mcp agent: ${options.filepath}`);\n    }\n\n    return MCPAgent.from({\n      ...options.parsed,\n      ...valid,\n    } as any) as any;\n  }\n\n  /**\n   * Create an MCPAgent from a connection to an SSE server.\n   *\n   * This overload establishes a Server-Sent Events connection to an MCP server\n   * and automatically discovers its available tools, prompts, and resources.\n   *\n   * @param options SSE server connection parameters\n   * @returns Promise resolving to a new MCPAgent instance\n   *\n   * @example\n   * Here's an example of creating an MCPAgent with StreamableHTTP transport:\n   * {@includeCode ../../test/agents/mcp-agent.test.ts#example-mcp-agent-from-streamable-http}\n   *\n   * @example\n   * Here's an example of creating an MCPAgent with SSE transport:\n   * {@includeCode ../../test/agents/mcp-agent.test.ts#example-mcp-agent-from-sse}\n   *\n   * @example\n   * Here's an example of creating an MCPAgent with Stdio transport:\n   * {@includeCode ../../test/agents/mcp-agent.test.ts#example-mcp-agent-from-stdio}\n   */\n  static from(options: MCPServerOptions): Promise<MCPAgent>;\n\n  /**\n   * Create an MCPAgent from a pre-configured MCP client.\n   *\n   * This overload uses an existing MCP client instance and optionally\n   * pre-defined prompts and resources.\n   *\n   * @param options MCPAgent configuration with client instance\n   * @returns A new MCPAgent instance\n   *\n   * @example\n   * Here's an example of creating an MCPAgent with a client instance:\n   * {@includeCode ../../test/agents/mcp-agent.test.ts#example-mcp-agent-direct}\n   */\n  static from(options: MCPAgentOptions): MCPAgent;\n\n  static from(options: MCPAgentOptions | MCPServerOptions): MCPAgent | Promise<MCPAgent> {\n    checkArguments(\"MCPAgent.from\", mcpAgentOptionsSchema, options);\n\n    if (isSSEServerParameters(options)) {\n      const transport = () => {\n        if (options.transport === \"streamableHttp\") {\n          return new StreamableHTTPClientTransport(new URL(options.url), options.opts);\n        }\n        return new SSEClientTransport(new URL(options.url), options.opts);\n      };\n\n      return MCPAgent.fromTransport(transport, options);\n    }\n\n    if (isStdioServerParameters(options)) {\n      const transport = async () => createStdioClientTransport(options);\n      return MCPAgent.fromTransport(transport, options);\n    }\n\n    return new MCPAgent(options);\n  }\n\n  private static async fromTransport(\n    transportCreator: () => PromiseOrValue<Transport>,\n    options: MCPAgentOptions | MCPServerOptions,\n  ): Promise<MCPAgent> {\n    const client = new ClientWithReconnect(\n      {\n        name: MCP_AGENT_CLIENT_NAME,\n        version: MCP_AGENT_CLIENT_VERSION,\n      },\n      undefined,\n      isSSEServerParameters(options) ? { transportCreator, ...options } : undefined,\n    );\n\n    const transport = await transportCreator();\n\n    logger.debug(`Connecting to MCP server: ${getMCPServerString(options)}`);\n    await client.connect(transport);\n\n    const mcpServer = getMCPServerName(client);\n\n    const {\n      tools: isToolsAvailable,\n      prompts: isPromptsAvailable,\n      resources: isResourcesAvailable,\n    } = client.getServerCapabilities() ?? {};\n\n    logger.debug(`Listing tools from ${mcpServer}`);\n    const skills = isToolsAvailable\n      ? await client.listTools().then(({ tools }) => {\n          logger.debug(\n            `Listing tools from ${mcpServer} completed %O`,\n            tools?.map((i) => i.name),\n          );\n          return tools.map((tool) => toolFromMCPTool(tool, { client }));\n        })\n      : undefined;\n\n    logger.debug(`Listing prompts from ${mcpServer}`);\n    const prompts = isPromptsAvailable\n      ? await client.listPrompts().then(({ prompts }) => {\n          logger.debug(\n            `Listing prompts from ${mcpServer} completed %O`,\n            prompts?.map((i) => i.name),\n          );\n          return prompts.map((prompt) => promptFromMCPPrompt(prompt, { client }));\n        })\n      : undefined;\n\n    logger.debug(`Listing resources from ${mcpServer}`);\n    // TODO: should conditionally call listResourceTemplates based on the server capabilities\n    // but the capability is not correct in the current SDK version\n    const resources = isResourcesAvailable\n      ? await Promise.all([\n          client.listResources().catch(() => ({ resources: [] })),\n          client.listResourceTemplates().catch(() => ({ resourceTemplates: [] })),\n        ]).then(([{ resources }, { resourceTemplates }]) => {\n          const result = [...resources, ...resourceTemplates].map((resource) =>\n            resourceFromMCPResource(resource, { client }),\n          );\n          logger.debug(\n            `Listing resources from ${mcpServer} completed %O`,\n            result.map((i) => i.name),\n          );\n          return result;\n        })\n      : undefined;\n\n    return new MCPAgent({\n      name: client.getServerVersion()?.name,\n      client,\n      skills,\n      prompts,\n      resources,\n    });\n  }\n\n  /**\n   * Create an MCPAgent instance directly with a configured client.\n   *\n   * @param options MCPAgent configuration options, including client instance\n   *\n   * @example\n   * Here's an example of creating an MCPAgent with an existing client:\n   * {@includeCode ../../test/agents/mcp-agent.test.ts#example-mcp-agent-direct}\n   */\n  constructor(options: MCPAgentOptions) {\n    super(options);\n\n    this.client = options.client;\n    if (options.prompts?.length) this.prompts.push(...options.prompts);\n    if (options.resources?.length) this.resources.push(...options.resources);\n  }\n\n  /**\n   * The MCP client instance used for communication with the MCP server.\n   *\n   * This client manages the connection to the MCP server and provides\n   * methods for interacting with server-provided functionality.\n   */\n  client: Client;\n\n  /**\n   * Array of MCP prompts available from the connected server.\n   *\n   * Prompts can be accessed by index or by name.\n   *\n   * @example\n   * Here's an example of accessing prompts:\n   * {@includeCode ../../test/agents/mcp-agent.test.ts#example-mcp-agent-prompts}\n   */\n  readonly prompts = createAccessorArray<MCPPrompt>([], (arr, name) =>\n    arr.find((i) => i.name === name),\n  );\n\n  /**\n   * Array of MCP resources available from the connected server.\n   *\n   * Resources can be accessed by index or by name.\n   *\n   * @example\n   * Here's an example of accessing resources:\n   * {@includeCode ../../test/agents/mcp-agent.test.ts#example-mcp-agent-resources}\n   */\n  readonly resources = createAccessorArray<MCPResource>([], (arr, name) =>\n    arr.find((i) => i.name === name),\n  );\n\n  /**\n   * Check if the agent is invokable.\n   *\n   * MCPAgent itself is not directly invokable as it acts as a container\n   * for tools, prompts, and resources. Always returns false.\n   */\n  override get isInvokable(): boolean {\n    return false;\n  }\n\n  /**\n   * Process method required by Agent interface.\n   *\n   * Since MCPAgent itself is not directly invokable, this method\n   * throws an error if called.\n   *\n   * @param _input Input message (unused)\n   * @param _options AgentInvokeOptions (unused)\n   * @throws Error This method always throws an error since MCPAgent is not directly invokable\n   */\n  async process(_input: Message, _options: AgentInvokeOptions): Promise<Message> {\n    throw new Error(\"Method not implemented.\");\n  }\n\n  /**\n   * Shut down the agent and close the MCP connection.\n   *\n   * This method cleans up resources and closes the connection\n   * to the MCP server.\n   *\n   * @example\n   * Here's an example of shutting down an MCPAgent:\n   * {@includeCode ../../test/agents/mcp-agent.test.ts#example-mcp-agent-shutdown}\n   *\n   * @example\n   * Here's an example of shutting down an MCPAgent by using statement:\n   * {@includeCode ../../test/agents/mcp-agent.test.ts#example-mcp-agent-shutdown-by-using}\n   */\n  override async shutdown() {\n    await super.shutdown();\n    await this.client.close();\n  }\n}\n\nexport interface ClientWithReconnectOptions {\n  transportCreator?: () => PromiseOrValue<Transport>;\n  timeout?: number;\n  maxReconnects?: number;\n  shouldReconnect?: (error: Error) => boolean;\n}\n\nclass ClientWithReconnect extends Client {\n  constructor(\n    info: Implementation,\n    options?: ClientOptions,\n    private reconnectOptions?: ClientWithReconnectOptions,\n  ) {\n    super(info, options);\n  }\n\n  private shouldReconnect({ error }: RetryContext): boolean {\n    const { transportCreator, shouldReconnect, maxReconnects } = this.reconnectOptions || {};\n\n    if (!transportCreator || maxReconnects === 0) return false;\n    if (!shouldReconnect) return true; // default to reconnect on all errors\n\n    return shouldReconnect(error);\n  }\n\n  private async reconnect() {\n    const transportCreator = this.reconnectOptions?.transportCreator;\n    if (!transportCreator) throw new Error(\"reconnect requires a transportCreator\");\n\n    const retry = await import(\"p-retry\");\n    await retry.default(\n      async () => {\n        await this.close();\n        await this.connect(await transportCreator(), {\n          timeout: this.reconnectOptions?.timeout ?? DEFAULT_TIMEOUT(),\n        });\n      },\n      {\n        retries: this.reconnectOptions?.maxReconnects ?? DEFAULT_MAX_RECONNECTS,\n        shouldRetry: this.shouldReconnect,\n        onFailedAttempt: (error) => logger.error(\"Reconnect attempt failed: %O\", error),\n      },\n    );\n  }\n\n  override async request<T extends ZodType<object>>(\n    request: Request,\n    resultSchema: T,\n    options?: RequestOptions,\n  ): Promise<z.infer<T>> {\n    const mergedOptions: RequestOptions = {\n      ...options,\n      timeout: options?.timeout ?? DEFAULT_TIMEOUT(),\n    };\n\n    try {\n      return await super.request(request, resultSchema, mergedOptions);\n    } catch (error) {\n      if (this.shouldReconnect(error)) {\n        logger.error(\"Error occurred, reconnecting to MCP server: %O\", error);\n        await this.reconnect();\n        return await super.request(request, resultSchema, mergedOptions);\n      }\n      throw error;\n    }\n  }\n}\n\nexport interface MCPBaseOptions<I extends Message = any, O extends Message = any>\n  extends AgentOptions<I, O> {\n  client: ClientWithReconnect;\n}\n\nexport abstract class MCPBase<I extends Message, O extends Message> extends Agent<I, O> {\n  override tag = \"MCPBase\";\n\n  constructor(options: MCPBaseOptions<I, O>) {\n    super(options);\n    this.client = options.client;\n  }\n\n  protected client: ClientWithReconnect;\n}\n\nexport class MCPTool extends MCPBase<Message, CallToolResult> {\n  override tag = \"MCPTool\";\n\n  async process(input: Message): Promise<CallToolResult> {\n    const result = await this.client.callTool({ name: this.name, arguments: input });\n\n    return result as CallToolResult;\n  }\n}\n\nexport interface MCPPromptInput extends Record<string, unknown> {\n  [key: string]: string;\n}\n\nexport class MCPPrompt extends MCPBase<MCPPromptInput, GetPromptResult> {\n  override tag = \"MCPPrompt\";\n\n  async process(input: MCPPromptInput): Promise<GetPromptResult> {\n    const result = await this.client.getPrompt({ name: this.name, arguments: input });\n\n    return result;\n  }\n}\n\nexport interface MCPResourceOptions extends MCPBaseOptions<MCPPromptInput, ReadResourceResult> {\n  uri: string;\n}\n\nexport class MCPResource extends MCPBase<MCPPromptInput, ReadResourceResult> {\n  override tag = \"MCPResource\";\n\n  constructor(options: MCPResourceOptions) {\n    super(options);\n    this.uri = options.uri;\n  }\n\n  uri: string;\n\n  async process(input: MCPPromptInput): Promise<ReadResourceResult> {\n    const uri = new UriTemplate(this.uri).expand(input);\n\n    const result = await this.client.readResource({ uri });\n\n    return result;\n  }\n}\n\nfunction getMCPServerName(client: Client): string | undefined {\n  const info = client.getServerVersion();\n  if (!info) return undefined;\n\n  const { name, version } = info;\n  return `${name}@${version}`;\n}\n\nconst mcpAgentOptionsSchema: ZodType<\n  MCPAgentOptions | SSEServerParameters | StdioServerParameters\n> = z.union([\n  z.object({\n    client: z.instanceof(Client),\n    prompts: z.array(z.instanceof(MCPPrompt)).optional(),\n    resources: z.array(z.instanceof(MCPResource)).optional(),\n  }),\n  z.object({\n    url: z.string(),\n    opts: z.object({}).optional(),\n    timeout: z.number().optional(),\n    maxReconnects: z.number().optional(),\n    shouldReconnect: z.custom<SSEServerParameters[\"shouldReconnect\"]>().optional(),\n  }),\n  z.object({\n    command: z.string(),\n    args: z.array(z.string()).optional(),\n    env: z.record(z.string(), z.string()).optional(),\n  }),\n]);\n"],"mappings":"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"}

package/dist/agents/model.cjs

@@ -0,0 +1,143 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+const require_utils_type_utils = require('../utils/type-utils.cjs');
+const require_agent = require('./agent.cjs');
+const require_utils_fetch = require('../utils/fetch.cjs');
+let _aigne_utils_nodejs = require("@aigne/utils/nodejs");
+let ufo = require("ufo");
+let zod = require("zod");
+let _aigne_afs_utils_zod = require("@aigne/afs/utils/zod");
+let _aigne_uuid = require("@aigne/uuid");
+
+//#region src/agents/model.ts
+var Model = class Model extends require_agent.Agent {
+	constructor(options) {
+		super(options);
+		this.options = options;
+	}
+	/**
+	* Resolves model options by merging instance-level and input-level options,
+	* and recursively resolving getter patterns
+	*
+	* @param input - The input message containing potential modelOptions
+	* @param options - The agent invocation options containing context
+	* @returns Resolved model options with all getters replaced by actual values
+	*/
+	async getModelOptions(input, options) {
+		const resolveGetters = (obj) => {
+			if (!obj || typeof obj !== "object") return obj;
+			if (require_agent.DEFAULT_INPUT_ACTION_GET in obj && typeof obj[require_agent.DEFAULT_INPUT_ACTION_GET] === "string") {
+				const getterPath = obj[require_agent.DEFAULT_INPUT_ACTION_GET];
+				const value = input[getterPath] ?? options.context.userContext[getterPath];
+				return require_utils_type_utils.isNil(value) ? void 0 : value;
+			}
+			if (Array.isArray(obj)) return obj.map((item) => resolveGetters(item));
+			return Object.entries(obj).reduce((resolved, [key, val]) => {
+				const resolvedValue = resolveGetters(val);
+				if (!require_utils_type_utils.isNil(resolvedValue)) resolved[key] = resolvedValue;
+				return resolved;
+			}, {});
+		};
+		return resolveGetters({
+			...this.options?.modelOptions,
+			..."modelOptions" in input ? input.modelOptions : {}
+		});
+	}
+	async preprocess(input, options) {
+		Object.assign(input, { modelOptions: await this.getModelOptions(input, options) });
+		return super.preprocess(input, options);
+	}
+	async transformFileType(fileType = "local", data) {
+		if (fileType === data.type) return data;
+		const common = require_utils_type_utils.pick(data, "filename", "mimeType");
+		switch (fileType) {
+			case "local": {
+				const dir = _aigne_utils_nodejs.nodejs.path.join(_aigne_utils_nodejs.nodejs.os.tmpdir(), (0, _aigne_uuid.v7)());
+				await _aigne_utils_nodejs.nodejs.fs.mkdir(dir, { recursive: true });
+				const ext = await Model.getFileExtension(data.mimeType || data.filename || "");
+				const id = (0, _aigne_uuid.v7)();
+				const filename = ext ? `${id}.${ext}` : id;
+				const path = _aigne_utils_nodejs.nodejs.path.join(dir, filename);
+				let mimeType = data.mimeType;
+				if (data.type === "file") {
+					await _aigne_utils_nodejs.nodejs.fs.writeFile(path, data.data, "base64");
+					mimeType ||= await Model.getMimeType(data.filename || "");
+				} else if (data.type === "url") {
+					await this.downloadFile(data.url).then((res) => res.body).then((body) => body && _aigne_utils_nodejs.nodejs.fs.writeFile(path, body));
+					mimeType ||= await Model.getMimeType(data.filename || (0, ufo.parseURL)(data.url).pathname);
+				} else throw new Error(`Unexpected file type: ${data.type}`);
+				return {
+					...common,
+					type: "local",
+					path,
+					mimeType
+				};
+			}
+			case "file": {
+				let base64;
+				let mimeType = data.mimeType;
+				if (data.type === "local") {
+					base64 = await _aigne_utils_nodejs.nodejs.fs.readFile(data.path, "base64");
+					mimeType ||= await Model.getMimeType(data.filename || data.path);
+				} else if (data.type === "url") {
+					base64 = Buffer.from(await (await this.downloadFile(data.url)).arrayBuffer()).toString("base64");
+					mimeType ||= await Model.getMimeType(data.filename || (0, ufo.parseURL)(data.url).pathname);
+				} else throw new Error(`Unexpected file type: ${data.type}`);
+				return {
+					...common,
+					type: "file",
+					data: base64,
+					mimeType
+				};
+			}
+			default: return data;
+		}
+	}
+	static async getFileExtension(type) {
+		const { default: mime } = await import("mime");
+		return mime.getExtension(type) || void 0;
+	}
+	static async getMimeType(filename) {
+		const { default: mime } = await import("mime");
+		return mime.getType(filename) || void 0;
+	}
+	async downloadFile(url) {
+		return await require_utils_fetch.fetch(url);
+	}
+};
+const fileTypeSchema = zod.z.enum([
+	"local",
+	"file",
+	"url"
+]);
+const fileContentBaseSchema = zod.z.object({
+	filename: (0, _aigne_afs_utils_zod.optionalize)(zod.z.string()),
+	mimeType: (0, _aigne_afs_utils_zod.optionalize)(zod.z.string())
+});
+const urlContentSchema = fileContentBaseSchema.extend({
+	type: zod.z.literal("url"),
+	url: zod.z.string()
+});
+const fileContentSchema = fileContentBaseSchema.extend({
+	type: zod.z.literal("file"),
+	data: zod.z.string()
+});
+const localContentSchema = fileContentBaseSchema.extend({
+	type: zod.z.literal("local"),
+	path: zod.z.string()
+});
+const fileUnionContentSchema = zod.z.discriminatedUnion("type", [
+	localContentSchema,
+	urlContentSchema,
+	fileContentSchema
+]);
+const fileUnionContentsSchema = zod.z.union([fileUnionContentSchema, zod.z.array(fileUnionContentSchema)]);
+
+//#endregion
+exports.Model = Model;
+exports.fileContentBaseSchema = fileContentBaseSchema;
+exports.fileContentSchema = fileContentSchema;
+exports.fileTypeSchema = fileTypeSchema;
+exports.fileUnionContentSchema = fileUnionContentSchema;
+exports.fileUnionContentsSchema = fileUnionContentsSchema;
+exports.localContentSchema = localContentSchema;
+exports.urlContentSchema = urlContentSchema;