mcp-use 1.2.5-dev.5 → 1.3.0-canary.1

package/dist/src/agents/index.cjs

@@ -2464,6 +2464,185 @@ var MCPAgent = class {
       return String(value);
     }
   }
+  /**
+   * Check if a message is AI/assistant-like regardless of whether it's a class instance.
+   * Handles version mismatches, serialization boundaries, and different message formats.
+   *
+   * This method solves the issue where messages from LangChain agents may be plain JavaScript
+   * objects (e.g., `{ type: 'ai', content: '...' }`) instead of AIMessage instances due to
+   * serialization/deserialization across module boundaries or version mismatches.
+   *
+   * @example
+   * // Real AIMessage instance (standard case)
+   * _isAIMessageLike(new AIMessage("hello")) // => true
+   *
+   * @example
+   * // Plain object after serialization (fixes issue #446)
+   * _isAIMessageLike({ type: "ai", content: "hello" }) // => true
+   *
+   * @example
+   * // OpenAI-style format with role
+   * _isAIMessageLike({ role: "assistant", content: "hello" }) // => true
+   *
+   * @example
+   * // Object with getType() method
+   * _isAIMessageLike({ getType: () => "ai", content: "hello" }) // => true
+   *
+   * @param message - The message object to check
+   * @returns true if the message represents an AI/assistant message
+   */
+  _isAIMessageLike(message) {
+    if (message instanceof import_langchain2.AIMessage) {
+      return true;
+    }
+    if (typeof message !== "object" || message === null) {
+      return false;
+    }
+    const msg = message;
+    if (typeof msg.getType === "function") {
+      try {
+        const type = msg.getType();
+        if (type === "ai" || type === "assistant") {
+          return true;
+        }
+      } catch (error) {
+      }
+    }
+    if (typeof msg._getType === "function") {
+      try {
+        const type = msg._getType();
+        if (type === "ai" || type === "assistant") {
+          return true;
+        }
+      } catch (error) {
+      }
+    }
+    if ("type" in msg) {
+      return msg.type === "ai" || msg.type === "assistant";
+    }
+    if ("role" in msg) {
+      return msg.role === "ai" || msg.role === "assistant";
+    }
+    return false;
+  }
+  /**
+   * Check if a message has tool calls, handling both class instances and plain objects.
+   * Safely checks for tool_calls array presence.
+   *
+   * @example
+   * // AIMessage with tool calls
+   * const msg = new AIMessage({ content: "", tool_calls: [{ name: "add", args: {} }] });
+   * _messageHasToolCalls(msg) // => true
+   *
+   * @example
+   * // Plain object with tool calls
+   * _messageHasToolCalls({ type: "ai", tool_calls: [{ name: "add" }] }) // => true
+   *
+   * @example
+   * // Message without tool calls
+   * _messageHasToolCalls({ type: "ai", content: "hello" }) // => false
+   *
+   * @param message - The message object to check
+   * @returns true if the message has non-empty tool_calls array
+   */
+  _messageHasToolCalls(message) {
+    if (typeof message === "object" && message !== null && "tool_calls" in message && Array.isArray(message.tool_calls)) {
+      return message.tool_calls.length > 0;
+    }
+    return false;
+  }
+  /**
+   * Check if a message is a HumanMessage-like object.
+   * Handles both class instances and plain objects from serialization.
+   *
+   * @example
+   * _isHumanMessageLike(new HumanMessage("hello")) // => true
+   * _isHumanMessageLike({ type: "human", content: "hello" }) // => true
+   *
+   * @param message - The message object to check
+   * @returns true if the message represents a human message
+   */
+  _isHumanMessageLike(message) {
+    if (message instanceof import_langchain2.HumanMessage) {
+      return true;
+    }
+    if (typeof message !== "object" || message === null) {
+      return false;
+    }
+    const msg = message;
+    if (typeof msg.getType === "function") {
+      try {
+        const type = msg.getType();
+        if (type === "human" || type === "user") {
+          return true;
+        }
+      } catch (error) {
+      }
+    }
+    if ("type" in msg && (msg.type === "human" || msg.type === "user")) {
+      return true;
+    }
+    if ("role" in msg && (msg.role === "human" || msg.role === "user")) {
+      return true;
+    }
+    return false;
+  }
+  /**
+   * Check if a message is a ToolMessage-like object.
+   * Handles both class instances and plain objects from serialization.
+   *
+   * @example
+   * _isToolMessageLike(new ToolMessage({ content: "result", tool_call_id: "123" })) // => true
+   * _isToolMessageLike({ type: "tool", content: "result" }) // => true
+   *
+   * @param message - The message object to check
+   * @returns true if the message represents a tool message
+   */
+  _isToolMessageLike(message) {
+    if (message instanceof import_langchain2.ToolMessage) {
+      return true;
+    }
+    if (typeof message !== "object" || message === null) {
+      return false;
+    }
+    const msg = message;
+    if (typeof msg.getType === "function") {
+      try {
+        const type = msg.getType();
+        if (type === "tool") {
+          return true;
+        }
+      } catch (error) {
+      }
+    }
+    if ("type" in msg && msg.type === "tool") {
+      return true;
+    }
+    return false;
+  }
+  /**
+   * Extract content from a message, handling both AIMessage instances and plain objects.
+   *
+   * @example
+   * // From AIMessage instance
+   * _getMessageContent(new AIMessage("hello")) // => "hello"
+   *
+   * @example
+   * // From plain object
+   * _getMessageContent({ type: "ai", content: "hello" }) // => "hello"
+   *
+   * @param message - The message object to extract content from
+   * @returns The content of the message, or undefined if not present
+   */
+  _getMessageContent(message) {
+    if (message instanceof import_langchain2.AIMessage) {
+      return message.content;
+    }
+    if (message && typeof message === "object" && "content" in message) {
+      return message.content;
+    }
+    return void 0;
+  }
   async _consumeAndReturn(generator) {
     while (true) {
       const { done, value } = await generator.next();
@@ -2535,7 +2714,7 @@ var MCPAgent = class {
       const historyToUse = externalHistory ?? this.conversationHistory;
       const langchainHistory = [];
       for (const msg of historyToUse) {
-        if (msg instanceof import_langchain2.HumanMessage || msg instanceof import_langchain2.AIMessage) {
+        if (this._isHumanMessageLike(msg) || this._isAIMessageLike(msg)) {
           langchainHistory.push(msg);
         }
       }
@@ -2604,7 +2783,7 @@ var MCPAgent = class {
                     };
                   }
                 }
-                if (message instanceof import_langchain2.ToolMessage || message && "type" in message && message.type === "tool") {
+                if (this._isToolMessageLike(message)) {
                   const observation = message.content;
                   let observationStr = String(observation);
                   if (observationStr.length > 100) {
@@ -2639,8 +2818,10 @@ var MCPAgent = class {
                     }
                   }
                 }
-                if (message instanceof import_langchain2.AIMessage && !("tool_calls" in message && Array.isArray(message.tool_calls) && message.tool_calls.length > 0)) {
-                  finalOutput = this._normalizeOutput(message.content);
+                if (this._isAIMessageLike(message) && !this._messageHasToolCalls(message)) {
+                  finalOutput = this._normalizeOutput(
+                    this._getMessageContent(message)
+                  );
                   logger.info("\u2705 Agent finished with output");
                 }
               }
@@ -2823,10 +3004,12 @@ var MCPAgent = class {
       const historyToUse = externalHistory ?? this.conversationHistory;
       const langchainHistory = [];
       for (const msg of historyToUse) {
-        if (msg instanceof import_langchain2.HumanMessage || msg instanceof import_langchain2.AIMessage || msg instanceof import_langchain2.ToolMessage) {
+        if (this._isHumanMessageLike(msg) || this._isAIMessageLike(msg) || this._isToolMessageLike(msg)) {
           langchainHistory.push(msg);
         } else {
-          logger.info(`\u26A0\uFE0F Skipped message of type: ${msg.constructor.name}`);
+          logger.info(
+            `\u26A0\uFE0F Skipped message of type: ${msg.constructor?.name || typeof msg}`
+          );
         }
       }
       const inputs = [

package/dist/src/agents/index.js

@@ -1,7 +1,7 @@
 import {
   MCPAgent,
   RemoteAgent
-} from "../../chunk-73SH52J2.js";
+} from "../../chunk-6EHM3S3M.js";
 import "../../chunk-YURRUCIM.js";
 import "../../chunk-34R6SIER.js";
 import {

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

@@ -2,11 +2,11 @@ import type { BaseCallbackHandler } from "@langchain/core/callbacks/base";
 import type { BaseLanguageModelInterface, LanguageModelLike } from "@langchain/core/language_models/base";
 import type { StructuredToolInterface } from "@langchain/core/tools";
 import type { StreamEvent } from "@langchain/core/tracers/log_stream";
+import { SystemMessage } from "langchain";
 import type { ZodSchema } from "zod";
+import { LangChainAdapter } from "../adapters/langchain_adapter.js";
 import type { MCPClient } from "../client.js";
 import type { BaseConnector } from "../connectors/base.js";
-import { SystemMessage } from "langchain";
-import { LangChainAdapter } from "../adapters/langchain_adapter.js";
 import { ServerManager } from "../managers/server_manager.js";
 import { ObservabilityManager } from "../observability/index.js";
 import type { BaseMessage } from "./types.js";
@@ -130,6 +130,94 @@ export declare class MCPAgent {
      */
     private getMCPServerInfo;
     private _normalizeOutput;
+    /**
+     * Check if a message is AI/assistant-like regardless of whether it's a class instance.
+     * Handles version mismatches, serialization boundaries, and different message formats.
+     *
+     * This method solves the issue where messages from LangChain agents may be plain JavaScript
+     * objects (e.g., `{ type: 'ai', content: '...' }`) instead of AIMessage instances due to
+     * serialization/deserialization across module boundaries or version mismatches.
+     *
+     * @example
+     * // Real AIMessage instance (standard case)
+     * _isAIMessageLike(new AIMessage("hello")) // => true
+     *
+     * @example
+     * // Plain object after serialization (fixes issue #446)
+     * _isAIMessageLike({ type: "ai", content: "hello" }) // => true
+     *
+     * @example
+     * // OpenAI-style format with role
+     * _isAIMessageLike({ role: "assistant", content: "hello" }) // => true
+     *
+     * @example
+     * // Object with getType() method
+     * _isAIMessageLike({ getType: () => "ai", content: "hello" }) // => true
+     *
+     * @param message - The message object to check
+     * @returns true if the message represents an AI/assistant message
+     */
+    private _isAIMessageLike;
+    /**
+     * Check if a message has tool calls, handling both class instances and plain objects.
+     * Safely checks for tool_calls array presence.
+     *
+     * @example
+     * // AIMessage with tool calls
+     * const msg = new AIMessage({ content: "", tool_calls: [{ name: "add", args: {} }] });
+     * _messageHasToolCalls(msg) // => true
+     *
+     * @example
+     * // Plain object with tool calls
+     * _messageHasToolCalls({ type: "ai", tool_calls: [{ name: "add" }] }) // => true
+     *
+     * @example
+     * // Message without tool calls
+     * _messageHasToolCalls({ type: "ai", content: "hello" }) // => false
+     *
+     * @param message - The message object to check
+     * @returns true if the message has non-empty tool_calls array
+     */
+    private _messageHasToolCalls;
+    /**
+     * Check if a message is a HumanMessage-like object.
+     * Handles both class instances and plain objects from serialization.
+     *
+     * @example
+     * _isHumanMessageLike(new HumanMessage("hello")) // => true
+     * _isHumanMessageLike({ type: "human", content: "hello" }) // => true
+     *
+     * @param message - The message object to check
+     * @returns true if the message represents a human message
+     */
+    private _isHumanMessageLike;
+    /**
+     * Check if a message is a ToolMessage-like object.
+     * Handles both class instances and plain objects from serialization.
+     *
+     * @example
+     * _isToolMessageLike(new ToolMessage({ content: "result", tool_call_id: "123" })) // => true
+     * _isToolMessageLike({ type: "tool", content: "result" }) // => true
+     *
+     * @param message - The message object to check
+     * @returns true if the message represents a tool message
+     */
+    private _isToolMessageLike;
+    /**
+     * Extract content from a message, handling both AIMessage instances and plain objects.
+     *
+     * @example
+     * // From AIMessage instance
+     * _getMessageContent(new AIMessage("hello")) // => "hello"
+     *
+     * @example
+     * // From plain object
+     * _getMessageContent({ type: "ai", content: "hello" }) // => "hello"
+     *
+     * @param message - The message object to extract content from
+     * @returns The content of the message, or undefined if not present
+     */
+    private _getMessageContent;
     private _consumeAndReturn;
     /**
      * Runs the agent and returns a promise for the final result.

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":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAC1E,OAAO,KAAK,EACV,0BAA0B,EAC1B,iBAAiB,EAClB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AACrC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D,OAAO,EAIL,aAAa,EAKd,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAEpE,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAQjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;GAIG;AACH,MAAM,MAAM,aAAa,GACrB,iBAAiB,GACjB,0BAA0B,GAC1B,GAAG,CAAC;AAER;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,GAAG,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;IACF,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,QAAQ;IACnB,OAAO,CAAC,GAAG,CAAC,CAAgB;IAC5B,OAAO,CAAC,MAAM,CAAC,CAAY;IAC3B,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,cAAc,CAAU;IAChC,OAAO,CAAC,aAAa,CAAU;IAC/B,OAAO,CAAC,eAAe,CAAW;IAClC,OAAO,CAAC,eAAe,CAA4B;IAC5C,cAAc,EAAE,MAAM,EAAE,CAAM;IACrC,OAAO,CAAC,gBAAgB,CAAU;IAClC,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,YAAY,CAAC,CAAgB;IACrC,OAAO,CAAC,4BAA4B,CAAC,CAAgB;IACrD,OAAO,CAAC,sBAAsB,CAAC,CAAgB;IAE/C,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,mBAAmB,CAAqB;IAChD,OAAO,CAAC,cAAc,CAA2B;IACjD,OAAO,CAAC,QAAQ,CAAkC;IAClD,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,SAAS,CAAS;IAGnB,oBAAoB,EAAE,oBAAoB,CAAC;IAClD,OAAO,CAAC,SAAS,CAA6B;IAC9C,OAAO,CAAC,QAAQ,CAA2B;IAC3C,OAAO,CAAC,IAAI,CAAgB;IAG5B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,WAAW,CAA4B;gBAEnC,OAAO,EAAE;QACnB,GAAG,CAAC,EAAE,aAAa,CAAC;QACpB,MAAM,CAAC,EAAE,SAAS,CAAC;QACnB,UAAU,CAAC,EAAE,aAAa,EAAE,CAAC;QAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,aAAa,CAAC,EAAE,OAAO,CAAC;QACxB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACrC,sBAAsB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACvC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;QAC3B,eAAe,CAAC,EAAE,uBAAuB,EAAE,CAAC;QAC5C,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;QAC1B,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,OAAO,CAAC,EAAE,gBAAgB,CAAC;QAC3B,oBAAoB,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,aAAa,CAAC;QAC5D,SAAS,CAAC,EAAE,mBAAmB,EAAE,CAAC;QAElC,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB;IAoHY,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;YAkG1B,4BAA4B;IA0B1C,OAAO,CAAC,WAAW;IA6BZ,sBAAsB,IAAI,WAAW,EAAE;IAIvC,wBAAwB,IAAI,IAAI;IAKvC,OAAO,CAAC,YAAY;IAIb,gBAAgB,IAAI,aAAa,GAAG,IAAI;IAIxC,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAevC,kBAAkB,CAAC,eAAe,EAAE,MAAM,EAAE,GAAG,IAAI;IAUnD,kBAAkB,IAAI,MAAM,EAAE;IAIrC;;;OAGG;IACI,WAAW,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAS1D;;;OAGG;IACI,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAIzC;;;OAGG;IACI,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI;IAOvC;;;OAGG;IACI,OAAO,IAAI,MAAM,EAAE;IAI1B;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IA4DxB;;;;OAIG;IACH,OAAO,CAAC,YAAY;IAOpB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAgExB,OAAO,CAAC,gBAAgB;YAqDV,iBAAiB;IAc/B;;OAEG;IACU,GAAG,CACd,KAAK,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,MAAM,EACjB,eAAe,CAAC,EAAE,OAAO,EACzB,eAAe,CAAC,EAAE,WAAW,EAAE,GAC9B,OAAO,CAAC,MAAM,CAAC;IAElB;;OAEG;IACU,GAAG,CAAC,CAAC,EAChB,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;IA8BC,MAAM,CAAC,CAAC,GAAG,MAAM,EAC7B,KAAK,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,MAAM,EACjB,eAAe,UAAO,EACtB,eAAe,CAAC,EAAE,WAAW,EAAE,EAC/B,YAAY,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,GAC1B,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,CAAC,EAAE,IAAI,CAAC;IAqW9C;;;OAGG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAWtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAiCnC;;;OAGG;IACW,YAAY,CAAC,CAAC,GAAG,MAAM,EACnC,KAAK,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,MAAM,EACjB,eAAe,UAAO,EACtB,eAAe,CAAC,EAAE,WAAW,EAAE,EAC/B,YAAY,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,GAC1B,cAAc,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,CAAC;IAuR1C;;;;;;OAMG;YACW,wBAAwB;IAmLtC;;OAEG;IACH,OAAO,CAAC,yBAAyB;IA2CjC;;OAEG;IACH,OAAO,CAAC,uBAAuB;CA2BhC"}
+{"version":3,"file":"mcp_agent.d.ts","sourceRoot":"","sources":["../../../src/agents/mcp_agent.ts"],"names":[],"mappings":"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"}

package/dist/src/browser.cjs

@@ -814,6 +814,7 @@ var BaseConnector = class {
   connectionManager = null;
   toolsCache = null;
   capabilitiesCache = null;
+  serverInfoCache = null;
   connected = false;
   opts;
   constructor(opts = {}) {
@@ -848,6 +849,8 @@ var BaseConnector = class {
     logger.debug("Caching server capabilities & tools");
     const capabilities = this.client.getServerCapabilities();
     this.capabilitiesCache = capabilities;
+    const serverInfo = this.client.getServerVersion();
+    this.serverInfoCache = serverInfo || null;
     const listToolsRes = await this.client.listTools(
       void 0,
       defaultRequestOptions
@@ -855,6 +858,7 @@ var BaseConnector = class {
     this.toolsCache = listToolsRes.tools ?? [];
     logger.debug(`Fetched ${this.toolsCache.length} tools from server`);
     logger.debug("Server capabilities:", capabilities);
+    logger.debug("Server info:", serverInfo);
     return capabilities;
   }
   /** Lazily expose the cached tools list. */
@@ -864,6 +868,14 @@ var BaseConnector = class {
     }
     return this.toolsCache;
   }
+  /** Expose cached server capabilities. */
+  get serverCapabilities() {
+    return this.capabilitiesCache;
+  }
+  /** Expose cached server info. */
+  get serverInfo() {
+    return this.serverInfoCache;
+  }
   /** Call a tool on the server. */
   async callTool(name, args, options) {
     if (!this.client) {
@@ -3523,6 +3535,185 @@ var MCPAgent = class {
       return String(value);
     }
   }
+  /**
+   * Check if a message is AI/assistant-like regardless of whether it's a class instance.
+   * Handles version mismatches, serialization boundaries, and different message formats.
+   *
+   * This method solves the issue where messages from LangChain agents may be plain JavaScript
+   * objects (e.g., `{ type: 'ai', content: '...' }`) instead of AIMessage instances due to
+   * serialization/deserialization across module boundaries or version mismatches.
+   *
+   * @example
+   * // Real AIMessage instance (standard case)
+   * _isAIMessageLike(new AIMessage("hello")) // => true
+   *
+   * @example
+   * // Plain object after serialization (fixes issue #446)
+   * _isAIMessageLike({ type: "ai", content: "hello" }) // => true
+   *
+   * @example
+   * // OpenAI-style format with role
+   * _isAIMessageLike({ role: "assistant", content: "hello" }) // => true
+   *
+   * @example
+   * // Object with getType() method
+   * _isAIMessageLike({ getType: () => "ai", content: "hello" }) // => true
+   *
+   * @param message - The message object to check
+   * @returns true if the message represents an AI/assistant message
+   */
+  _isAIMessageLike(message) {
+    if (message instanceof import_langchain2.AIMessage) {
+      return true;
+    }
+    if (typeof message !== "object" || message === null) {
+      return false;
+    }
+    const msg = message;
+    if (typeof msg.getType === "function") {
+      try {
+        const type = msg.getType();
+        if (type === "ai" || type === "assistant") {
+          return true;
+        }
+      } catch (error) {
+      }
+    }
+    if (typeof msg._getType === "function") {
+      try {
+        const type = msg._getType();
+        if (type === "ai" || type === "assistant") {
+          return true;
+        }
+      } catch (error) {
+      }
+    }
+    if ("type" in msg) {
+      return msg.type === "ai" || msg.type === "assistant";
+    }
+    if ("role" in msg) {
+      return msg.role === "ai" || msg.role === "assistant";
+    }
+    return false;
+  }
+  /**
+   * Check if a message has tool calls, handling both class instances and plain objects.
+   * Safely checks for tool_calls array presence.
+   *
+   * @example
+   * // AIMessage with tool calls
+   * const msg = new AIMessage({ content: "", tool_calls: [{ name: "add", args: {} }] });
+   * _messageHasToolCalls(msg) // => true
+   *
+   * @example
+   * // Plain object with tool calls
+   * _messageHasToolCalls({ type: "ai", tool_calls: [{ name: "add" }] }) // => true
+   *
+   * @example
+   * // Message without tool calls
+   * _messageHasToolCalls({ type: "ai", content: "hello" }) // => false
+   *
+   * @param message - The message object to check
+   * @returns true if the message has non-empty tool_calls array
+   */
+  _messageHasToolCalls(message) {
+    if (typeof message === "object" && message !== null && "tool_calls" in message && Array.isArray(message.tool_calls)) {
+      return message.tool_calls.length > 0;
+    }
+    return false;
+  }
+  /**
+   * Check if a message is a HumanMessage-like object.
+   * Handles both class instances and plain objects from serialization.
+   *
+   * @example
+   * _isHumanMessageLike(new HumanMessage("hello")) // => true
+   * _isHumanMessageLike({ type: "human", content: "hello" }) // => true
+   *
+   * @param message - The message object to check
+   * @returns true if the message represents a human message
+   */
+  _isHumanMessageLike(message) {
+    if (message instanceof import_langchain2.HumanMessage) {
+      return true;
+    }
+    if (typeof message !== "object" || message === null) {
+      return false;
+    }
+    const msg = message;
+    if (typeof msg.getType === "function") {
+      try {
+        const type = msg.getType();
+        if (type === "human" || type === "user") {
+          return true;
+        }
+      } catch (error) {
+      }
+    }
+    if ("type" in msg && (msg.type === "human" || msg.type === "user")) {
+      return true;
+    }
+    if ("role" in msg && (msg.role === "human" || msg.role === "user")) {
+      return true;
+    }
+    return false;
+  }
+  /**
+   * Check if a message is a ToolMessage-like object.
+   * Handles both class instances and plain objects from serialization.
+   *
+   * @example
+   * _isToolMessageLike(new ToolMessage({ content: "result", tool_call_id: "123" })) // => true
+   * _isToolMessageLike({ type: "tool", content: "result" }) // => true
+   *
+   * @param message - The message object to check
+   * @returns true if the message represents a tool message
+   */
+  _isToolMessageLike(message) {
+    if (message instanceof import_langchain2.ToolMessage) {
+      return true;
+    }
+    if (typeof message !== "object" || message === null) {
+      return false;
+    }
+    const msg = message;
+    if (typeof msg.getType === "function") {
+      try {
+        const type = msg.getType();
+        if (type === "tool") {
+          return true;
+        }
+      } catch (error) {
+      }
+    }
+    if ("type" in msg && msg.type === "tool") {
+      return true;
+    }
+    return false;
+  }
+  /**
+   * Extract content from a message, handling both AIMessage instances and plain objects.
+   *
+   * @example
+   * // From AIMessage instance
+   * _getMessageContent(new AIMessage("hello")) // => "hello"
+   *
+   * @example
+   * // From plain object
+   * _getMessageContent({ type: "ai", content: "hello" }) // => "hello"
+   *
+   * @param message - The message object to extract content from
+   * @returns The content of the message, or undefined if not present
+   */
+  _getMessageContent(message) {
+    if (message instanceof import_langchain2.AIMessage) {
+      return message.content;
+    }
+    if (message && typeof message === "object" && "content" in message) {
+      return message.content;
+    }
+    return void 0;
+  }
   async _consumeAndReturn(generator) {
     while (true) {
       const { done, value } = await generator.next();
@@ -3594,7 +3785,7 @@ var MCPAgent = class {
       const historyToUse = externalHistory ?? this.conversationHistory;
       const langchainHistory = [];
       for (const msg of historyToUse) {
-        if (msg instanceof import_langchain2.HumanMessage || msg instanceof import_langchain2.AIMessage) {
+        if (this._isHumanMessageLike(msg) || this._isAIMessageLike(msg)) {
           langchainHistory.push(msg);
         }
       }
@@ -3663,7 +3854,7 @@ var MCPAgent = class {
                     };
                   }
                 }
-                if (message instanceof import_langchain2.ToolMessage || message && "type" in message && message.type === "tool") {
+                if (this._isToolMessageLike(message)) {
                   const observation = message.content;
                   let observationStr = String(observation);
                   if (observationStr.length > 100) {
@@ -3698,8 +3889,10 @@ var MCPAgent = class {
                     }
                   }
                 }
-                if (message instanceof import_langchain2.AIMessage && !("tool_calls" in message && Array.isArray(message.tool_calls) && message.tool_calls.length > 0)) {
-                  finalOutput = this._normalizeOutput(message.content);
+                if (this._isAIMessageLike(message) && !this._messageHasToolCalls(message)) {
+                  finalOutput = this._normalizeOutput(
+                    this._getMessageContent(message)
+                  );
                   logger.info("\u2705 Agent finished with output");
                 }
               }
@@ -3882,10 +4075,12 @@ var MCPAgent = class {
       const historyToUse = externalHistory ?? this.conversationHistory;
       const langchainHistory = [];
       for (const msg of historyToUse) {
-        if (msg instanceof import_langchain2.HumanMessage || msg instanceof import_langchain2.AIMessage || msg instanceof import_langchain2.ToolMessage) {
+        if (this._isHumanMessageLike(msg) || this._isAIMessageLike(msg) || this._isToolMessageLike(msg)) {
           langchainHistory.push(msg);
         } else {
-          logger.info(`\u26A0\uFE0F Skipped message of type: ${msg.constructor.name}`);
+          logger.info(
+            `\u26A0\uFE0F Skipped message of type: ${msg.constructor?.name || typeof msg}`
+          );
         }
       }
       const inputs = [

package/dist/src/browser.js

@@ -9,7 +9,7 @@ import {
   MCPAgent,
   ObservabilityManager,
   RemoteAgent
-} from "../chunk-73SH52J2.js";
+} from "../chunk-6EHM3S3M.js";
 import {
   BaseConnector,
   BrowserMCPClient,
@@ -18,7 +18,7 @@ import {
   MCPSession,
   WebSocketConnector,
   onMcpAuthorization
-} from "../chunk-37MPZ3D6.js";
+} from "../chunk-TIUSJAAE.js";
 import "../chunk-YURRUCIM.js";
 import {
   Logger,

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

@@ -25,6 +25,10 @@ export declare abstract class BaseConnector {
     protected connectionManager: ConnectionManager<any> | null;
     protected toolsCache: Tool[] | null;
     protected capabilitiesCache: any;
+    protected serverInfoCache: {
+        name: string;
+        version?: string;
+    } | null;
     protected connected: boolean;
     protected readonly opts: ConnectorInitOptions;
     constructor(opts?: ConnectorInitOptions);
@@ -46,6 +50,13 @@ export declare abstract class BaseConnector {
     initialize(defaultRequestOptions?: RequestOptions): Promise<ReturnType<Client["getServerCapabilities"]>>;
     /** Lazily expose the cached tools list. */
     get tools(): Tool[];
+    /** Expose cached server capabilities. */
+    get serverCapabilities(): any;
+    /** Expose cached server info. */
+    get serverInfo(): {
+        name: string;
+        version?: string;
+    } | null;
     /** Call a tool on the server. */
     callTool(name: string, args: Record<string, any>, options?: RequestOptions): Promise<CallToolResult>;
     /**