@mcp-use/agent 2.0.0-beta.18 → 2.0.0-beta.19

package/dist/langchain.d.ts

@@ -1,14 +1,18 @@
 /**
- * LangChain bridge for @mcp-use/agent.
+ * LangChain bridge for `@mcp-use/agent`.
  */
 export { MCPAgent } from "./agents/mcp_agent_langchain.js";
 /** @deprecated Import `MCPAgent` from `@mcp-use/agent/langchain` instead. */
 export { MCPAgent as LangChainMCPAgent } from "./agents/mcp_agent_langchain.js";
 export { PROMPTS } from "./agents/prompts/index.js";
+export type { AgentStep as LangChainAgentStep, LangChainAgentAction, } from "./agents/mcp_agent_langchain.js";
+export type { BaseMessage, CommonAgentOptions, ExplicitModeOptions, LanguageModel, MCPAgentOptions, MCPServerConfig, SimplifiedModeOptions, } from "./agents/types.js";
+export type { RunOptions } from "./agents/run_options.js";
 export { LangChainAdapter } from "./adapters/langchain_adapter.js";
 export { ServerManager } from "./managers/server_manager.js";
+export type { IServerManager } from "./managers/types.js";
 export * from "./managers/tools/index.js";
 export * from "./agents/utils/index.js";
-export { type ObservabilityConfig, ObservabilityManager, } from "./observability/index.js";
+export { type ObservabilityConfig, ObservabilityManager, type ObservabilityStatus, } from "./observability/index.js";
 export { createLLMFromString, parseLLMString, getSupportedProviders, } from "./agents/utils/llm_provider.js";
 //# sourceMappingURL=langchain.d.ts.map

