mcp-use 0.1.12 → 0.1.15

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import { MCPAgent } from './src/agents/mcp_agent.js';
+import { RemoteAgent } from './src/agents/remote.js';
 import { MCPClient } from './src/client.js';
 import { loadConfigFile } from './src/config.js';
 import { BaseConnector } from './src/connectors/base.js';
@@ -14,5 +15,5 @@ export * from './src/managers/tools/index.js';
 export { setTelemetrySource, Telemetry } from './src/telemetry/index.js';
 export { AIMessage, BaseMessage, HumanMessage, SystemMessage, ToolMessage } from '@langchain/core/messages';
 export type { StreamEvent } from '@langchain/core/tracers/log_stream';
-export { BaseConnector, HttpConnector, loadConfigFile, Logger, logger, MCPAgent, MCPClient, MCPSession, StdioConnector, WebSocketConnector };
+export { BaseConnector, HttpConnector, loadConfigFile, Logger, logger, MCPAgent, MCPClient, MCPSession, RemoteAgent, StdioConnector, WebSocketConnector };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +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,WAAW,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAEvE,cAAc,6BAA6B,CAAA;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAA;AAEhE,cAAc,+BAA+B,CAAA;AAG7C,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AAGxE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAG3G,YAAY,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAA;AAErE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAA;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,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,WAAW,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAEvE,cAAc,6BAA6B,CAAA;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAA;AAEhE,cAAc,+BAA+B,CAAA;AAG7C,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AAGxE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAG3G,YAAY,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAA;AAErE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAA"}

package/dist/index.js

@@ -1,4 +1,5 @@
 import { MCPAgent } from './src/agents/mcp_agent.js';
+import { RemoteAgent } from './src/agents/remote.js';
 import { MCPClient } from './src/client.js';
 import { loadConfigFile } from './src/config.js';
 import { BaseConnector } from './src/connectors/base.js';
@@ -16,4 +17,4 @@ export * from './src/managers/tools/index.js';
 export { setTelemetrySource, Telemetry } from './src/telemetry/index.js';
 // Re-export message classes to ensure a single constructor instance is shared by consumers
 export { AIMessage, BaseMessage, HumanMessage, SystemMessage, ToolMessage } from '@langchain/core/messages';
-export { BaseConnector, HttpConnector, loadConfigFile, Logger, logger, MCPAgent, MCPClient, MCPSession, StdioConnector, WebSocketConnector };
+export { BaseConnector, HttpConnector, loadConfigFile, Logger, logger, MCPAgent, MCPClient, MCPSession, RemoteAgent, StdioConnector, WebSocketConnector };

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

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

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

@@ -1 +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"}
+{"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,WAAW,EAAE,MAAM,aAAa,CAAA"}

package/dist/src/agents/index.js

@@ -1,2 +1,3 @@
 export { BaseAgent } from './base.js';
 export { MCPAgent } from './mcp_agent.js';
+export { RemoteAgent } from './remote.js';

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

