mcp-use 0.0.1 → 0.0.4

package/README.md

@@ -1,7 +1,7 @@
 <h1 align="center">Unified MCP Client Library</h1>
 
-[![](https://img.shields.io/npm/dw/@modelcontextprotocol/mcp-client.svg)](https://www.npmjs.com/package/@modelcontextprotocol/mcp-client)
-[![npm version](https://img.shields.io/npm/v/@modelcontextprotocol/mcp-client.svg)](https://www.npmjs.com/package/@modelcontextprotocol/mcp-client)
+[![](https://img.shields.io/npm/dw/mcp-use.svg)](https://www.npmjs.com/package/mcp-use)
+[![npm version](https://img.shields.io/npm/v/mcp-use.svg)](https://www.npmjs.com/package/mcp-use)
 [![License](https://img.shields.io/github/license/zandko/mcp-use)](https://github.com/zandko/mcp-use/blob/main/LICENSE)
 [![Code style: ESLint](https://img.shields.io/badge/code%20style-eslint-4B32C3.svg)](https://eslint.org)
 [![GitHub stars](https://img.shields.io/github/stars/zandko/mcp-use?style=social)](https://github.com/zandko/mcp-use/stargazers)
@@ -28,6 +28,11 @@
 
 ## 🚀 Quick Start
 
+### Requirements
+
+- Node.js 22.0.0 or higher
+- npm, yarn, or pnpm (examples use pnpm)
+
 ### Installation
 
 ```bash
@@ -125,6 +130,22 @@ const agent = new MCPAgent({
 })
 ```
 
+## 👥 Contributors
+
+<table>
+<tr>
+    <td align="center" style="word-wrap: break-word; width: 150.0; height: 150.0">
+        <a href=https://github.com/zandko>
+            <img src=https://avatars.githubusercontent.com/u/37948383?v=4 width="100;"  style="border-radius:50%;align-items:center;justify-content:center;overflow:hidden;padding-top:10px" alt=Zane/>
+            <br />
+            <sub style="font-size:14px"><b>Zane</b></sub>
+        </a>
+    </td>
+</tr>
+</table>
+
+<!-- Contributors section will be automatically generated here -->
+
 ## 📜 License
 
 MIT © [Zane](https://github.com/zandko)

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+import { MCPAgent } from './src/agents/mcp_agent.js';
+import { MCPClient } from './src/client.js';
+import { loadConfigFile } from './src/config.js';
+import { BaseConnector } from './src/connectors/base.js';
+import { HttpConnector } from './src/connectors/http.js';
+import { StdioConnector } from './src/connectors/stdio.js';
+import { WebSocketConnector } from './src/connectors/websocket.js';
+import { Logger, logger } from './src/logging.js';
+import { MCPSession } from './src/session.js';
+export { BaseConnector, HttpConnector, loadConfigFile, Logger, logger, MCPAgent, MCPClient, MCPSession, StdioConnector, WebSocketConnector };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAA;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAA;AAElE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE7C,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAA"}

package/dist/src/adapters/base.d.ts

@@ -0,0 +1,68 @@
+import type { MCPClient } from '../client.js';
+import type { BaseConnector } from '../connectors/base.js';
+/**
+ * Abstract base class for converting MCP tools to other framework formats.
+ *
+ * This class defines the common interface that all adapter implementations
+ * should follow to ensure consistency across different frameworks.
+ */
+export declare abstract class BaseAdapter<T> {
+    /**
+     * List of tool names that should not be available.
+     */
+    protected readonly disallowedTools: string[];
+    /**
+     * Internal cache that maps a connector instance to the list of tools
+     * generated for it.
+     */
+    private readonly connectorToolMap;
+    constructor(disallowedTools?: string[]);
+    /**
+     * Create tools from an MCPClient instance.
+     *
+     * This is the recommended way to create tools from an MCPClient, as it handles
+     * session creation and connector extraction automatically.
+     *
+     * @param client          The MCPClient to extract tools from.
+     * @param disallowedTools Optional list of tool names to exclude.
+     * @returns               A promise that resolves with a list of converted tools.
+     */
+    static createTools<TTool, TAdapter extends BaseAdapter<TTool>>(this: new (disallowedTools?: string[]) => TAdapter, client: MCPClient, disallowedTools?: string[]): Promise<TTool[]>;
+    /**
+     * Dynamically load tools for a specific connector.
+     *
+     * @param connector The connector to load tools for.
+     * @returns         The list of tools that were loaded in the target framework's format.
+     */
+    loadToolsForConnector(connector: BaseConnector): Promise<T[]>;
+    /**
+     * Convert an MCP tool to the target framework's tool format.
+     *
+     * @param mcpTool   The MCP tool definition to convert.
+     * @param connector The connector that provides this tool.
+     * @returns         The converted tool, or null / undefined if no tool should be produced.
+     */
+    protected abstract convertTool(mcpTool: Record<string, any>, connector: BaseConnector): T | null | undefined;
+    /**
+     * Create tools from MCP tools in all provided connectors.
+     *
+     * @param connectors List of MCP connectors to create tools from.
+     * @returns         A promise that resolves with all converted tools.
+     */
+    createToolsFromConnectors(connectors: BaseConnector[]): Promise<T[]>;
+    /**
+     * Check if a connector is initialized and has tools.
+     *
+     * @param connector The connector to check.
+     * @returns         True if the connector is initialized and has tools, false otherwise.
+     */
+    private checkConnectorInitialized;
+    /**
+     * Ensure a connector is initialized.
+     *
+     * @param connector The connector to initialize.
+     * @returns         True if initialization succeeded, false otherwise.
+     */
+    private ensureConnectorInitialized;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/src/adapters/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/adapters/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAG1D;;;;;GAKG;AACH,8BAAsB,WAAW,CAAC,CAAC;IACjC;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,eAAe,EAAE,MAAM,EAAE,CAAA;IAE5C;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAqC;gBAE1D,eAAe,CAAC,EAAE,MAAM,EAAE;IAItC;;;;;;;;;OASG;WACU,WAAW,CAAC,KAAK,EAAE,QAAQ,SAAS,WAAW,CAAC,KAAK,CAAC,EACjE,IAAI,EAAE,KAAK,eAAe,CAAC,EAAE,MAAM,EAAE,KAAK,QAAQ,EAClD,MAAM,EAAE,SAAS,EACjB,eAAe,CAAC,EAAE,MAAM,EAAE,GACzB,OAAO,CAAC,KAAK,EAAE,CAAC;IAsBnB;;;;;OAKG;IACG,qBAAqB,CAAC,SAAS,EAAE,aAAa,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAqCnE;;;;;;OAMG;IACH,SAAS,CAAC,QAAQ,CAAC,WAAW,CAC5B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC5B,SAAS,EAAE,aAAa,GACvB,CAAC,GAAG,IAAI,GAAG,SAAS;IAEvB;;;;;OAKG;IACU,yBAAyB,CAAC,UAAU,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAWjF;;;;;OAKG;IACH,OAAO,CAAC,yBAAyB;IAIjC;;;;;OAKG;YACW,0BAA0B;CAczC"}

package/dist/src/adapters/index.d.ts

@@ -0,0 +1,3 @@
+export { BaseAdapter } from './base.js';
+export { LangChainAdapter } from './langchain_adapter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AACvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA"}

package/dist/src/adapters/langchain_adapter.d.ts

@@ -0,0 +1,12 @@
+import type { Tool as McpTool } from '@modelcontextprotocol/sdk/types.js';
+import type { BaseConnector } from '../connectors/base.js';
+import { DynamicStructuredTool } from '@langchain/core/tools';
+import { BaseAdapter } from './base.js';
+export declare class LangChainAdapter extends BaseAdapter<DynamicStructuredTool> {
+    constructor(disallowedTools?: string[]);
+    /**
+     * Convert a single MCP tool specification into a LangChainJS structured tool.
+     */
+    protected convertTool(mcpTool: McpTool, connector: BaseConnector): DynamicStructuredTool | null;
+}
+//# sourceMappingURL=langchain_adapter.d.ts.map

package/dist/src/adapters/langchain_adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"langchain_adapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/langchain_adapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAIV,IAAI,IAAI,OAAO,EAEhB,MAAM,oCAAoC,CAAA;AAE3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAG1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAG7D,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAuEvC,qBAAa,gBAAiB,SAAQ,WAAW,CAAC,qBAAqB,CAAC;gBAC1D,eAAe,GAAE,MAAM,EAAO;IAI1C;;OAEG;IACH,SAAS,CAAC,WAAW,CACnB,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,aAAa,GACvB,qBAAqB,GAAG,IAAI;CA8BhC"}

package/dist/src/agents/base.d.ts

@@ -0,0 +1,27 @@
+import type { MCPSession } from '../session.js';
+export declare abstract class BaseAgent {
+    protected session: MCPSession;
+    /**
+     * @param session MCP session used for tool invocation
+     */
+    constructor(session: MCPSession);
+    /**
+     * Initialize the agent, including initializing the MCP session
+     */
+    abstract initialize(): Promise<void>;
+    /**
+     * Run the agent on a query with a maximum number of steps
+     * @param query The user query
+     * @param maxSteps Maximum steps allowed (default: 10)
+     * @returns Final result of agent execution
+     */
+    abstract run(query: string, maxSteps?: number): Promise<Record<string, any>>;
+    /**
+     * Perform a single step given the query and previous steps
+     * @param query The user query or intermediate input
+     * @param previousSteps History of steps so far
+     * @returns Result of this step
+     */
+    abstract step(query: string, previousSteps?: Array<Record<string, any>>): Promise<Record<string, any>>;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/src/agents/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/agents/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAE/C,8BAAsB,SAAS;IAC7B,SAAS,CAAC,OAAO,EAAE,UAAU,CAAA;IAE7B;;OAEG;gBACS,OAAO,EAAE,UAAU;IAI/B;;OAEG;aACa,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAE3C;;;;;OAKG;aACa,GAAG,CACjB,KAAK,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE/B;;;;;OAKG;aACa,IAAI,CAClB,KAAK,EAAE,MAAM,EACb,aAAa,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,GACzC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC"}

package/dist/src/agents/index.d.ts

@@ -0,0 +1,4 @@
+export { BaseAgent } from './base.js';
+export { MCPAgent } from './mcp_agent.js';
+export { ServerManager } from './server_manager.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/agents/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agents/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA"}

package/dist/src/agents/mcp_agent.d.ts

@@ -0,0 +1,59 @@
+import type { BaseLanguageModel } from '@langchain/core/language_models/base';
+import type { BaseMessage } from '@langchain/core/messages';
+import type { MCPClient } from '../client.js';
+import type { BaseConnector } from '../connectors/base.js';
+import type { ServerManager } from './server_manager.js';
+import { SystemMessage } from '@langchain/core/messages';
+import { LangChainAdapter } from '../adapters/langchain_adapter.js';
+export declare class MCPAgent {
+    private llm;
+    private client?;
+    private connectors;
+    private maxSteps;
+    private autoInitialize;
+    private memoryEnabled;
+    private disallowedTools;
+    private useServerManager;
+    private verbose;
+    private systemPrompt?;
+    private systemPromptTemplateOverride?;
+    private additionalInstructions?;
+    private initialized;
+    private conversationHistory;
+    private agentExecutor;
+    private sessions;
+    private systemMessage;
+    private tools;
+    private adapter;
+    private serverManager;
+    constructor(options: {
+        llm: BaseLanguageModel;
+        client?: MCPClient;
+        connectors?: BaseConnector[];
+        serverName?: string;
+        maxSteps?: number;
+        autoInitialize?: boolean;
+        memoryEnabled?: boolean;
+        systemPrompt?: string | null;
+        systemPromptTemplate?: string | null;
+        additionalInstructions?: string | null;
+        disallowedTools?: string[];
+        useServerManager?: boolean;
+        verbose?: boolean;
+        adapter?: LangChainAdapter;
+        serverManagerFactory?: (client: MCPClient) => ServerManager;
+    });
+    initialize(): Promise<void>;
+    private createSystemMessageFromTools;
+    private createAgent;
+    getConversationHistory(): BaseMessage[];
+    clearConversationHistory(): void;
+    private addToHistory;
+    getSystemMessage(): SystemMessage | null;
+    setSystemMessage(message: string): void;
+    setDisallowedTools(disallowedTools: string[]): void;
+    getDisallowedTools(): string[];
+    run(query: string, maxSteps?: number, manageConnector?: boolean, externalHistory?: BaseMessage[]): Promise<string>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=mcp_agent.d.ts.map

package/dist/src/agents/mcp_agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp_agent.d.ts","sourceRoot":"","sources":["../../../src/agents/mcp_agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAqB,MAAM,sCAAsC,CAAA;AAChG,OAAO,KAAK,EACV,WAAW,EACZ,MAAM,0BAA0B,CAAA;AAGjC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAE1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACxD,OAAO,EAGL,aAAa,EACd,MAAM,0BAA0B,CAAA;AAUjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAA;AAKnE,qBAAa,QAAQ;IACnB,OAAO,CAAC,GAAG,CAAmB;IAC9B,OAAO,CAAC,MAAM,CAAC,CAAW;IAC1B,OAAO,CAAC,UAAU,CAAiB;IACnC,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,eAAe,CAAU;IACjC,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,YAAY,CAAC,CAAe;IACpC,OAAO,CAAC,4BAA4B,CAAC,CAAe;IACpD,OAAO,CAAC,sBAAsB,CAAC,CAAe;IAE9C,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,mBAAmB,CAAoB;IAC/C,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,QAAQ,CAAiC;IACjD,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,KAAK,CAA8B;IAC3C,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,aAAa,CAA6B;gBAEtC,OAAO,EAAE;QACnB,GAAG,EAAE,iBAAiB,CAAA;QACtB,MAAM,CAAC,EAAE,SAAS,CAAA;QAClB,UAAU,CAAC,EAAE,aAAa,EAAE,CAAA;QAC5B,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,cAAc,CAAC,EAAE,OAAO,CAAA;QACxB,aAAa,CAAC,EAAE,OAAO,CAAA;QACvB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;QAC5B,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;QACpC,sBAAsB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;QACtC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAA;QAC1B,gBAAgB,CAAC,EAAE,OAAO,CAAA;QAC1B,OAAO,CAAC,EAAE,OAAO,CAAA;QACjB,OAAO,CAAC,EAAE,gBAAgB,CAAA;QAC1B,oBAAoB,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,aAAa,CAAA;KAC5D;IAkCY,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;YA8D1B,4BAA4B;IAuB1C,OAAO,CAAC,WAAW;IAyBZ,sBAAsB,IAAI,WAAW,EAAE;IAIvC,wBAAwB,IAAI,IAAI;IAIvC,OAAO,CAAC,YAAY;IAKb,gBAAgB,IAAI,aAAa,GAAG,IAAI;IAIxC,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAavC,kBAAkB,CAAC,eAAe,EAAE,MAAM,EAAE,GAAG,IAAI;IAQnD,kBAAkB,IAAI,MAAM,EAAE;IAIxB,GAAG,CACd,KAAK,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,MAAM,EACjB,eAAe,UAAO,EACtB,eAAe,CAAC,EAAE,WAAW,EAAE,GAC9B,OAAO,CAAC,MAAM,CAAC;IAyJL,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAyBpC"}

package/dist/src/agents/prompts/system_prompt_builder.d.ts

@@ -0,0 +1,6 @@
+import type { DynamicStructuredTool } from '@langchain/core/tools';
+import { SystemMessage } from '@langchain/core/messages';
+export declare function generateToolDescriptions(tools: DynamicStructuredTool[], disallowedTools?: string[]): string[];
+export declare function buildSystemPromptContent(template: string, toolDescriptionLines: string[], additionalInstructions?: string): string;
+export declare function createSystemMessage(tools: DynamicStructuredTool[], systemPromptTemplate: string, serverManagerTemplate: string, useServerManager: boolean, disallowedTools?: string[], userProvidedPrompt?: string, additionalInstructions?: string): SystemMessage;
+//# sourceMappingURL=system_prompt_builder.d.ts.map

package/dist/src/agents/prompts/system_prompt_builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system_prompt_builder.d.ts","sourceRoot":"","sources":["../../../../src/agents/prompts/system_prompt_builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAExD,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,qBAAqB,EAAE,EAC9B,eAAe,CAAC,EAAE,MAAM,EAAE,GACzB,MAAM,EAAE,CAcV;AAED,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,EAChB,oBAAoB,EAAE,MAAM,EAAE,EAC9B,sBAAsB,CAAC,EAAE,MAAM,GAC9B,MAAM,CAiBR;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,qBAAqB,EAAE,EAC9B,oBAAoB,EAAE,MAAM,EAC5B,qBAAqB,EAAE,MAAM,EAC7B,gBAAgB,EAAE,OAAO,EACzB,eAAe,CAAC,EAAE,MAAM,EAAE,EAC1B,kBAAkB,CAAC,EAAE,MAAM,EAC3B,sBAAsB,CAAC,EAAE,MAAM,GAC9B,aAAa,CAiBf"}

package/dist/src/agents/prompts/templates.d.ts

@@ -0,0 +1,3 @@
+export declare const DEFAULT_SYSTEM_PROMPT_TEMPLATE = "You are a helpful AI assistant.\nYou have access to the following tools:\n\n{tool_descriptions}\n\nUse the following format:\n\nQuestion: the input question you must answer\nThought: you should always think about what to do\nAction: the action to take, should be one of the available tools\nAction Input: the input to the action\nObservation: the result of the action\n... (this Thought/Action/Action Input/Observation can repeat N times)\nThought: I now know the final answer\nFinal Answer: the final answer to the original input question";
+export declare const SERVER_MANAGER_SYSTEM_PROMPT_TEMPLATE = "You are a helpful assistant designed to interact with MCP\n (Model Context Protocol) servers. You can manage connections to different servers and use the tools\n provided by the currently active server.\n\nImportant: The available tools change depending on which server is active.\nIf a request requires tools not listed below (e.g., file operations, web browsing,\n image manipulation), you MUST first connect to the appropriate server using\n 'connect_to_mcp_server'.\nUse 'list_mcp_servers' to find the relevant server if you are unsure.\nOnly after successfully connecting and seeing the new tools listed in\nthe response should you attempt to use those server-specific tools.\nBefore attempting a task that requires specific tools, you should\nensure you are connected to the correct server and aware of its\navailable tools. If unsure, use 'list_mcp_servers' to see options\nor 'get_active_mcp_server' to check the current connection.\n\nWhen you connect to a server using 'connect_to_mcp_server',\n you will be informed about the new tools that become available.\nYou can then use these server-specific tools in subsequent steps.\n\nHere are the tools *currently* available to you (this list includes server management tools and will\n change when you connect to a server):\n{tool_descriptions}\n";
+//# sourceMappingURL=templates.d.ts.map

package/dist/src/agents/prompts/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../../../src/agents/prompts/templates.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,8BAA8B,giBAcmB,CAAA;AAE9D,eAAO,MAAM,qCAAqC,4xCAuBjD,CAAA"}

package/dist/src/agents/server_manager.d.ts

@@ -0,0 +1,22 @@
+import type { LangChainAdapter } from '../adapters/langchain_adapter.js';
+import type { MCPClient } from '../client.js';
+import { DynamicStructuredTool } from '@langchain/core/tools';
+export declare class ServerManager {
+    private readonly client;
+    private readonly adapter;
+    private activeServer;
+    private readonly initializedServers;
+    private readonly serverTools;
+    constructor(client: MCPClient, adapter: LangChainAdapter);
+    initialize(): Promise<void>;
+    getServerManagementTools(): Promise<DynamicStructuredTool[]>;
+    listServers(): Promise<string>;
+    connectToServer(serverName: string): Promise<string>;
+    getActiveServer(): Promise<string>;
+    disconnectFromServer(): Promise<string>;
+    getActiveServerTools(): Promise<DynamicStructuredTool[]>;
+    getAllTools(): Promise<DynamicStructuredTool[]>;
+    private ensureSession;
+    private ensureToolsFetched;
+}
+//# sourceMappingURL=server_manager.d.ts.map

package/dist/src/agents/server_manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server_manager.d.ts","sourceRoot":"","sources":["../../../src/agents/server_manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAA;AACxE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAE7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAY7D,qBAAa,aAAa;IAMtB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAN1B,OAAO,CAAC,YAAY,CAAsB;IAC1C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA8B;IACjE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA8C;gBAGvD,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,gBAAgB;IAGtC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B,wBAAwB,IAAI,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAsC5D,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC;IA0B9B,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAiCpD,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC;IAMlC,oBAAoB,IAAI,OAAO,CAAC,MAAM,CAAC;IAUvC,oBAAoB,IAAI,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAIxD,WAAW,IAAI,OAAO,CAAC,qBAAqB,EAAE,CAAC;YAIvC,aAAa;YAWb,kBAAkB;CAuBjC"}

package/dist/src/client.d.ts

@@ -0,0 +1,20 @@
+import { MCPSession } from './session.js';
+export declare class MCPClient {
+    private config;
+    private sessions;
+    activeSessions: string[];
+    constructor(config?: string | Record<string, any>);
+    static fromDict(cfg: Record<string, any>): MCPClient;
+    static fromConfigFile(path: string): MCPClient;
+    addServer(name: string, serverConfig: Record<string, any>): void;
+    removeServer(name: string): void;
+    getServerNames(): string[];
+    saveConfig(filepath: string): void;
+    createSession(serverName: string, autoInitialize?: boolean): Promise<MCPSession>;
+    createAllSessions(autoInitialize?: boolean): Promise<Record<string, MCPSession>>;
+    getSession(serverName: string): MCPSession;
+    getAllActiveSessions(): Record<string, MCPSession>;
+    closeSession(serverName: string): Promise<void>;
+    closeAllSessions(): Promise<void>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/src/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAEzC,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,QAAQ,CAAiC;IAC1C,cAAc,EAAE,MAAM,EAAE,CAAK;gBAExB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;WAWnC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS;WAI7C,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS;IAI9C,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAKhE,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAOhC,cAAc,IAAI,MAAM,EAAE;IAI1B,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAQ5B,aAAa,CACxB,UAAU,EAAE,MAAM,EAClB,cAAc,UAAO,GACpB,OAAO,CAAC,UAAU,CAAC;IAwBT,iBAAiB,CAC5B,cAAc,UAAO,GACpB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAc/B,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU;IAQ1C,oBAAoB,IAAI,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC;IAM5C,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmB/C,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;CAqB/C"}

package/dist/src/config.d.ts

@@ -0,0 +1,4 @@
+import type { BaseConnector } from './connectors/base.js';
+export declare function loadConfigFile(filepath: string): Record<string, any>;
+export declare function createConnectorFromConfig(serverConfig: Record<string, any>): BaseConnector;
+//# sourceMappingURL=config.d.ts.map

package/dist/src/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAMzD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAGpE;AAED,wBAAgB,yBAAyB,CACvC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAChC,aAAa,CAwBf"}

package/dist/src/connectors/base.d.ts

@@ -0,0 +1,79 @@
+import type { Client, ClientOptions } from '@modelcontextprotocol/sdk/client/index.js';
+import type { RequestOptions } from '@modelcontextprotocol/sdk/shared/protocol.js';
+import type { CallToolResult, Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { ConnectionManager } from '../task_managers/base.js';
+export interface ConnectorInitOptions {
+    /**
+     * Options forwarded to the underlying MCP `Client` instance.
+     */
+    clientOptions?: ClientOptions;
+    /**
+     * Arbitrary request options (timeouts, cancellation, etc.) used by helper
+     * methods when they issue SDK requests. Can be overridden per‑call.
+     */
+    defaultRequestOptions?: RequestOptions;
+}
+/**
+ * Base class for MCP connectors.
+ */
+export declare abstract class BaseConnector {
+    protected client: Client | null;
+    protected connectionManager: ConnectionManager<any> | null;
+    protected toolsCache: Tool[] | null;
+    protected connected: boolean;
+    protected readonly opts: ConnectorInitOptions;
+    constructor(opts?: ConnectorInitOptions);
+    /** Establish the connection and create the SDK client. */
+    abstract connect(): Promise<void>;
+    /** Disconnect and release resources. */
+    disconnect(): Promise<void>;
+    /** Check if the client is connected */
+    get isClientConnected(): boolean;
+    /**
+     * Initialise the MCP session **after** `connect()` has succeeded.
+     *
+     * In the SDK, `Client.connect(transport)` automatically performs the
+     * protocol‑level `initialize` handshake, so we only need to cache the list of
+     * tools and expose some server info.
+     */
+    initialize(defaultRequestOptions?: RequestOptions): Promise<ReturnType<Client['getServerCapabilities']>>;
+    /** Lazily expose the cached tools list. */
+    get tools(): Tool[];
+    /** Call a tool on the server. */
+    callTool(name: string, args: Record<string, any>, options?: RequestOptions): Promise<CallToolResult>;
+    /** List resources from the server. */
+    listResources(options?: RequestOptions): Promise<import("zod").objectOutputType<{
+        _meta: import("zod").ZodOptional<import("zod").ZodObject<{}, "passthrough", import("zod").ZodTypeAny, import("zod").objectOutputType<{}, import("zod").ZodTypeAny, "passthrough">, import("zod").objectInputType<{}, import("zod").ZodTypeAny, "passthrough">>>;
+    } & {
+        nextCursor: import("zod").ZodOptional<import("zod").ZodString>;
+    } & {
+        resources: import("zod").ZodArray<import("zod").ZodObject<{
+            uri: import("zod").ZodString;
+            name: import("zod").ZodString;
+            description: import("zod").ZodOptional<import("zod").ZodString>;
+            mimeType: import("zod").ZodOptional<import("zod").ZodString>;
+        }, "passthrough", import("zod").ZodTypeAny, import("zod").objectOutputType<{
+            uri: import("zod").ZodString;
+            name: import("zod").ZodString;
+            description: import("zod").ZodOptional<import("zod").ZodString>;
+            mimeType: import("zod").ZodOptional<import("zod").ZodString>;
+        }, import("zod").ZodTypeAny, "passthrough">, import("zod").objectInputType<{
+            uri: import("zod").ZodString;
+            name: import("zod").ZodString;
+            description: import("zod").ZodOptional<import("zod").ZodString>;
+            mimeType: import("zod").ZodOptional<import("zod").ZodString>;
+        }, import("zod").ZodTypeAny, "passthrough">>, "many">;
+    }, import("zod").ZodTypeAny, "passthrough">>;
+    /** Read a resource by URI. */
+    readResource(uri: string, options?: RequestOptions): Promise<{
+        content: unknown;
+        mimeType: unknown;
+    }>;
+    /** Send a raw request through the client. */
+    request(method: string, params?: Record<string, any> | null, options?: RequestOptions): Promise<any>;
+    /**
+     * Helper to tear down the client & connection manager safely.
+     */
+    protected cleanupResources(): Promise<void>;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/src/connectors/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/connectors/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAA;AACtF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8CAA8C,CAAA;AAClF,OAAO,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAA;AAC9E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAGjE,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B;;;OAGG;IACH,qBAAqB,CAAC,EAAE,cAAc,CAAA;CACvC;AAED;;GAEG;AACH,8BAAsB,aAAa;IACjC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAO;IACtC,SAAS,CAAC,iBAAiB,EAAE,iBAAiB,CAAC,GAAG,CAAC,GAAG,IAAI,CAAO;IACjE,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,GAAG,IAAI,CAAO;IAC1C,SAAS,CAAC,SAAS,UAAQ;IAC3B,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAA;gBAEjC,IAAI,GAAE,oBAAyB;IAI3C,0DAA0D;IAC1D,QAAQ,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAEjC,wCAAwC;IAClC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAYjC,uCAAuC;IACvC,IAAI,iBAAiB,IAAI,OAAO,CAE/B;IAED;;;;;;OAMG;IACG,UAAU,CAAC,qBAAqB,GAAE,cAAsD,GAAG,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,uBAAuB,CAAC,CAAC,CAAC;IAkBrJ,2CAA2C;IAC3C,IAAI,KAAK,IAAI,IAAI,EAAE,CAKlB;IAED,iCAAiC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAW1G,sCAAsC;IAChC,aAAa,CAAC,OAAO,CAAC,EAAE,cAAc;;;;;;;;;;;;;;;;;;;;;;IAS5C,8BAA8B;IACxB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc;;;;IAUxD,6CAA6C;IACvC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAW,EAAE,OAAO,CAAC,EAAE,cAAc;IASjG;;OAEG;cACa,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;CAsClD"}

package/dist/src/connectors/http.d.ts

@@ -0,0 +1,23 @@
+import type { ConnectorInitOptions } from './base.js';
+import { BaseConnector } from './base.js';
+export interface HttpConnectorOptions extends ConnectorInitOptions {
+    authToken?: string;
+    headers?: Record<string, string>;
+    timeout?: number;
+    sseReadTimeout?: number;
+    clientInfo?: {
+        name: string;
+        version: string;
+    };
+}
+export declare class HttpConnector extends BaseConnector {
+    private readonly baseUrl;
+    private readonly headers;
+    private readonly timeout;
+    private readonly sseReadTimeout;
+    private readonly clientInfo;
+    constructor(baseUrl: string, opts?: HttpConnectorOptions);
+    /** Establish connection to the MCP implementation via SSE. */
+    connect(): Promise<void>;
+}
+//# sourceMappingURL=http.d.ts.map

package/dist/src/connectors/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/connectors/http.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAA;AAIrD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAEzC,MAAM,WAAW,oBAAqB,SAAQ,oBAAoB;IAChE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAC/C;AAED,qBAAa,aAAc,SAAQ,aAAa;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAQ;IACvC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmC;gBAElD,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,oBAAyB;IAc5D,8DAA8D;IACxD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAoC/B"}

package/dist/src/connectors/index.d.ts

@@ -0,0 +1,5 @@
+export { BaseConnector } from './base.js';
+export { HttpConnector } from './http.js';
+export { StdioConnector } from './stdio.js';
+export { WebSocketConnector } from './websocket.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/connectors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/connectors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/src/connectors/stdio.d.ts

@@ -0,0 +1,25 @@
+import type { Writable } from 'node:stream';
+import type { ConnectorInitOptions } from './base.js';
+import { BaseConnector } from './base.js';
+export interface StdioConnectorOptions extends ConnectorInitOptions {
+    clientInfo?: {
+        name: string;
+        version: string;
+    };
+}
+export declare class StdioConnector extends BaseConnector {
+    private readonly command;
+    private readonly args;
+    private readonly env?;
+    private readonly errlog;
+    private readonly clientInfo;
+    constructor({ command, args, env, errlog, ...rest }?: {
+        command?: string;
+        args?: string[];
+        env?: Record<string, string>;
+        errlog?: Writable;
+    } & StdioConnectorOptions);
+    /** Establish connection to the MCP implementation. */
+    connect(): Promise<void>;
+}
+//# sourceMappingURL=stdio.d.ts.map

package/dist/src/connectors/stdio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio.d.ts","sourceRoot":"","sources":["../../../src/connectors/stdio.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAE3C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAA;AAMrD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAEzC,MAAM,WAAW,qBAAsB,SAAQ,oBAAoB;IACjE,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAC/C;AAED,qBAAa,cAAe,SAAQ,aAAa;IAC/C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAU;IAC/B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAwB;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmC;gBAG5D,EACE,OAAe,EACf,IAAS,EACT,GAAG,EACH,MAAuB,EACvB,GAAG,IAAI,EACR,GAAE;QACD,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;QACf,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAC5B,MAAM,CAAC,EAAE,QAAQ,CAAA;KAClB,GAAG,qBAA0B;IAWhC,sDAAsD;IAChD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAiC/B"}

package/dist/src/connectors/websocket.d.ts

@@ -0,0 +1,34 @@
+import type { CallToolResult, Tool } from '@modelcontextprotocol/sdk/types.js';
+import { WebSocketConnectionManager } from '../task_managers/websocket.js';
+import { BaseConnector } from './base.js';
+export interface WebSocketConnectorOptions {
+    authToken?: string;
+    headers?: Record<string, string>;
+}
+export declare class WebSocketConnector extends BaseConnector {
+    private readonly url;
+    private readonly headers;
+    protected connectionManager: WebSocketConnectionManager | null;
+    private ws;
+    private receiverTask;
+    private pending;
+    protected toolsCache: Tool[] | null;
+    constructor(url: string, opts?: WebSocketConnectorOptions);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    private sendRequest;
+    private receiveLoop;
+    private rejectAll;
+    initialize(): Promise<Record<string, any>>;
+    listTools(): Promise<Tool[]>;
+    callTool(name: string, args: Record<string, any>): Promise<CallToolResult>;
+    listResources(): Promise<any>;
+    readResource(uri: string): Promise<{
+        content: ArrayBuffer;
+        mimeType: string;
+    }>;
+    request(method: string, params?: Record<string, any> | null): Promise<any>;
+    get tools(): Tool[];
+    protected cleanupResources(): Promise<void>;
+}
+//# sourceMappingURL=websocket.d.ts.map

package/dist/src/connectors/websocket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.d.ts","sourceRoot":"","sources":["../../../src/connectors/websocket.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,IAAI,EACL,MAAM,oCAAoC,CAAA;AAG3C,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAA;AAE1E,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAEzC,MAAM,WAAW,yBAAyB;IACxC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC;AAED,qBAAa,kBAAmB,SAAQ,aAAa;IACnD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAQ;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAEhD,SAAS,CAAC,iBAAiB,EAAE,0BAA0B,GAAG,IAAI,CAAO;IACrE,OAAO,CAAC,EAAE,CAAkD;IAC5D,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,OAAO,CACF;IAEb,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,GAAG,IAAI,CAAO;gBAE9B,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,yBAA8B;IAQvD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAqBxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAUjC,OAAO,CAAC,WAAW;YAiBL,WAAW;IAyCzB,OAAO,CAAC,SAAS;IAKX,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAS1C,SAAS,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;IAK5B,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC;IAI1E,aAAa,IAAI,OAAO,CAAC,GAAG,CAAC;IAK7B,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,WAAW,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAK9E,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAW,GAAG,OAAO,CAAC,GAAG,CAAC;IAItF,IAAI,KAAK,IAAI,IAAI,EAAE,CAIlB;cAEe,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;CAkBlD"}

package/dist/src/connectors/websocket.js

@@ -70,7 +70,7 @@ export class WebSocketConnector extends BaseConnector {
                 data = JSON.parse(msg.data ?? msg);
             }
             catch (e) {
-                logger.warn('Received non‑JSON frame');
+                logger.warn('Received non‑JSON frame', e);
                 return;
             }
             const id = data.id;
@@ -114,18 +114,18 @@ export class WebSocketConnector extends BaseConnector {
         const res = await this.sendRequest('tools/list');
         return res.tools ?? [];
     }
-    async callTool(name, args, options) {
+    async callTool(name, args) {
         return await this.sendRequest('tools/call', { name, arguments: args });
     }
-    async listResources(options) {
+    async listResources() {
         const resources = await this.sendRequest('resources/list');
         return { resources: Array.isArray(resources) ? resources : [] };
     }
-    async readResource(uri, options) {
+    async readResource(uri) {
         const res = await this.sendRequest('resources/read', { uri });
         return { content: res.content, mimeType: res.mimeType };
     }
-    async request(method, params = null, options) {
+    async request(method, params = null) {
         return await this.sendRequest(method, params);
     }
     get tools() {

package/dist/src/logging.d.ts

@@ -0,0 +1,9 @@
+import type { Logger as WinstonLogger } from 'winston';
+export declare class Logger {
+    private static loggers;
+    static getLogger(name?: string): WinstonLogger;
+    static configure(level?: string, toConsole?: boolean, toFile?: string): void;
+    static setDebug(debugLevel?: number): void;
+}
+export declare const logger: WinstonLogger;
+//# sourceMappingURL=logging.d.ts.map

package/dist/src/logging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../../src/logging.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,aAAa,EAAE,MAAM,SAAS,CAAA;AAqBtD,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAC,OAAO,CAAoC;WAE5C,SAAS,CAAC,IAAI,GAAE,MAAkB,GAAG,aAAa;WAelD,SAAS,CACrB,KAAK,CAAC,EAAE,MAAM,EACd,SAAS,GAAE,OAAc,EACzB,MAAM,CAAC,EAAE,MAAM,GACd,IAAI;WA0BO,QAAQ,CAAC,UAAU,GAAE,MAAU,GAAG,IAAI;CAarD;AAID,eAAO,MAAM,MAAM,eAAqB,CAAA"}

package/dist/src/session.d.ts

@@ -0,0 +1,19 @@
+import type { BaseConnector } from './connectors/base.js';
+export declare class MCPSession {
+    readonly connector: BaseConnector;
+    private autoConnect;
+    private _sessionInfo;
+    private _tools;
+    constructor(connector: BaseConnector, autoConnect?: boolean);
+    open(): Promise<this>;
+    close(): Promise<void>;
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    initialize(): Promise<Record<string, any>>;
+    get isConnected(): boolean;
+    get sessionInfo(): Record<string, any> | null;
+    get tools(): Record<string, any>[];
+    discoverTools(): Promise<Record<string, any>[]>;
+    callTool(name: string, args: Record<string, any>): Promise<any>;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/src/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAGzD,qBAAa,UAAU;IACrB,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAA;IACjC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,YAAY,CAAmC;IACvD,OAAO,CAAC,MAAM,CAA4B;gBAE9B,SAAS,EAAE,aAAa,EAAE,WAAW,UAAO;IAKlD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAKrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAUhD,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,IAAI,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAE5C;IAED,IAAI,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAEjC;IAEK,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC;IAK/C,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC;CAOtE"}

package/dist/src/task_managers/base.d.ts

@@ -0,0 +1,56 @@
+export type ConnectionType<T = any> = T;
+export declare abstract class ConnectionManager<T = any> {
+    private _readyPromise;
+    private _readyResolver;
+    private _donePromise;
+    private _doneResolver;
+    private _exception;
+    private _connection;
+    private _task;
+    private _abortController;
+    constructor();
+    /**
+     * Establish the connection.
+     *
+     * This method should be implemented by subclasses to establish the specific
+     * type of connection needed.
+     *
+     * @returns The established connection.
+     * @throws If the connection cannot be established.
+     */
+    protected abstract establishConnection(): Promise<T>;
+    /**
+     * Close the connection.
+     *
+     * This method should be implemented by subclasses to close the specific type
+     * of connection.
+     *
+     * @param connection The connection to close.
+     */
+    protected abstract closeConnection(connection: T): Promise<void>;
+    /**
+     * Start the connection manager and establish a connection.
+     *
+     * @returns The established connection.
+     * @throws If the connection cannot be established.
+     */
+    start(): Promise<T>;
+    /**
+     * Stop the connection manager and close the connection.
+     */
+    stop(): Promise<void>;
+    /**
+     * Reset all internal state.
+     */
+    private reset;
+    /**
+     * The background task responsible for establishing and maintaining the
+     * connection until it is cancelled.
+     */
+    private connectionTask;
+    /**
+     * Helper that returns a promise which resolves when the abort signal fires.
+     */
+    private waitForAbort;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/src/task_managers/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/task_managers/base.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,cAAc,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,CAAA;AAEvC,8BAAsB,iBAAiB,CAAC,CAAC,GAAG,GAAG;IAC7C,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,cAAc,CAAa;IAEnC,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,aAAa,CAAa;IAElC,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,WAAW,CAAiB;IACpC,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,gBAAgB,CAA+B;;IAMvD;;;;;;;;OAQG;IACH,SAAS,CAAC,QAAQ,CAAC,mBAAmB,IAAI,OAAO,CAAC,CAAC,CAAC;IAEpD;;;;;;;OAOG;IACH,SAAS,CAAC,QAAQ,CAAC,eAAe,CAAC,UAAU,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAEhE;;;;;OAKG;IACG,KAAK,IAAI,OAAO,CAAC,CAAC,CAAC;IAwBzB;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAwB3B;;OAEG;IACH,OAAO,CAAC,KAAK;IASb;;;OAGG;YACW,cAAc;IAsC5B;;OAEG;YACW,YAAY;CAqB3B"}

package/dist/src/task_managers/index.d.ts

@@ -0,0 +1,5 @@
+export { ConnectionManager } from './base.js';
+export { SseConnectionManager } from './sse.js';
+export { StdioConnectionManager } from './stdio.js';
+export { WebSocketConnectionManager } from './websocket.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/task_managers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/task_managers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAA;AAC/C,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AACnD,OAAO,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/src/task_managers/sse.d.ts

@@ -0,0 +1,24 @@
+import type { SSEClientTransportOptions } from '@modelcontextprotocol/sdk/client/sse.js';
+import { SSEClientTransport } from '@modelcontextprotocol/sdk/client/sse.js';
+import { ConnectionManager } from './base.js';
+export declare class SseConnectionManager extends ConnectionManager<SSEClientTransport> {
+    private readonly url;
+    private readonly opts?;
+    private _transport;
+    /**
+     * Create an SSE connection manager.
+     *
+     * @param url  The SSE endpoint URL.
+     * @param opts Optional transport options (auth, headers, etc.).
+     */
+    constructor(url: string | URL, opts?: SSEClientTransportOptions);
+    /**
+     * Spawn a new `SSEClientTransport` and start the connection.
+     */
+    protected establishConnection(): Promise<SSEClientTransport>;
+    /**
+     * Close the underlying transport and clean up resources.
+     */
+    protected closeConnection(_connection: SSEClientTransport): Promise<void>;
+}
+//# sourceMappingURL=sse.d.ts.map

package/dist/src/task_managers/sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../../src/task_managers/sse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,yCAAyC,CAAA;AACxF,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAA;AAE5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAE7C,qBAAa,oBAAqB,SAAQ,iBAAiB,CAAC,kBAAkB,CAAC;IAC7E,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAK;IACzB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAA2B;IACjD,OAAO,CAAC,UAAU,CAAkC;IAEpD;;;;;OAKG;gBACS,GAAG,EAAE,MAAM,GAAG,GAAG,EAAE,IAAI,CAAC,EAAE,yBAAyB;IAM/D;;OAEG;cACa,mBAAmB,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAQlE;;OAEG;cACa,eAAe,CAAC,WAAW,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;CAahF"}

package/dist/src/task_managers/stdio.d.ts

@@ -0,0 +1,28 @@
+import type { StdioServerParameters } from '@modelcontextprotocol/sdk/client/stdio.js';
+import type { Writable } from 'node:stream';
+import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
+import { ConnectionManager } from './base.js';
+export declare class StdioConnectionManager extends ConnectionManager<StdioClientTransport> {
+    private readonly serverParams;
+    private readonly errlog;
+    private _transport;
+    /**
+     * Create a new stdio connection manager.
+     *
+     * @param serverParams Parameters for the stdio server process.
+     * @param errlog       Stream to which the server's stderr should be piped.
+     *                     Defaults to `process.stderr`.
+     */
+    constructor(serverParams: StdioServerParameters, errlog?: Writable);
+    /**
+     * Establish the stdio connection by spawning the server process and starting
+     * the SDK's transport. Returns the live `StdioClientTransport` instance.
+     */
+    protected establishConnection(): Promise<StdioClientTransport>;
+    /**
+     * Close the stdio connection, making sure the transport cleans up the child
+     * process and associated resources.
+     */
+    protected closeConnection(_connection: StdioClientTransport): Promise<void>;
+}
+//# sourceMappingURL=stdio.d.ts.map

package/dist/src/task_managers/stdio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio.d.ts","sourceRoot":"","sources":["../../../src/task_managers/stdio.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2CAA2C,CAAA;AACtF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAA;AAEhF,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAE7C,qBAAa,sBAAuB,SAAQ,iBAAiB,CAAC,oBAAoB,CAAC;IACjF,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAuB;IACpD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;IACjC,OAAO,CAAC,UAAU,CAAoC;IAEtD;;;;;;OAMG;gBACS,YAAY,EAAE,qBAAqB,EAAE,MAAM,GAAE,QAAyB;IAMlF;;;OAGG;cACa,mBAAmB,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAcpE;;;OAGG;cACa,eAAe,CAAC,WAAW,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;CAalF"}

package/dist/src/task_managers/websocket.d.ts

@@ -0,0 +1,18 @@
+import WS from 'ws';
+import { ConnectionManager } from './base.js';
+export type IWebSocket = WS;
+export declare class WebSocketConnectionManager extends ConnectionManager<IWebSocket> {
+    private readonly url;
+    private readonly headers;
+    private _ws;
+    /**
+     * @param url     The WebSocket URL to connect to.
+     * @param headers Optional headers to include in the connection handshake.
+     */
+    constructor(url: string, headers?: Record<string, string>);
+    /** Establish a WebSocket connection and wait until it is open. */
+    protected establishConnection(): Promise<IWebSocket>;
+    /** Cleanly close the WebSocket connection. */
+    protected closeConnection(connection: IWebSocket): Promise<void>;
+}
+//# sourceMappingURL=websocket.d.ts.map

package/dist/src/task_managers/websocket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.d.ts","sourceRoot":"","sources":["../../../src/task_managers/websocket.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAA;AAEnB,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAE7C,MAAM,MAAM,UAAU,GAAG,EAAE,CAAA;AAE3B,qBAAa,0BAA2B,SAAQ,iBAAiB,CAAC,UAAU,CAAC;IAC3E,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAQ;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,GAAG,CAA0B;IAErC;;;OAGG;gBACS,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM;IAM7D,kEAAkE;cAClD,mBAAmB,IAAI,OAAO,CAAC,UAAU,CAAC;IAgC1D,8CAA8C;cAC9B,eAAe,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;CA0BvE"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mcp-use",
   "type": "module",
-  "version": "0.0.1",
+  "version": "0.0.4",
   "description": "A utility library for integrating Model Context Protocol (MCP) with LangChain, Zod, and related tools. Provides helpers for schema conversion, event streaming, and SDK usage.",
   "author": "Zane",
   "license": "MIT",
@@ -37,20 +37,12 @@
   "files": [
     "dist"
   ],
+  "engines": {
+    "node": ">=22.0.0"
+  },
   "publishConfig": {
     "registry": "https://registry.npmjs.org"
   },
-  "scripts": {
-    "build": "tsc && shx chmod +x dist/*.js",
-    "watch": "tsc --watch",
-    "start": "node dist/index.js",
-    "prepublishOnly": "pnpm run build",
-    "lint": "eslint",
-    "lint:fix": "eslint --fix",
-    "release": "npm version patch && git push --follow-tags",
-    "release:minor": "npm version minor && git push --follow-tags",
-    "release:major": "npm version major && git push --follow-tags"
-  },
   "dependencies": {
     "@dmitryrechkin/json-schema-to-zod": "^1.0.1",
     "@langchain/community": "0.3.41",
@@ -71,5 +63,15 @@
     "eslint-plugin-format": "^1.0.1",
     "shx": "^0.4.0",
     "typescript": "^5.8.3"
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc && shx chmod +x dist/*.js",
+    "watch": "tsc --watch",
+    "start": "node dist/index.js",
+    "lint": "eslint",
+    "lint:fix": "eslint --fix",
+    "release": "npm version patch && git push --follow-tags",
+    "release:minor": "npm version minor && git push --follow-tags",
+    "release:major": "npm version major && git push --follow-tags"
   }
-}
+}