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

package/dist/agents/utils/llm_provider.d.ts

@@ -1,53 +1,61 @@
 import type { LanguageModel } from "../types.js";
-/**
- * Configuration for LLM instances
- */
+/** Constructor settings forwarded to a dynamically loaded LangChain model. */
 export interface LLMConfig {
+    /** Provider API key. When omitted, the provider environment variable is used. */
     apiKey?: string;
+    /** Sampling temperature. */
     temperature?: number;
+    /** Maximum number of output tokens. */
     maxTokens?: number;
+    /** Nucleus sampling probability. */
     topP?: number;
+    /** Additional provider-specific constructor settings. */
     [key: string]: any;
 }
-/**
- * Supported LLM providers
- */
+/** LangChain providers supported by {@link createLLMFromString}. */
 export type LLMProvider = "openai" | "anthropic" | "google" | "groq";
-/**
- * Parse LLM string format: "provider/model"
- * Examples:
- *   - "openai/gpt-4" -> { provider: "openai", model: "gpt-4" }
- *   - "anthropic/claude-sonnet-4-6" -> { provider: "anthropic", model: "claude-sonnet-4-6" }
- *   - "google/gemini-pro" -> { provider: "google", model: "gemini-pro" }
- */
-export declare function parseLLMString(llmString: string): {
+/** Parsed components of a LangChain model identifier. */
+export interface ParsedLLMString {
+    /** Normalized provider name. */
     provider: LLMProvider;
+    /** Provider-specific model name. */
     model: string;
-};
+}
 /**
- * Dynamically import and instantiate an LLM from a string specification
+ * Parses an LLM identifier in `"provider/model"` format.
+ *
+ * @param llmString - Provider and model separated by one slash.
+ * @returns The normalized provider and model.
+ * @throws Error if the format is invalid or the provider is unsupported.
+ */
+export declare function parseLLMString(llmString: string): ParsedLLMString;
+/**
+ * Dynamically imports and instantiates a LangChain chat model.
  *
  * @param llmString - LLM specification in format "provider/model" (e.g., "openai/gpt-4")
  * @param config - Optional configuration for the LLM (apiKey, temperature, etc.)
- * @returns Promise<LanguageModel> - Instantiated LLM instance
+ * @returns The instantiated LangChain model.
+ * @throws Error if credentials are unavailable, the provider package is not
+ * installed, or the model cannot be constructed.
  *
  * @example
- * ```typescript
+ * ```ts
  * const llm = await createLLMFromString('openai/gpt-4', { temperature: 0.7 });
  * ```
  *
  * @example
- * ```typescript
+ * ```ts
  * const llm = await createLLMFromString('anthropic/claude-sonnet-4-6');
  * ```
  */
 export declare function createLLMFromString(llmString: string, config?: LLMConfig): Promise<LanguageModel>;
 /**
- * Validate that an LLM string is in the correct format
+ * Tests whether an LLM identifier has a supported provider and valid format.
+ *
+ * @param llmString - Candidate `"provider/model"` identifier.
+ * @returns `true` when {@link parseLLMString} accepts the identifier.
  */
 export declare function isValidLLMString(llmString: string): boolean;
-/**
- * Get list of supported providers
- */
+/** @returns A new array containing every supported LangChain provider. */
 export declare function getSupportedProviders(): LLMProvider[];
 //# sourceMappingURL=llm_provider.d.ts.map