@@ -10,7 +10,7 @@ import { SystemMessage } from '@langchain/core/messages';
 import { LangChainAdapter } from '../adapters/langchain_adapter.js';
 import { ServerManager } from '../managers/server_manager.js';
 export declare class MCPAgent {
-    private llm;
+    private llm?;
     private client?;
     private connectors;
     private maxSteps;
@@ -34,8 +34,10 @@ export declare class MCPAgent {
     private telemetry;
     private modelProvider;
     private modelName;
+    private isRemote;
+    private remoteAgent;
     constructor(options: {
-        llm: BaseLanguageModelInterface;
+        llm?: BaseLanguageModelInterface;
         client?: MCPClient;
         connectors?: BaseConnector[];
         maxSteps?: number;
@@ -50,6 +52,9 @@ export declare class MCPAgent {
         verbose?: boolean;
         adapter?: LangChainAdapter;
         serverManagerFactory?: (client: MCPClient) => ServerManager;
+        agentId?: string;
+        apiKey?: string;
+        baseUrl?: string;
     });
     initialize(): Promise<void>;
     private createSystemMessageFromTools;

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

@@ -1 +1 @@
-{"version":3,"file":"mcp_agent.d.ts","sourceRoot":"","sources":["../../../src/agents/mcp_agent.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mcp_agent.d.ts","sourceRoot":"","sources":["../../../src/agents/mcp_agent.ts"],"names":[],"mappings":"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"}

package/dist/src/agents/mcp_agent.js

@@ -9,6 +9,7 @@ import { ServerManager } from '../managers/server_manager.js';
 import { extractModelInfo, Telemetry } from '../telemetry/index.js';
 import { createSystemMessage } from './prompts/system_prompt_builder.js';
 import { DEFAULT_SYSTEM_PROMPT_TEMPLATE, SERVER_MANAGER_SYSTEM_PROMPT_TEMPLATE } from './prompts/templates.js';
+import { RemoteAgent } from './remote.js';
 export class MCPAgent {
     llm;
     client;
@@ -34,7 +35,37 @@ export class MCPAgent {
     telemetry;
     modelProvider;
     modelName;
+    // Remote agent support
+    isRemote = false;
+    remoteAgent = null;
     constructor(options) {
+        // Handle remote execution
+        if (options.agentId) {
+            this.isRemote = true;
+            this.remoteAgent = new RemoteAgent({
+                agentId: options.agentId,
+                apiKey: options.apiKey,
+                baseUrl: options.baseUrl,
+            });
+            // Set default values for remote agent
+            this.maxSteps = options.maxSteps ?? 5;
+            this.memoryEnabled = options.memoryEnabled ?? true;
+            this.autoInitialize = options.autoInitialize ?? false;
+            this.verbose = options.verbose ?? false;
+            this.connectors = [];
+            this.disallowedTools = [];
+            this.additionalTools = [];
+            this.useServerManager = false;
+            this.adapter = new LangChainAdapter();
+            this.telemetry = Telemetry.getInstance();
+            this.modelProvider = 'remote';
+            this.modelName = 'remote-agent';
+            return;
+        }
+        // Validate requirements for local execution
+        if (!options.llm) {
+            throw new Error('llm is required for local execution. For remote execution, provide agentId instead.');
+        }
         this.llm = options.llm;
         this.client = options.client;
         this.connectors = options.connectors ?? [];
@@ -65,9 +96,15 @@ export class MCPAgent {
         // Initialize telemetry
         this.telemetry = Telemetry.getInstance();
         // Track model info for telemetry
-        const [provider, name] = extractModelInfo(this.llm);
-        this.modelProvider = provider;
-        this.modelName = name;
+        if (this.llm) {
+            const [provider, name] = extractModelInfo(this.llm);
+            this.modelProvider = provider;
+            this.modelName = name;
+        }
+        else {
+            this.modelProvider = 'unknown';
+            this.modelName = 'unknown';
+        }
         // Make getters configurable for test mocking
         Object.defineProperty(this, 'agentExecutor', {
             get: () => this._agentExecutor,
@@ -83,6 +120,11 @@ export class MCPAgent {
         });
     }
     async initialize() {
+        // Skip initialization for remote agents
+        if (this.isRemote) {
+            this._initialized = true;
+            return;
+        }
         logger.info('🚀 Initializing MCP agent and connecting to services...');
         // If using server manager, initialize it
         if (this.useServerManager && this.serverManager) {
@@ -147,6 +189,9 @@ export class MCPAgent {
         }
     }
     createAgent() {
+        if (!this.llm) {
+            throw new Error('LLM is required to create agent');
+        }
         const systemContent = this.systemMessage?.content ?? 'You are a helpful assistant.';
         const prompt = ChatPromptTemplate.fromMessages([
             ['system', systemContent],
@@ -213,6 +258,10 @@ export class MCPAgent {
         }
     }
     async run(query, maxSteps, manageConnector, externalHistory, outputSchema) {
+        // Delegate to remote agent if in remote mode
+        if (this.isRemote && this.remoteAgent) {
+            return this.remoteAgent.run(query, maxSteps, manageConnector, externalHistory, outputSchema);
+        }
         const generator = this.stream(query, maxSteps, manageConnector, externalHistory, outputSchema);
         return this._consumeAndReturn(generator);
     }
@@ -221,6 +270,11 @@ export class MCPAgent {
      * If outputSchema is provided, returns structured output of type T.
      */
     async *stream(query, maxSteps, manageConnector = true, externalHistory, outputSchema) {
+        // Delegate to remote agent if in remote mode
+        if (this.isRemote && this.remoteAgent) {
+            const result = await this.remoteAgent.run(query, maxSteps, manageConnector, externalHistory, outputSchema);
+            return result;
+        }
         let result = '';
         let initializedHere = false;
         const startTime = Date.now();
@@ -234,13 +288,16 @@ export class MCPAgent {
             query = this._enhanceQueryWithSchema(query, outputSchema);
             logger.debug(`🔄 Structured output requested, schema: ${JSON.stringify(zodToJsonSchema(outputSchema), null, 2)}`);
             // Check if withStructuredOutput method exists
-            if ('withStructuredOutput' in this.llm && typeof this.llm.withStructuredOutput === 'function') {
+            if (this.llm && 'withStructuredOutput' in this.llm && typeof this.llm.withStructuredOutput === 'function') {
                 structuredLlm = this.llm.withStructuredOutput(outputSchema);
             }
-            else {
+            else if (this.llm) {
                 // Fallback: use the same LLM but we'll handle structure in our helper method
                 structuredLlm = this.llm;
             }
+            else {
+                throw new Error('LLM is required for structured output');
+            }
             schemaDescription = JSON.stringify(zodToJsonSchema(outputSchema), null, 2);
         }
         try {
@@ -444,6 +501,11 @@ export class MCPAgent {
         }
     }
     async close() {
+        // Delegate to remote agent if in remote mode
+        if (this.isRemote && this.remoteAgent) {
+            await this.remoteAgent.close();
+            return;
+        }
         logger.info('🔌 Closing MCPAgent resources…');
         try {
             this._agentExecutor = null;
@@ -596,9 +658,22 @@ export class MCPAgent {
      * Attempt to create structured output from raw result with validation and retry logic.
      */
     async _attemptStructuredOutput(rawResult, structuredLlm, outputSchema, schemaDescription) {
-        logger.debug(`🔄 Attempting structured output with schema: ${outputSchema}`);
-        logger.debug(`🔄 Schema description: ${schemaDescription}`);
-        logger.debug(`🔄 Raw result: ${JSON.stringify(rawResult, null, 2)}`);
+        logger.info(`🔄 Attempting structured output with schema: ${outputSchema}`);
+        logger.info(`🔄 Schema description: ${schemaDescription}`);
+        logger.info(`🔄 Raw result: ${JSON.stringify(rawResult, null, 2)}`);
+        // Handle different input formats - rawResult might be an array or object from the agent
+        let textContent = '';
+        if (typeof rawResult === 'string') {
+            textContent = rawResult;
+        }
+        else if (rawResult && typeof rawResult === 'object') {
+            // Handle object format
+            textContent = JSON.stringify(rawResult);
+        }
+        // If we couldn't extract text, use the stringified version
+        if (!textContent) {
+            textContent = JSON.stringify(rawResult);
+        }
         // Get detailed schema information for better prompting
         const maxRetries = 3;
         let lastError = '';
@@ -611,8 +686,8 @@ export class MCPAgent {
       Required schema format:
       ${schemaDescription}
       
-      Content to format:
-      ${rawResult}
+      Content to extract from:
+      ${textContent}
       
       IMPORTANT: 
       - Use ONLY the field names specified in the schema

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

@@ -0,0 +1,23 @@
+/**
+ * Remote agent implementation for executing agents via API.
+ */
+import type { BaseMessage } from '@langchain/core/messages';
+import type { ZodSchema } from 'zod';
+export declare class RemoteAgent {
+    private agentId;
+    private apiKey;
+    private baseUrl;
+    private chatId;
+    constructor(options: {
+        agentId: string;
+        apiKey?: string;
+        baseUrl?: string;
+    });
+    private pydanticToJsonSchema;
+    private parseStructuredResponse;
+    private createChatSession;
+    run<T = string>(query: string, maxSteps?: number, manageConnector?: boolean, externalHistory?: BaseMessage[], outputSchema?: ZodSchema<T>): Promise<T>;
+    stream<T = string>(query: string, maxSteps?: number, manageConnector?: boolean, externalHistory?: BaseMessage[], outputSchema?: ZodSchema<T>): AsyncGenerator<any, T, void>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=remote.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"remote.d.ts","sourceRoot":"","sources":["../../../src/agents/remote.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAA;AAQpC,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,MAAM,CAAsB;gBAExB,OAAO,EAAE;QACnB,OAAO,EAAE,MAAM,CAAA;QACf,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,OAAO,CAAC,EAAE,MAAM,CAAA;KACjB;IAgBD,OAAO,CAAC,oBAAoB;IAO5B,OAAO,CAAC,uBAAuB;YAoDjB,iBAAiB;IAmDlB,GAAG,CAAC,CAAC,GAAG,MAAM,EACzB,KAAK,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,MAAM,EACjB,eAAe,CAAC,EAAE,OAAO,EACzB,eAAe,CAAC,EAAE,WAAW,EAAE,EAC/B,YAAY,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,GAC1B,OAAO,CAAC,CAAC,CAAC;IAwJC,MAAM,CAAC,CAAC,GAAG,MAAM,EAC7B,KAAK,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,MAAM,EACjB,eAAe,CAAC,EAAE,OAAO,EACzB,eAAe,CAAC,EAAE,WAAW,EAAE,EAC/B,YAAY,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,GAC1B,cAAc,CAAC,GAAG,EAAE,CAAC,EAAE,IAAI,CAAC;IASlB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAUpC"}

package/dist/src/agents/remote.js

@@ -0,0 +1,264 @@
+/**
+ * Remote agent implementation for executing agents via API.
+ */
+import { zodToJsonSchema } from 'zod-to-json-schema';
+import { logger } from '../logging.js';
+// API endpoint constants
+const API_CHATS_ENDPOINT = '/api/v1/chats';
+const API_CHAT_EXECUTE_ENDPOINT = '/api/v1/chats/{chat_id}/execute';
+export class RemoteAgent {
+    agentId;
+    apiKey;
+    baseUrl;
+    chatId = null;
+    constructor(options) {
+        this.agentId = options.agentId;
+        this.baseUrl = options.baseUrl ?? 'https://cloud.mcp-use.com';
+        // Handle API key validation
+        const apiKey = options.apiKey ?? process.env.MCP_USE_API_KEY;
+        if (!apiKey) {
+            throw new Error('API key is required for remote execution. '
+                + 'Please provide it as a parameter or set the MCP_USE_API_KEY environment variable. '
+                + 'You can get an API key from https://cloud.mcp-use.com');
+        }
+        this.apiKey = apiKey;
+    }
+    pydanticToJsonSchema(schema) {
+        /**
+         * Convert a Zod schema to JSON schema for API transmission.
+         */
+        return zodToJsonSchema(schema);
+    }
+    parseStructuredResponse(responseData, outputSchema) {
+        /**
+         * Parse the API response into the structured output format.
+         */
+        let resultData;
+        // Handle different response formats
+        if (typeof responseData === 'object' && responseData !== null) {
+            if ('result' in responseData) {
+                const outerResult = responseData.result;
+                // Check if this is a nested result structure (agent execution response)
+                if (typeof outerResult === 'object' && outerResult !== null && 'result' in outerResult) {
+                    // Extract the actual structured output from the nested result
+                    resultData = outerResult.result;
+                }
+                else {
+                    // Use the outer result directly
+                    resultData = outerResult;
+                }
+            }
+            else {
+                resultData = responseData;
+            }
+        }
+        else if (typeof responseData === 'string') {
+            try {
+                resultData = JSON.parse(responseData);
+            }
+            catch {
+                // If it's not valid JSON, try to create the model from the string content
+                resultData = { content: responseData };
+            }
+        }
+        else {
+            resultData = responseData;
+        }
+        // Parse into the Zod schema
+        try {
+            return outputSchema.parse(resultData);
+        }
+        catch (e) {
+            logger.warn(`Failed to parse structured output: ${e}`);
+            // Fallback: try to parse it as raw content if the schema has a content field
+            const schemaShape = outputSchema._def?.shape();
+            if (schemaShape && 'content' in schemaShape) {
+                return outputSchema.parse({ content: String(resultData) });
+            }
+            throw e;
+        }
+    }
+    async createChatSession() {
+        /**
+         * Create a persistent chat session for the agent.
+         */
+        const chatPayload = {
+            title: `Remote Agent Session - ${this.agentId}`,
+            agent_id: this.agentId,
+            type: 'agent_execution',
+        };
+        const headers = {
+            'Content-Type': 'application/json',
+            'x-api-key': this.apiKey,
+        };
+        const chatUrl = `${this.baseUrl}${API_CHATS_ENDPOINT}`;
+        logger.info(`📝 Creating chat session for agent ${this.agentId}`);
+        try {
+            const response = await fetch(chatUrl, {
+                method: 'POST',
+                headers,
+                body: JSON.stringify(chatPayload),
+            });
+            if (!response.ok) {
+                const responseText = await response.text();
+                const statusCode = response.status;
+                if (statusCode === 404) {
+                    throw new Error(`Agent not found: Agent '${this.agentId}' does not exist or you don't have access to it. `
+                        + 'Please verify the agent ID and ensure it exists in your account.');
+                }
+                throw new Error(`Failed to create chat session: ${statusCode} - ${responseText}`);
+            }
+            const chatData = await response.json();
+            const chatId = chatData.id;
+            logger.info(`✅ Chat session created: ${chatId}`);
+            return chatId;
+        }
+        catch (e) {
+            if (e instanceof Error) {
+                throw new TypeError(`Failed to create chat session: ${e.message}`);
+            }
+            throw new Error(`Failed to create chat session: ${String(e)}`);
+        }
+    }
+    async run(query, maxSteps, manageConnector, externalHistory, outputSchema) {
+        /**
+         * Run a query on the remote agent.
+         */
+        if (externalHistory !== undefined) {
+            logger.warn('External history is not yet supported for remote execution');
+        }
+        try {
+            logger.info(`🌐 Executing query on remote agent ${this.agentId}`);
+            // Step 1: Create a chat session for this agent (only if we don't have one)
+            if (this.chatId === null) {
+                this.chatId = await this.createChatSession();
+            }
+            const chatId = this.chatId;
+            // Step 2: Execute the agent within the chat context
+            const executionPayload = {
+                query,
+                max_steps: maxSteps ?? 10,
+            };
+            // Add structured output schema if provided
+            if (outputSchema) {
+                executionPayload.output_schema = this.pydanticToJsonSchema(outputSchema);
+                logger.info(`🔧 Using structured output with schema`);
+            }
+            const headers = {
+                'Content-Type': 'application/json',
+                'x-api-key': this.apiKey,
+            };
+            const executionUrl = `${this.baseUrl}${API_CHAT_EXECUTE_ENDPOINT.replace('{chat_id}', chatId)}`;
+            logger.info(`🚀 Executing agent in chat ${chatId}`);
+            const response = await fetch(executionUrl, {
+                method: 'POST',
+                headers,
+                body: JSON.stringify(executionPayload),
+                signal: AbortSignal.timeout(300000), // 5 minute timeout
+            });
+            if (!response.ok) {
+                const responseText = await response.text();
+                const statusCode = response.status;
+                // Provide specific error messages based on status code
+                if (statusCode === 401) {
+                    logger.error(`❌ Authentication failed: ${responseText}`);
+                    throw new Error('Authentication failed: Invalid or missing API key. '
+                        + 'Please check your API key and ensure the MCP_USE_API_KEY environment variable is set correctly.');
+                }
+                else if (statusCode === 403) {
+                    logger.error(`❌ Access forbidden: ${responseText}`);
+                    throw new Error(`Access denied: You don't have permission to execute agent '${this.agentId}'. `
+                        + 'Check if the agent exists and you have the necessary permissions.');
+                }
+                else if (statusCode === 404) {
+                    logger.error(`❌ Agent not found: ${responseText}`);
+                    throw new Error(`Agent not found: Agent '${this.agentId}' does not exist or you don't have access to it. `
+                        + 'Please verify the agent ID and ensure it exists in your account.');
+                }
+                else if (statusCode === 422) {
+                    logger.error(`❌ Validation error: ${responseText}`);
+                    throw new Error(`Request validation failed: ${responseText}. `
+                        + 'Please check your query parameters and output schema format.');
+                }
+                else if (statusCode === 500) {
+                    logger.error(`❌ Server error: ${responseText}`);
+                    throw new Error('Internal server error occurred during agent execution. '
+                        + 'Please try again later or contact support if the issue persists.');
+                }
+                else {
+                    logger.error(`❌ Remote execution failed with status ${statusCode}: ${responseText}`);
+                    throw new Error(`Remote agent execution failed: ${statusCode} - ${responseText}`);
+                }
+            }
+            const result = await response.json();
+            logger.info(`🔧 Response: ${JSON.stringify(result)}`);
+            logger.info('✅ Remote execution completed successfully');
+            // Check for error responses (even with 200 status)
+            if (typeof result === 'object' && result !== null) {
+                // Check for actual error conditions (not just presence of error field)
+                if (result.status === 'error' || result.error !== null) {
+                    const errorMsg = result.error ?? String(result);
+                    logger.error(`❌ Remote agent execution failed: ${errorMsg}`);
+                    throw new Error(`Remote agent execution failed: ${errorMsg}`);
+                }
+                // Check if the response indicates agent initialization failure
+                if (String(result).includes('failed to initialize')) {
+                    logger.error(`❌ Agent initialization failed: ${result}`);
+                    throw new Error('Agent initialization failed on remote server. '
+                        + 'This usually indicates:\n'
+                        + '• Invalid agent configuration (LLM model, system prompt)\n'
+                        + '• Missing or invalid MCP server configurations\n'
+                        + '• Network connectivity issues with MCP servers\n'
+                        + '• Missing environment variables or credentials\n'
+                        + `Raw error: ${result}`);
+                }
+            }
+            // Handle structured output
+            if (outputSchema) {
+                return this.parseStructuredResponse(result, outputSchema);
+            }
+            // Regular string output
+            if (typeof result === 'object' && result !== null && 'result' in result) {
+                return result.result;
+            }
+            else if (typeof result === 'string') {
+                return result;
+            }
+            else {
+                return String(result);
+            }
+        }
+        catch (e) {
+            if (e instanceof Error) {
+                // Check for specific error types
+                if (e.name === 'AbortError') {
+                    logger.error(`❌ Remote execution timed out: ${e}`);
+                    throw new Error('Remote agent execution timed out. The server may be overloaded or the query is taking too long to '
+                        + 'process. Try again or use a simpler query.');
+                }
+                logger.error(`❌ Remote execution error: ${e}`);
+                throw new Error(`Remote agent execution failed: ${e.message}`);
+            }
+            logger.error(`❌ Remote execution error: ${e}`);
+            throw new Error(`Remote agent execution failed: ${String(e)}`);
+        }
+    }
+    async *stream(query, maxSteps, manageConnector, externalHistory, outputSchema) {
+        /**
+         * Stream implementation for remote agent - currently just wraps run.
+         * In the future, this could be enhanced to support actual streaming from the API.
+         */
+        const result = await this.run(query, maxSteps, manageConnector, externalHistory, outputSchema);
+        return result;
+    }
+    async close() {
+        /**
+         * Close the remote agent connection.
+         */
+        logger.info('🔌 Remote agent client closed');
+        // In the future, we might want to delete the chat session here
+        // if (this.chatId) {
+        //   await this.deleteChatSession(this.chatId)
+        // }
+    }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mcp-use",
   "type": "module",
-  "version": "0.1.12",
+  "version": "0.1.15",
   "packageManager": "pnpm@10.6.1",
   "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",
@@ -111,10 +111,8 @@
   },
   "lint-staged": {
     "*.{js,ts}": [
-      "npm run lint"
-    ],
-    "**/*.ts": [
-      "npm run build"
+      "eslint --fix",
+      "eslint"
     ]
   }
 }