package/dist/langchain.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"langchain.d.ts","sourceRoot":"","sources":["../src/langchain.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAC3D,6EAA6E;AAC7E,OAAO,EAAE,QAAQ,IAAI,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAChF,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,OAAO,EACL,KAAK,mBAAmB,EACxB,oBAAoB,GACrB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,qBAAqB,GACtB,MAAM,gCAAgC,CAAC"}
+{"version":3,"file":"langchain.d.ts","sourceRoot":"","sources":["../src/langchain.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAC3D,6EAA6E;AAC7E,OAAO,EAAE,QAAQ,IAAI,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAChF,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACpD,YAAY,EACV,SAAS,IAAI,kBAAkB,EAC/B,oBAAoB,GACrB,MAAM,iCAAiC,CAAC;AACzC,YAAY,EACV,WAAW,EACX,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,EACb,eAAe,EACf,eAAe,EACf,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,OAAO,EACL,KAAK,mBAAmB,EACxB,oBAAoB,EACpB,KAAK,mBAAmB,GACzB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,qBAAqB,GACtB,MAAM,gCAAgC,CAAC"}

package/dist/langchain.js

@@ -692,6 +692,9 @@ var BaseAdapter = class {
    * generated for it.
    */
   connectorToolMap = /* @__PURE__ */ new Map();
+  /**
+   * @param disallowedTools - MCP tool names to omit during conversion.
+   */
   constructor(disallowedTools) {
     this.disallowedTools = disallowedTools ?? [];
   }
@@ -701,9 +704,9 @@ var BaseAdapter = class {
    * 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.
+   * @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 async createTools(client, disallowedTools) {
     const adapter = new this(disallowedTools);
@@ -720,8 +723,8 @@ var BaseAdapter = class {
   /**
    * 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.
+   * @param connector - The connector to load tools for.
+   * @returns The list of tools that were loaded in the target framework's format.
    */
   async loadToolsForConnector(connector) {
     if (this.connectorToolMap.has(connector)) {
@@ -749,8 +752,8 @@ var BaseAdapter = class {
   /**
    * 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.
+   * @param connectors - List of MCP connectors to create tools from.
+   * @returns A promise that resolves with all converted tools.
    */
   async createToolsFromConnectors(connectors) {
     const tools = [];
@@ -764,8 +767,8 @@ var BaseAdapter = class {
   /**
    * Dynamically load resources for a specific connector.
    *
-   * @param connector The connector to load resources for.
-   * @returns         The list of resources that were loaded in the target framework's format.
+   * @param connector - The connector to load resources for.
+   * @returns The list of resources that were loaded in the target framework's format.
    */
   async loadResourcesForConnector(connector) {
     const connectorResources = [];
@@ -795,8 +798,8 @@ var BaseAdapter = class {
   /**
    * Dynamically load prompts for a specific connector.
    *
-   * @param connector The connector to load prompts for.
-   * @returns         The list of prompts that were loaded in the target framework's format.
+   * @param connector - The connector to load prompts for.
+   * @returns The list of prompts that were loaded in the target framework's format.
    */
   async loadPromptsForConnector(connector) {
     const connectorPrompts = [];
@@ -826,8 +829,8 @@ var BaseAdapter = class {
   /**
    * Create resources from MCP resources in all provided connectors.
    *
-   * @param connectors List of MCP connectors to create resources from.
-   * @returns         A promise that resolves with all converted resources.
+   * @param connectors - List of MCP connectors to create resources from.
+   * @returns A promise that resolves with all converted resources.
    */
   async createResourcesFromConnectors(connectors) {
     const resources = [];
@@ -841,8 +844,8 @@ var BaseAdapter = class {
   /**
    * Create prompts from MCP prompts in all provided connectors.
    *
-   * @param connectors List of MCP connectors to create prompts from.
-   * @returns         A promise that resolves with all converted prompts.
+   * @param connectors - List of MCP connectors to create prompts from.
+   * @returns A promise that resolves with all converted prompts.
    */
   async createPromptsFromConnectors(connectors) {
     const prompts = [];
@@ -856,8 +859,8 @@ var BaseAdapter = class {
   /**
    * 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.
+   * @param connector - The connector to check.
+   * @returns True if the connector is initialized and has tools, false otherwise.
    */
   checkConnectorInitialized(connector) {
     return Boolean(connector.tools && connector.tools.length);
@@ -865,8 +868,8 @@ var BaseAdapter = class {
   /**
    * Ensure a connector is initialized.
    *
-   * @param connector The connector to initialize.
-   * @returns         True if initialization succeeded, false otherwise.
+   * @param connector - The connector to initialize.
+   * @returns True if initialization succeeded, false otherwise.
    */
   async ensureConnectorInitialized(connector) {
     if (!this.checkConnectorInitialized(connector)) {
@@ -897,6 +900,9 @@ function sanitizeToolName(name) {
 }
 var LangChainAdapter = class extends BaseAdapter {
   usedToolNames = /* @__PURE__ */ new Set();
+  /**
+   * @param disallowedTools - MCP tool names to omit during conversion.
+   */
   constructor(disallowedTools = []) {
     super(disallowedTools);
   }
@@ -923,6 +929,12 @@ var LangChainAdapter = class extends BaseAdapter {
     this.usedToolNames.add(fallback);
     return fallback;
   }
+  /**
+   * Converts MCP tools from all connectors and resets name deduplication.
+   *
+   * @param connectors - Connected MCP connectors.
+   * @returns LangChain structured tools.
+   */
   async createToolsFromConnectors(connectors) {
     this.usedToolNames.clear();
     return super.createToolsFromConnectors(connectors);
@@ -1064,10 +1076,16 @@ import { z as z2 } from "zod";
 // src/managers/tools/base.ts
 import { StructuredTool } from "@langchain/core/tools";
 var MCPServerTool = class extends StructuredTool {
+  /** Default tool name. Subclasses replace this value. */
   name = "mcp_server_tool";
+  /** Default tool description. Subclasses replace this value. */
   description = "Base tool for MCP server operations.";
+  /** Input schema supplied by the concrete management tool. */
   schema;
   _manager;
+  /**
+   * @param manager - Server manager operated by this tool.
+   */
   constructor(manager) {
     super();
     this._manager = manager;
@@ -1075,6 +1093,7 @@ var MCPServerTool = class extends StructuredTool {
   async _call(_arg, _runManager, _parentConfig) {
     throw new Error("Method not implemented.");
   }
+  /** @returns The server manager operated by this tool. */
   get manager() {
     return this._manager;
   }
@@ -1083,12 +1102,16 @@ var MCPServerTool = class extends StructuredTool {
 // src/managers/tools/acquire_active_mcp_server.ts
 var PresentActiveServerSchema = z2.object({});
 var AcquireActiveMCPServerTool = class extends MCPServerTool {
+  /** Tool name exposed to the model. */
   name = "get_active_mcp_server";
+  /** Tool description exposed to the model. */
   description = "Get the currently active MCP (Model Context Protocol) server";
+  /** Empty input schema. */
   schema = PresentActiveServerSchema;
   constructor(manager) {
     super(manager);
   }
+  /** @returns A message identifying the active server, or stating there is none. */
   async _call() {
     if (!this.manager.activeServer) {
       return `No MCP server is currently active. Use connect_to_mcp_server to connect to a server.`;
@@ -1102,19 +1125,32 @@ import { StructuredTool as StructuredTool2 } from "@langchain/core/tools";
 import { z as z3 } from "zod";
 import { logger as logger3 } from "@mcp-use/client";
 var AddMCPServerFromConfigTool = class extends StructuredTool2 {
+  /** Tool name exposed to the model. */
   name = "add_mcp_server_from_config";
+  /** Tool description exposed to the model. */
   description = "Adds a new MCP server to the client from a configuration object and connects to it, making its tools available.";
+  /** Input schema for the server name and transport configuration. */
   schema = z3.object({
+    /** Name used to register the server with the MCP client. */
     serverName: z3.string().describe("The name for the new MCP server."),
+    /** MCP transport configuration without a top-level `mcpServers` key. */
     serverConfig: z3.any().describe(
       'The configuration object for the server. This should not include the top-level "mcpServers" key.'
     )
   });
   manager;
+  /**
+   * @param manager - Server manager that receives the new server.
+   */
   constructor(manager) {
     super();
     this.manager = manager;
   }
+  /**
+   * Adds the server, opens a session, and makes the server active.
+   *
+   * @returns A success message with loaded tool names, or an error message.
+   */
   async _call({
     serverName,
     serverConfig
@@ -1151,15 +1187,24 @@ ${tools.map((t) => t.name).join("\n")}`;
 import { z as z4 } from "zod";
 import { logger as logger4 } from "@mcp-use/client";
 var ConnectMCPServerSchema = z4.object({
+  /** Name of a configured MCP server. */
   serverName: z4.string().describe("The name of the MCP server.")
 });
 var ConnectMCPServerTool = class extends MCPServerTool {
+  /** Tool name exposed to the model. */
   name = "connect_to_mcp_server";
+  /** Tool description exposed to the model. */
   description = "Connect to a specific MCP (Model Context Protocol) server to use its tools. Use this tool to connect to a specific server and use its tools.";
+  /** Input schema containing the server name. */
   schema = ConnectMCPServerSchema;
   constructor(manager) {
     super(manager);
   }
+  /**
+   * Activates a configured server and loads its capabilities if needed.
+   *
+   * @returns A human-readable success or error message.
+   */
   async _call({ serverName }) {
     const serverNames = this.manager.client.getServerNames();
     if (!serverNames.includes(serverName)) {
@@ -1206,12 +1251,16 @@ import { z as z5 } from "zod";
 import { logger as logger5 } from "@mcp-use/client";
 var EnumerateServersSchema = z5.object({});
 var ListMCPServersTool = class extends MCPServerTool {
+  /** Tool name exposed to the model. */
   name = "list_mcp_servers";
+  /** Tool description exposed to the model. */
   description = `Lists all available MCP (Model Context Protocol) servers that can be connected to, along with the tools available on each server. Use this tool to discover servers and see what functionalities they offer.`;
+  /** Empty input schema. */
   schema = EnumerateServersSchema;
   constructor(manager) {
     super(manager);
   }
+  /** @returns A formatted list of configured servers and capability counts. */
   async _call() {
     const serverNames = this.manager.client.getServerNames();
     if (serverNames.length === 0) {
@@ -1241,12 +1290,16 @@ var ListMCPServersTool = class extends MCPServerTool {
 import { z as z6 } from "zod";
 var ReleaseConnectionSchema = z6.object({});
 var ReleaseMCPServerConnectionTool = class extends MCPServerTool {
+  /** Tool name exposed to the model. */
   name = "disconnect_from_mcp_server";
+  /** Tool description exposed to the model. */
   description = "Disconnect from the currently active MCP (Model Context Protocol) server";
+  /** Empty input schema. */
   schema = ReleaseConnectionSchema;
   constructor(manager) {
     super(manager);
   }
+  /** @returns A message identifying the deactivated server, or stating there is none. */
   async _call() {
     if (!this.manager.activeServer) {
       return `No MCP server is currently active, so there's nothing to disconnect from.`;
@@ -1280,23 +1333,44 @@ function isEqual(a, b) {
   return false;
 }
 var ServerManager = class {
+  /** Whether capabilities have been loaded for each configured server. */
   initializedServers = {};
+  /** Cached LangChain tools, resources, and prompts by server name. */
   serverTools = {};
+  /** MCP client that owns server configurations and sessions. */
   client;
+  /** Adapter used to create LangChain tools. */
   adapter;
+  /** Server whose cached tools are currently exposed. */
   activeServer = null;
   overrideManagementTools;
+  /**
+   * @param client - MCP client that owns the managed servers.
+   * @param adapter - Adapter used to convert MCP capabilities.
+   * @param managementTools - Optional replacement for the built-in server
+   * management tools.
+   */
   constructor(client, adapter, managementTools) {
     this.client = client;
     this.adapter = adapter;
     this.overrideManagementTools = managementTools;
   }
+  /**
+   * Replaces the management tools returned by {@link ServerManager.tools}.
+   *
+   * @param tools - Complete replacement tool list.
+   */
   setManagementTools(tools) {
     this.overrideManagementTools = tools;
     logger6.debug(
       `Overriding default management tools with a new set of ${tools.length} tools.`
     );
   }
+  /**
+   * Writes current connection and tool-cache state at debug level.
+   *
+   * @param context - Label describing why the state was logged.
+   */
   logState(context) {
     const allServerNames = this.client.getServerNames();
     const activeSessionNames = Object.keys(this.client.getAllActiveSessions());
@@ -1314,12 +1388,17 @@ var ServerManager = class {
     logger6.debug(`Server Manager State: [${context}]`);
     console.table(tableData);
   }
+  /** Validates that the client contains at least one server configuration. */
   initialize() {
     const serverNames = this.client.getServerNames?.();
     if (serverNames.length === 0) {
       logger6.warn("No MCP servers defined in client configuration");
     }
   }
+  /**
+   * Connects configured servers as needed and caches all tools, resources, and
+   * prompts.
+   */
   async prefetchServerTools() {
     const servers = this.client.getServerNames();
     for (const serverName of servers) {
@@ -1381,6 +1460,9 @@ var ServerManager = class {
       }
     }
   }
+  /**
+   * @returns Management tools plus cached tools from the active server, if any.
+   */
   get tools() {
     if (logger6.level === "debug") {
       this.logState("Providing tools to agent");
@@ -1419,6 +1501,9 @@ var ObservabilityManager = class {
   metadata;
   metadataProvider;
   tagsProvider;
+  /**
+   * @param config - Callback selection and trace metadata settings.
+   */
   constructor(config = {}) {
     this.customCallbacks = config.customCallbacks;
     this.verbose = config.verbose ?? false;
@@ -1536,7 +1621,7 @@ var ObservabilityManager = class {
   }
   /**
    * Add a callback to the custom callbacks list.
-   * @param callback The callback to add.
+   * @param callback - The callback to add.
    */
   addCallback(callback) {
     if (!this.customCallbacks) {
@@ -1595,7 +1680,7 @@ var ObservabilityManager = class {
 };
 
 // src/version.ts
-var VERSION = "2.0.0-beta.18";
+var VERSION = "2.0.0-beta.19";
 function getPackageVersion() {
   return VERSION;
 }
@@ -1749,6 +1834,11 @@ var RemoteAgent = class {
   apiKey;
   baseUrl;
   chatId = null;
+  /**
+   * @param options - Hosted agent identifier and API connection settings.
+   * @throws Error if no API key is supplied or available from
+   * `MCP_USE_API_KEY`.
+   */
   constructor(options) {
     this.agentId = options.agentId;
     this.baseUrl = options.baseUrl ?? "https://cloud.manufact.com";
@@ -1974,6 +2064,7 @@ Raw error: ${result}`
     );
     return result;
   }
+  /** Releases local remote-agent state. */
   async close() {
     logger9.debug("\u{1F50C} Remote agent client closed");
   }
@@ -2153,6 +2244,7 @@ var MCPAgent = class {
   memoryEnabled;
   disallowedTools;
   additionalTools;
+  /** Names of tools invoked during the current or most recent execution. */
   toolsUsedNames = [];
   exposeResourcesAsTools = true;
   exposePromptsAsTools = true;
@@ -2174,6 +2266,7 @@ var MCPAgent = class {
   modelProvider;
   modelName;
   // Observability support
+  /** Observability callbacks and trace lifecycle manager. */
   observabilityManager;
   callbacks = [];
   metadata = {};
@@ -2187,6 +2280,13 @@ var MCPAgent = class {
   llmConfig;
   mcpServersConfig;
   clientOwnedByAgent = false;
+  /**
+   * Creates a LangChain MCP agent.
+   *
+   * @param options - Model, MCP servers, tools, and execution settings.
+   * @throws Error if local execution does not include a model and MCP client,
+   * connectors, or server configurations.
+   */
   constructor(options) {
     if (options.agentId) {
       this.isRemote = true;
@@ -2312,6 +2412,12 @@ var MCPAgent = class {
       configurable: true
     });
   }
+  /**
+   * Creates configured clients and models, connects MCP servers, loads tools,
+   * and builds the LangChain executor.
+   *
+   * @throws Error if a configured model or MCP server cannot be initialized.
+   */
   async initialize() {
     if (this.isRemote) {
       this._initialized = true;
@@ -2487,18 +2593,26 @@ var MCPAgent = class {
     );
     return agent;
   }
+  /** @returns A shallow copy of the stored LangChain message history. */
   getConversationHistory() {
     return [...this.conversationHistory];
   }
+  /** Clears stored history, retaining the system message when memory is enabled. */
   clearConversationHistory() {
     this.conversationHistory = this.memoryEnabled && this.systemMessage ? [this.systemMessage] : [];
   }
   addToHistory(message) {
     if (this.memoryEnabled) this.conversationHistory.push(message);
   }
+  /** @returns The current LangChain system message, or `null` before creation. */
   getSystemMessage() {
     return this.systemMessage;
   }
+  /**
+   * Replaces the system instruction and rebuilds an initialized executor.
+   *
+   * @param message - New system instruction.
+   */
   setSystemMessage(message) {
     this.systemMessage = new SystemMessage2(message);
     if (this.memoryEnabled) {
@@ -2512,6 +2626,11 @@ var MCPAgent = class {
       logger11.debug("Agent recreated with new system message");
     }
   }
+  /**
+   * Replaces the tool denylist for the next initialization.
+   *
+   * @param disallowedTools - MCP tool names to omit.
+   */
   setDisallowedTools(disallowedTools) {
     this.disallowedTools = disallowedTools;
     this.adapter = new LangChainAdapter(this.disallowedTools);
@@ -2521,6 +2640,7 @@ var MCPAgent = class {
       );
     }
   }
+  /** @returns The configured MCP tool denylist. */
   getDisallowedTools() {
     return this.disallowedTools;
   }
@@ -2710,20 +2830,28 @@ var MCPAgent = class {
    * serialization/deserialization across module boundaries or version mismatches.
    *
    * @example
-   * // Real AIMessage instance (standard case)
-   * _isAIMessageLike(new AIMessage("hello")) // => true
+   * ```ts
+   * // Real AIMessage instance (standard case).
+   * _isAIMessageLike(new AIMessage("hello")); // true
+   * ```
    *
    * @example
-   * // Plain object after serialization (fixes issue #446)
-   * _isAIMessageLike({ type: "ai", content: "hello" }) // => true
+   * ```ts
+   * // 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
+   * ```ts
+   * // OpenAI-style format with role.
+   * _isAIMessageLike({ role: "assistant", content: "hello" }); // true
+   * ```
    *
    * @example
-   * // Object with getType() method
-   * _isAIMessageLike({ getType: () => "ai", content: "hello" }) // => true
+   * ```ts
+   * // 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
@@ -2767,17 +2895,26 @@ var MCPAgent = class {
    * 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
+   * ```ts
+   * const message = new AIMessage({
+   *   content: "",
+   *   tool_calls: [{ name: "add", args: {} }],
+   * });
+   * _messageHasToolCalls(message); // true
+   * ```
    *
    * @example
-   * // Plain object with tool calls
-   * _messageHasToolCalls({ type: "ai", tool_calls: [{ name: "add" }] }) // => true
+   * ```ts
+   * _messageHasToolCalls({
+   *   type: "ai",
+   *   tool_calls: [{ name: "add" }],
+   * }); // true
+   * ```
    *
    * @example
-   * // Message without tool calls
-   * _messageHasToolCalls({ type: "ai", content: "hello" }) // => false
+   * ```ts
+   * _messageHasToolCalls({ type: "ai", content: "hello" }); // false
+   * ```
    *
    * @param message - The message object to check
    * @returns true if the message has non-empty tool_calls array
@@ -2793,8 +2930,10 @@ var MCPAgent = class {
    * Handles both class instances and plain objects from serialization.
    *
    * @example
-   * _isHumanMessageLike(new HumanMessage("hello")) // => true
-   * _isHumanMessageLike({ type: "human", content: "hello" }) // => true
+   * ```ts
+   * _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
@@ -2829,8 +2968,14 @@ var MCPAgent = class {
    * 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
+   * ```ts
+   * const message = new ToolMessage({
+   *   content: "result",
+   *   tool_call_id: "123",
+   * });
+   * _isToolMessageLike(message); // true
+   * _isToolMessageLike({ type: "tool", content: "result" }); // true
+   * ```
    *
    * @param message - The message object to check
    * @returns true if the message represents a tool message
@@ -2861,12 +3006,14 @@ var MCPAgent = class {
    * Extract content from a message, handling both AIMessage instances and plain objects.
    *
    * @example
-   * // From AIMessage instance
-   * _getMessageContent(new AIMessage("hello")) // => "hello"
+   * ```ts
+   * _getMessageContent(new AIMessage("hello")); // "hello"
+   * ```
    *
    * @example
-   * // From plain object
-   * _getMessageContent({ type: "ai", content: "hello" }) // => "hello"
+   * ```ts
+   * _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
@@ -3209,6 +3356,9 @@ var MCPAgent = class {
     logger11.debug("Flushing observability traces...");
     await this.observabilityManager.flush();
   }
+  /**
+   * Flushes observability, closes owned MCP resources, and resets the executor.
+   */
   async close() {
     if (this.isRemote && this.remoteAgent) {
       await this.remoteAgent.close();
@@ -3686,6 +3836,7 @@ ${formatPrompt}`
 // src/agents/prompts/index.ts
 var CODE_MODE_PROMPT = "Use code execution mode to discover and call MCP tools programmatically.";
 var PROMPTS = {
+  /** Instruction used to enable code-based MCP tool discovery and calls. */
   CODE_MODE: CODE_MODE_PROMPT
 };