package/dist/agents/utils/llm_provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"llm_provider.d.ts","sourceRoot":"","sources":["../../../src/agents/utils/llm_provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGjD;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,MAAM,CAAC;AAgCrE;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG;IACjD,QAAQ,EAAE,WAAW,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;CACf,CA4BA;AAyCD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,SAAS,GACjB,OAAO,CAAC,aAAa,CAAC,CA8ExB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAO3D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,WAAW,EAAE,CAErD"}
+{"version":3,"file":"llm_provider.d.ts","sourceRoot":"","sources":["../../../src/agents/utils/llm_provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGjD,8EAA8E;AAC9E,MAAM,WAAW,SAAS;IACxB,iFAAiF;IACjF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4BAA4B;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,oEAAoE;AACpE,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,MAAM,CAAC;AAErE,yDAAyD;AACzD,MAAM,WAAW,eAAe;IAC9B,gCAAgC;IAChC,QAAQ,EAAE,WAAW,CAAC;IACtB,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;CACf;AAgCD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,CA4BjE;AAyCD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,SAAS,GACjB,OAAO,CAAC,aAAa,CAAC,CA8ExB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAO3D;AAED,0EAA0E;AAC1E,wBAAgB,qBAAqB,IAAI,WAAW,EAAE,CAErD"}

package/dist/index.d.ts

@@ -1,14 +1,19 @@
 /**
- * @mcp-use/agent — Native cross-platform MCP agent.
+ * `@mcp-use/agent` — Native cross-platform MCP agent.
  *
- * Inspector → MCPAgent → loop → raw fetch + @mcp-use/client.
- * LangChain integration lives in @mcp-use/agent/langchain.
+ * Inspector → MCPAgent → loop → raw fetch + `@mcp-use/client`.
+ * LangChain integration lives in `@mcp-use/agent/langchain`.
  */
 export { MCPAgent, convertMessagesToProvider, parseLLMStringToProviderConfig, providerConfigFromOptions, type MCPAgentOptions, type McpConnectionLike, type McpServersInput, type RunOptions, type AgentStep, type ProviderName, type ProviderConfig, type ProviderMessage, type LlmStreamEvent, type TokenUsage, type LLMConfig, } from "./agents/mcp_agent.js";
+export type { BaseMessage, MCPServerConfig } from "./agents/types.js";
+export type { AgentAction } from "./agents/mcp_agent.js";
+export type { NativeLLMConfig } from "./llm/provider_config.js";
+export type { ContentPart, ImageContentPart, LlmDoneEvent, LlmErrorEvent, LlmTextDeltaEvent, LlmToolCallArgsDeltaEvent, LlmToolCallReadyEvent, LlmToolCallStartEvent, LlmToolResultEvent, LlmUsageEvent, ProviderTool, ProviderToolCall, TextContentPart, } from "./llm/types.js";
 export { LlmRequestError } from "./llm/providers/openai-chat-completions.js";
 export { completeChat, completeChat as chat } from "./llm/chat.js";
+export type { InspectorAttachment, InspectorMessageLike, InspectorMessagePart, } from "./llm/messageFormat.js";
 export { buildOllamaApiUrl, DEFAULT_OLLAMA_BASE_URL, normalizeOllamaBaseUrl, OllamaCorsError, } from "./llm/providers/ollama/utils.js";
-export { RemoteAgent } from "./agents/remote.js";
+export { RemoteAgent, type RemoteAgentOptions } from "./agents/remote.js";
 export { PROMPTS } from "./agents/prompts/index.js";
-export { BaseAdapter, NativeAdapter } from "./adapters/index.js";
+export { BaseAdapter, NativeAdapter, type NativeCallToolFn, type NativeToolEntry, } from "./adapters/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,QAAQ,EACR,yBAAyB,EACzB,8BAA8B,EAC9B,yBAAyB,EACzB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,SAAS,GACf,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAE,MAAM,4CAA4C,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAE,YAAY,IAAI,IAAI,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,sBAAsB,EACtB,eAAe,GAChB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,QAAQ,EACR,yBAAyB,EACzB,8BAA8B,EAC9B,yBAAyB,EACzB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,SAAS,GACf,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACtE,YAAY,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAChE,YAAY,EACV,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,yBAAyB,EACzB,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,EAClB,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,eAAe,GAChB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,4CAA4C,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAE,YAAY,IAAI,IAAI,EAAE,MAAM,eAAe,CAAC;AACnE,YAAY,EACV,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,sBAAsB,EACtB,eAAe,GAChB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACpD,OAAO,EACL,WAAW,EACX,aAAa,EACb,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACrB,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -16,6 +16,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 ?? [];
   }
@@ -25,9 +28,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);
@@ -44,8 +47,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)) {
@@ -73,8 +76,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 = [];
@@ -88,8 +91,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 = [];
@@ -119,8 +122,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 = [];
@@ -150,8 +153,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 = [];
@@ -165,8 +168,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 = [];
@@ -180,8 +183,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);
@@ -189,8 +192,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)) {
@@ -214,14 +217,29 @@ function sanitizeToolName(name) {
 var NativeAdapter = class extends BaseAdapter {
   usedToolNames = /* @__PURE__ */ new Set();
   handlers = /* @__PURE__ */ new Map();
+  /**
+   * @param disallowedTools - MCP tool names to omit during conversion.
+   */
   constructor(disallowedTools = []) {
     super(disallowedTools);
   }
+  /**
+   * Converts MCP tools from all connectors and resets the dispatch table.
+   *
+   * @param connectors - Connected MCP connectors.
+   * @returns Provider-neutral tool entries.
+   */
   async createToolsFromConnectors(connectors) {
     this.usedToolNames.clear();
     this.handlers.clear();
     return super.createToolsFromConnectors(connectors);
   }
+  /**
+   * Creates a dispatcher for the entries loaded by this adapter.
+   *
+   * @returns A function that invokes tools, reads resources, or gets prompts.
+   * @throws Error if the requested exposed tool name is unknown.
+   */
   createCallTool() {
     const handlers = this.handlers;
     return async (name, args) => {
@@ -244,6 +262,12 @@ var NativeAdapter = class extends BaseAdapter {
       }
     };
   }
+  /**
+   * Removes internal dispatch metadata from native tool entries.
+   *
+   * @param entries - Entries created by this adapter.
+   * @returns Provider-neutral definitions safe to send to an LLM provider.
+   */
   toProviderTools(entries) {
     return entries.map(({ name, description, inputSchema }) => ({
       name,
@@ -1349,6 +1373,9 @@ function buildOllamaApiUrl(baseUrl, path) {
   return `${normalizeOllamaBaseUrl(baseUrl)}${path}`;
 }
 var OllamaCorsError = class extends Error {
+  /**
+   * @param cause - Original network error.
+   */
   constructor(cause) {
     super(
       "Could not reach Ollama. If it's running, allow this origin by starting Ollama with `OLLAMA_ORIGINS=*` (or your inspector origin) and try again."
@@ -1554,8 +1581,15 @@ async function chat3(params) {
 
 // src/llm/providers/openai-chat-completions.ts
 var LlmRequestError = class extends Error {
+  /** HTTP response status. */
   status;
+  /** Parsed JSON response body, or the raw response text. */
   body;
+  /**
+   * @param status - HTTP response status.
+   * @param message - Error message.
+   * @param body - Parsed or raw provider response body.
+   */
   constructor(status, message, body) {
     super(message);
     this.name = "LlmRequestError";
@@ -2637,7 +2671,7 @@ function providerConfigFromOptions(provider, model, config) {
 }
 
 // src/version.ts
-var VERSION = "2.0.0-beta.17";
+var VERSION = "2.0.0-beta.19";
 function getPackageVersion() {
   return VERSION;
 }
@@ -2699,6 +2733,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";
@@ -2924,6 +2963,7 @@ Raw error: ${result}`
     );
     return result;
   }
+  /** Releases local remote-agent state. */
   async close() {
     logger4.debug("\u{1F50C} Remote agent client closed");
   }
@@ -2931,6 +2971,7 @@ Raw error: ${result}`
 
 // src/agents/mcp_agent.ts
 var MCPAgent = class {
+  /** @returns The installed `@mcp-use/agent` package version. */
   static getPackageVersion() {
     return getPackageVersion();
   }
@@ -2958,6 +2999,15 @@ var MCPAgent = class {
   conversationMessages = [];
   memoryEnabled;
   boundConnections;
+  /**
+   * Creates an MCP agent.
+   *
+   * Call {@link initialize} before the first local run unless
+   * `autoInitialize` is enabled. Setting `agentId` creates a remote agent.
+   *
+   * @param options - Model, MCP connection, and execution settings.
+   * @throws Error if local execution has no MCP servers, client, or connectors.
+   */
   constructor(options) {
     if (options.agentId) {
       this.isRemote = true;
@@ -2977,7 +3027,6 @@ var MCPAgent = class {
       return;
     }
     this.maxSteps = options.maxSteps ?? 10;
-    this.autoInitialize = options.autoInitialize ?? false;
     this.systemPrompt = options.systemPrompt ?? "You are a helpful assistant with access to MCP tools.";
     this.disallowedTools = options.disallowedTools ?? [];
     this.exposeResourcesAsTools = options.exposeResourcesAsTools ?? true;
@@ -3017,6 +3066,7 @@ var MCPAgent = class {
         parseLLMStringToProviderConfig(this.llmString, this.llmConfig)
       );
     }
+    this.autoInitialize = options.autoInitialize ?? this.isSimplifiedMode;
   }
   resolveMcpServers(mcpServers) {
     if (!mcpServers) return;
@@ -3029,6 +3079,14 @@ var MCPAgent = class {
   hasLiveConnections() {
     return (this.boundConnections?.length ?? 0) > 0;
   }
+  /**
+   * Resolves the model configuration, connects MCP servers, and loads tools.
+   *
+   * Calling this method more than once has no effect until {@link close}.
+   *
+   * @throws Error if the model configuration is incomplete or no driver can
+   * be created.
+   */
   async initialize() {
     if (this.isRemote) {
       this.initialized = true;
@@ -3168,12 +3226,21 @@ var MCPAgent = class {
     }
     return messages;
   }
+  /**
+   * @returns A shallow copy of stored provider-neutral conversation history.
+   */
   getConversationHistory() {
     return [...this.conversationMessages];
   }
+  /** Removes all stored user and assistant messages. */
   clearConversationHistory() {
     this.conversationMessages = [];
   }
+  /**
+   * Replaces the system instruction used by subsequent runs.
+   *
+   * @param message - New system instruction.
+   */
   setSystemMessage(message) {
     this.systemPrompt = message;
   }
@@ -3285,7 +3352,13 @@ var MCPAgent = class {
     await this.ensureReady(options.manageConnector ?? true);
     yield* streamNativeAgent(this.driver, this.nativeRunParams(options));
   }
-  /** Single-shot completion without tools (sampling, props generation). */
+  /**
+   * Runs a single model completion without MCP tools.
+   *
+   * @param options - Provider-neutral messages and optional cancellation
+   * signal.
+   * @returns Final assistant text.
+   */
   async chat(options) {
     await this.ensureReady();
     const result = await this.driver.complete({
@@ -3295,6 +3368,11 @@ var MCPAgent = class {
     });
     return result.text;
   }
+  /**
+   * Closes MCP sessions created by this agent and resets initialization state.
+   *
+   * Existing clients supplied by the caller remain open.
+   */
   async close() {
     if (this.clientOwnedByAgent && this.client) {
       await this.client.closeAllSessions?.();
@@ -3317,6 +3395,7 @@ async function completeChat(params) {
 // 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
 };
 export {