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

package/dist/agents/mcp_agent_langchain.d.ts

@@ -3,19 +3,25 @@ import { SystemMessage } from "langchain";
 import type { ZodSchema } from "zod";
 import { ObservabilityManager } from "../observability/index.js";
 import type { BaseMessage, MCPAgentOptions } from "./types.js";
-/**
- * Represents a single step in the agent's execution
- */
-interface AgentStep {
-    action: {
-        tool: string;
-        toolInput: any;
-        log: string;
-    };
+/** Tool invocation details yielded by the LangChain agent. */
+export interface LangChainAgentAction {
+    /** Tool name. */
+    tool: string;
+    /** Arguments generated by the model. */
+    toolInput: any;
+    /** LangChain action log. */
+    log: string;
+}
+/** A completed tool invocation yielded during LangChain agent execution. */
+export interface AgentStep {
+    /** Tool invocation requested by the model. */
+    action: LangChainAgentAction;
+    /** Serialized result returned by the tool. */
     observation: string;
 }
 import type { RunOptions } from "./run_options.js";
 export type { RunOptions };
+/** Runs a LangChain tool-calling agent against MCP servers. */
 export declare class MCPAgent {
     /**
      * Get the mcp-use package version.
@@ -30,6 +36,7 @@ export declare class MCPAgent {
     private memoryEnabled;
     private disallowedTools;
     private additionalTools;
+    /** Names of tools invoked during the current or most recent execution. */
     toolsUsedNames: string[];
     private exposeResourcesAsTools;
     private exposePromptsAsTools;
@@ -50,6 +57,7 @@ export declare class MCPAgent {
     private telemetry;
     private modelProvider;
     private modelName;
+    /** Observability callbacks and trace lifecycle manager. */
     observabilityManager: ObservabilityManager;
     private callbacks;
     private metadata;
@@ -61,16 +69,43 @@ export declare class MCPAgent {
     private llmConfig?;
     private mcpServersConfig?;
     private clientOwnedByAgent;
+    /**
+     * 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: MCPAgentOptions);
+    /**
+     * 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.
+     */
     initialize(): Promise<void>;
     private createSystemMessageFromTools;
     private createAgent;
+    /** @returns A shallow copy of the stored LangChain message history. */
     getConversationHistory(): BaseMessage[];
+    /** Clears stored history, retaining the system message when memory is enabled. */
     clearConversationHistory(): void;
     private addToHistory;
+    /** @returns The current LangChain system message, or `null` before creation. */
     getSystemMessage(): SystemMessage | null;
+    /**
+     * Replaces the system instruction and rebuilds an initialized executor.
+     *
+     * @param message - New system instruction.
+     */
     setSystemMessage(message: string): void;
+    /**
+     * Replaces the tool denylist for the next initialization.
+     *
+     * @param disallowedTools - MCP tool names to omit.
+     */
     setDisallowedTools(disallowedTools: string[]): void;
+    /** @returns The configured MCP tool denylist. */
     getDisallowedTools(): string[];
     /**
      * Set metadata for observability traces
@@ -118,20 +153,28 @@ export declare class MCPAgent {
      * 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
@@ -142,17 +185,26 @@ export declare class MCPAgent {
      * 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
@@ -163,8 +215,10 @@ export declare class MCPAgent {
      * 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
@@ -175,8 +229,14 @@ export declare class MCPAgent {
      * 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
@@ -186,12 +246,14 @@ export declare class MCPAgent {
      * 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
@@ -208,12 +270,12 @@ export declare class MCPAgent {
     run<T>(options: RunOptions<T>): Promise<T>;
     /**
      * Runs the agent and returns a promise for the final result.
-     * @deprecated Use options object instead: run({ prompt, maxSteps, ... })
+     * @deprecated Use the options object instead: `run({ prompt, maxSteps, ... })`.
      */
     run(query: string, maxSteps?: number, manageConnector?: boolean, externalHistory?: BaseMessage[], outputSchema?: undefined, signal?: AbortSignal): Promise<string>;
     /**
      * Runs the agent with structured output and returns a promise for the typed result.
-     * @deprecated Use options object instead: run({ prompt, schema, maxSteps, ... })
+     * @deprecated Use the options object instead: `run({ prompt, schema, maxSteps, ... })`.
      */
     run<T>(query: string, maxSteps?: number, manageConnector?: boolean, externalHistory?: BaseMessage[], outputSchema?: ZodSchema<T>, signal?: AbortSignal): Promise<T>;
     /**
@@ -226,7 +288,7 @@ export declare class MCPAgent {
     stream<T>(options: RunOptions<T>): AsyncGenerator<AgentStep, T, void>;
     /**
      * Streams the agent execution and yields agent steps.
-     * @deprecated Use options object instead: stream({ prompt, maxSteps, ... })
+     * @deprecated Use the options object instead: `stream({ prompt, maxSteps, ... })`.
      */
     stream<T = string>(query: string, maxSteps?: number, manageConnector?: boolean, externalHistory?: BaseMessage[], outputSchema?: ZodSchema<T>, signal?: AbortSignal): AsyncGenerator<AgentStep, string | T, void>;
     /**
@@ -234,6 +296,9 @@ export declare class MCPAgent {
      * Important for serverless environments where traces need to be sent before function termination.
      */
     flush(): Promise<void>;
+    /**
+     * Flushes observability, closes owned MCP resources, and resets the executor.
+     */
     close(): Promise<void>;
     /**
      * Yields with pretty-printed output for code mode with options object.
@@ -246,7 +311,7 @@ export declare class MCPAgent {
     /**
      * Yields with pretty-printed output for code mode.
      * This method formats and displays tool executions in a user-friendly way for the terminal.
-     * @deprecated Use options object instead: prettyStreamEvents({ prompt, maxSteps, ... })
+     * @deprecated Use the options object instead: `prettyStreamEvents({ prompt, maxSteps, ... })`.
      */
     prettyStreamEvents<T = string>(query: string, maxSteps?: number, manageConnector?: boolean, externalHistory?: BaseMessage[], outputSchema?: ZodSchema<T>): AsyncGenerator<void, string, void>;
     /**
@@ -260,7 +325,7 @@ export declare class MCPAgent {
     /**
      * Yields LangChain StreamEvent objects from the underlying streamEvents() method.
      * This provides token-level streaming and fine-grained event updates.
-     * @deprecated Use options object instead: streamEvents({ prompt, maxSteps, ... })
+     * @deprecated Use the options object instead: `streamEvents({ prompt, maxSteps, ... })`.
      */
     streamEvents<T = string>(query: string, maxSteps?: number, manageConnector?: boolean, externalHistory?: BaseMessage[], outputSchema?: ZodSchema<T>, signal?: AbortSignal): AsyncGenerator<StreamEvent, void, void>;
     /**

package/dist/agents/mcp_agent_langchain.d.ts.map

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

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

@@ -4,7 +4,14 @@
  * This module provides prompt templates to guide agents on how to use
  * MCP tools, including code execution mode.
  */
+/**
+ * Built-in prompt fragments for agent features.
+ *
+ * `CODE_MODE` instructs a model to discover and invoke MCP tools through the
+ * code execution interface.
+ */
 export declare const PROMPTS: {
+    /** Instruction used to enable code-based MCP tool discovery and calls. */
     readonly CODE_MODE: "Use code execution mode to discover and call MCP tools programmatically.";
 };
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agents/prompts/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,eAAO,MAAM,OAAO;aAClB,SAAS;CACD,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agents/prompts/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;;;;GAKG;AACH,eAAO,MAAM,OAAO;IAClB,0EAA0E;aAC1E,SAAS;CACD,CAAC"}

package/dist/agents/remote.d.ts

@@ -1,48 +1,73 @@
-/**
- * Remote agent implementation for executing agents via API.
- */
+/** Remote execution support for hosted MCP agents. */
 import type { ZodSchema } from "zod";
 import type { RunOptions } from "./run_options.js";
 import type { BaseMessage } from "./types.js";
+/** Configures a {@link RemoteAgent}. */
+export interface RemoteAgentOptions {
+    /** Hosted agent identifier. */
+    agentId: string;
+    /** API key. Defaults to `MCP_USE_API_KEY`. */
+    apiKey?: string;
+    /** API origin. Defaults to `https://cloud.manufact.com`. */
+    baseUrl?: string;
+}
+/** Executes a hosted MCP agent through the mcp-use remote API. */
 export declare class RemoteAgent {
     private agentId;
     private apiKey;
     private baseUrl;
     private chatId;
-    constructor(options: {
-        agentId: string;
-        apiKey?: string;
-        baseUrl?: string;
-    });
+    /**
+     * @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: RemoteAgentOptions);
     private pydanticToJsonSchema;
     private parseStructuredResponse;
     private createChatSession;
     /**
-     * Runs the remote agent with options object and returns a promise for the final result.
+     * Runs the remote agent and returns its final text.
+     *
+     * @param options - Input and per-run execution settings.
+     * @returns Final agent text.
      */
     run(options: RunOptions): Promise<string>;
     /**
-     * Runs the remote agent with options object and structured output.
+     * Runs the remote agent and parses its result with `options.schema`.
+     *
+     * @param options - Input, schema, and per-run execution settings.
+     * @returns The schema-validated result.
      */
     run<T>(options: RunOptions<T>): Promise<T>;
     /**
      * Runs the remote agent and returns a promise for the final result.
-     * @deprecated Use options object instead: run({ prompt, maxSteps, ... })
+     * @deprecated Use the options object instead: `run({ prompt, maxSteps, ... })`.
      */
     run<T = string>(query: string, maxSteps?: number, manageConnector?: boolean, externalHistory?: BaseMessage[], outputSchema?: ZodSchema<T>): Promise<T>;
     /**
-     * Streams the remote agent execution with options object.
+     * Runs the remote agent through an async-generator interface.
+     *
+     * The current remote API does not emit intermediate values. Read the
+     * generator's return value for the final result.
+     *
+     * @param options - Input and per-run execution settings.
+     * @returns An async generator whose return value is the final text.
      */
     stream(options: RunOptions): AsyncGenerator<any, string, void>;
     /**
-     * Streams the remote agent execution with options object and structured output.
+     * Runs structured remote execution through an async-generator interface.
+     *
+     * @param options - Input, schema, and per-run execution settings.
+     * @returns An async generator whose return value is schema validated.
      */
     stream<T>(options: RunOptions<T>): AsyncGenerator<any, T, void>;
     /**
      * Streams the remote agent execution.
-     * @deprecated Use options object instead: stream({ prompt, maxSteps, ... })
+     * @deprecated Use the options object instead: `stream({ prompt, maxSteps, ... })`.
      */
     stream<T = string>(query: string, maxSteps?: number, manageConnector?: boolean, externalHistory?: BaseMessage[], outputSchema?: ZodSchema<T>): AsyncGenerator<any, T, void>;
+    /** Releases local remote-agent state. */
     close(): Promise<void>;
 }
 //# sourceMappingURL=remote.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"remote.d.ts","sourceRoot":"","sources":["../../src/agents/remote.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AAGrC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AA4C9C,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAuB;IAErC,YAAY,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,EAgB1E;IAED,OAAO,CAAC,oBAAoB;IAO5B,OAAO,CAAC,uBAAuB;YAqDjB,iBAAiB;IAoD/B;;OAEG;IACU,GAAG,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEvD;;OAEG;IACU,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAExD;;;OAGG;IACU,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,CAAC;IA0Kd;;OAEG;IACI,MAAM,CAAC,OAAO,EAAE,UAAU,GAAG,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IAEtE;;OAEG;IACI,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,GAAG,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;IAEvE;;;OAGG;IACI,MAAM,CAAC,CAAC,GAAG,MAAM,EACtB,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,CAAC;IAwBnB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CASlC;CACF"}
+{"version":3,"file":"remote.d.ts","sourceRoot":"","sources":["../../src/agents/remote.ts"],"names":[],"mappings":"AAAA,sDAAsD;AAEtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AAGrC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AA4C9C,wCAAwC;AACxC,MAAM,WAAW,kBAAkB;IACjC,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,kEAAkE;AAClE,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAuB;IAErC;;;;OAIG;IACH,YAAY,OAAO,EAAE,kBAAkB,EAgBtC;IAED,OAAO,CAAC,oBAAoB;IAO5B,OAAO,CAAC,uBAAuB;YAqDjB,iBAAiB;IAoD/B;;;;;OAKG;IACU,GAAG,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEvD;;;;;OAKG;IACU,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAExD;;;OAGG;IACU,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,CAAC;IA0Kd;;;;;;;;OAQG;IACI,MAAM,CAAC,OAAO,EAAE,UAAU,GAAG,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IAEtE;;;;;OAKG;IACI,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,GAAG,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;IAEvE;;;OAGG;IACI,MAAM,CAAC,CAAC,GAAG,MAAM,EACtB,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,CAAC;IAwBhC,yCAAyC;IAC5B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CASlC;CACF"}

package/dist/agents/run_options.d.ts

@@ -1,9 +1,16 @@
 import type { ZodSchema } from "zod";
 import type { ProviderMessage } from "../llm/types.js";
 import type { BaseMessage } from "./types.js";
+/** Options shared by `run`, `stream`, and `streamEvents`. */
 export interface RunOptions<T = string> {
+    /** User request for this run. */
     prompt?: string;
+    /** Maximum model/tool-loop steps for this run. */
     maxSteps?: number;
+    /**
+     * Lets the agent initialize and clean up connectors for this run.
+     * Defaults to `true`.
+     */
     manageConnector?: boolean;
     /**
      * Additional LangChain-formatted history for this call.
@@ -13,8 +20,16 @@ export interface RunOptions<T = string> {
      * stored memory.
      */
     externalHistory?: BaseMessage[];
+    /** Provider-neutral messages appended before `prompt`. */
     messages?: ProviderMessage[];
+    /**
+     * Zod schema for a typed result.
+     *
+     * Structured output is supported by the LangChain entry point and remote
+     * agents. The native local agent rejects this option.
+     */
     schema?: ZodSchema<T>;
+    /** Cancels model requests and agent execution. */
     signal?: AbortSignal;
 }
 //# sourceMappingURL=run_options.d.ts.map

package/dist/agents/run_options.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run_options.d.ts","sourceRoot":"","sources":["../../src/agents/run_options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AACrC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,MAAM;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,WAAW,EAAE,CAAC;IAChC,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAC;IAC7B,MAAM,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IACtB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB"}
+{"version":3,"file":"run_options.d.ts","sourceRoot":"","sources":["../../src/agents/run_options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AACrC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,6DAA6D;AAC7D,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,MAAM;IACpC,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,WAAW,EAAE,CAAC;IAChC,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAC;IAC7B;;;;;OAKG;IACH,MAAM,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IACtB,kDAAkD;IAClD,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB"}

package/dist/agents/types.d.ts

@@ -6,74 +6,96 @@ import type { MCPClient } from "@mcp-use/client";
 import type { BaseConnector } from "@mcp-use/client";
 import type { ServerManager } from "../managers/server_manager.js";
 import type { LLMConfig } from "./utils/llm_provider.js";
+/** LangChain message types accepted as conversation history. */
 export type BaseMessage = AIMessage | HumanMessage | ToolMessage | SystemMessage;
-/**
- * Language model type that accepts any LangChain chat model.
- * Any is used to avoid TypeScript structural typing issues with protected properties until langchain fixes the issue.
- */
+/** A LangChain-compatible chat model accepted by the agent. */
 export type LanguageModel = any;
-/**
- * Configuration for MCP servers in simplified mode
- */
+/** MCP server transport configuration used in simplified mode. */
 export interface MCPServerConfig {
+    /** Executable for a stdio server. */
     command?: string;
+    /** Arguments passed to the stdio executable. */
     args?: string[];
+    /** Environment variables passed to the stdio process. */
     env?: Record<string, string>;
+    /** URL for a remote MCP transport. */
     url?: string;
+    /** HTTP headers sent to a remote MCP server. */
     headers?: Record<string, string>;
+    /** Legacy snake-case authentication token. */
     auth_token?: string;
+    /** Authentication token sent to a remote MCP server. */
     authToken?: string;
 }
-/**
- * Common options shared between both explicit and simplified modes
- */
-interface CommonAgentOptions {
+/** Options shared by explicit and simplified LangChain agents. */
+export interface CommonAgentOptions {
+    /** Maximum model calls per run. Defaults to `5`. */
     maxSteps?: number;
+    /** Initializes the agent on its first run. Defaults to `false`. */
     autoInitialize?: boolean;
+    /** Retains conversation history between runs. Defaults to `true`. */
     memoryEnabled?: boolean;
+    /** Complete system instruction override. */
     systemPrompt?: string | null;
+    /** Template used to build the system instruction from available tools. */
     systemPromptTemplate?: string | null;
+    /** Instructions appended to the generated system message. */
     additionalInstructions?: string | null;
+    /** MCP tool names to omit from the agent. */
     disallowedTools?: string[];
+    /** Additional LangChain tools exposed alongside MCP tools. */
     additionalTools?: StructuredToolInterface[];
+    /** Mutable array populated with tool names used during execution. */
     toolsUsedNames?: string[];
+    /** Exposes MCP resources as tools. Defaults to `true`. */
     exposeResourcesAsTools?: boolean;
+    /** Exposes MCP prompts as tools. Defaults to `true`. */
     exposePromptsAsTools?: boolean;
+    /** Enables dynamic server-selection tools. */
     useServerManager?: boolean;
+    /** Enables detailed execution logging. */
     verbose?: boolean;
+    /** Enables observability callbacks. Defaults to `true`. */
     observe?: boolean;
+    /** Adapter used to create LangChain tools. */
     adapter?: LangChainAdapter;
+    /** Factory used to customize server management. */
     serverManagerFactory?: (client: MCPClient) => ServerManager;
+    /** Custom LangChain observability callbacks. */
     callbacks?: BaseCallbackHandler[];
+    /** Hosted agent identifier for remote execution. */
     agentId?: string;
+    /** Remote API key. Defaults to `MCP_USE_API_KEY`. */
     apiKey?: string;
+    /** Remote API origin. */
     baseUrl?: string;
 }
-/**
- * Explicit mode: User provides pre-instantiated LLM and client/connectors
- * This is the traditional initialization pattern with full control
- */
+/** Options for a pre-instantiated LangChain model and MCP client/connectors. */
 export interface ExplicitModeOptions extends CommonAgentOptions {
+    /** Pre-instantiated LangChain chat model. */
     llm: LanguageModel;
+    /** Existing MCP client. */
     client?: MCPClient;
+    /** Existing MCP connectors. */
     connectors?: BaseConnector[];
+    /** Simplified server configurations are not accepted in explicit mode. */
     mcpServers?: never;
+    /** Simplified model configuration is not accepted in explicit mode. */
     llmConfig?: never;
 }
-/**
- * Simplified mode: User provides LLM string and mcpServers config
- * The agent handles client creation and LLM instantiation internally
- */
+/** Options for an agent that creates its model and MCP client from config. */
 export interface SimplifiedModeOptions extends CommonAgentOptions {
+    /** Model identifier in `"provider/model"` format. */
     llm: string;
+    /** Provider credentials and model constructor settings. */
     llmConfig?: LLMConfig;
+    /** Named MCP server transport configurations. */
     mcpServers: Record<string, MCPServerConfig>;
+    /** Existing clients are not accepted in simplified mode. */
     client?: never;
+    /** Existing connectors are not accepted in simplified mode. */
     connectors?: never;
 }
-/**
- * MCPAgent constructor options - supports both explicit and simplified modes
- */
+/** Constructor options for the LangChain MCP agent. */
 export type MCPAgentOptions = ExplicitModeOptions | SimplifiedModeOptions;
-export {};
 //# sourceMappingURL=types.d.ts.map

package/dist/agents/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agents/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAC1E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,KAAK,EACV,SAAS,EACT,YAAY,EACZ,WAAW,EACX,aAAa,EACd,MAAM,WAAW,CAAC;AACnB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEzD,MAAM,MAAM,WAAW,GACnB,SAAS,GACT,YAAY,GACZ,WAAW,GACX,aAAa,CAAC;AAElB;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,GAAG,CAAC;AAEhC;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,UAAU,kBAAkB;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,sBAAsB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,eAAe,CAAC,EAAE,uBAAuB,EAAE,CAAC;IAC5C,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,oBAAoB,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,aAAa,CAAC;IAC5D,SAAS,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAElC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAoB,SAAQ,kBAAkB;IAC7D,GAAG,EAAE,aAAa,CAAC;IACnB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,UAAU,CAAC,EAAE,aAAa,EAAE,CAAC;IAE7B,UAAU,CAAC,EAAE,KAAK,CAAC;IACnB,SAAS,CAAC,EAAE,KAAK,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAsB,SAAQ,kBAAkB;IAC/D,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAE5C,MAAM,CAAC,EAAE,KAAK,CAAC;IACf,UAAU,CAAC,EAAE,KAAK,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,mBAAmB,GAAG,qBAAqB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agents/types.ts"],"names":[],"mappings":"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"}

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

@@ -6,17 +6,26 @@
  */
 import type { StreamEvent } from "@langchain/core/tracers/log_stream";
 /**
- * Converts streamEvents to AI SDK compatible stream (basic version)
- * Only yields the actual content tokens from chat model streams
+ * Converts LangChain model stream events to text chunks.
+ *
+ * @param streamEvents - Events returned by the LangChain agent's
+ * `streamEvents` method.
+ * @returns An async generator containing only model text chunks.
  */
 export declare function streamEventsToAISDK(streamEvents: AsyncGenerator<StreamEvent, void, void>): AsyncGenerator<string, void, void>;
 /**
- * Converts async generator to ReadableStream for AI SDK compatibility
+ * Wraps an async text generator in a web `ReadableStream`.
+ *
+ * @param generator - Async text generator to consume.
+ * @returns A stream that enqueues each generated string and forwards errors.
  */
 export declare function createReadableStreamFromGenerator(generator: AsyncGenerator<string, void, void>): ReadableStream<string>;
 /**
- * Enhanced adapter that includes tool information along with chat content
- * Yields both content tokens and tool usage notifications
+ * Converts LangChain events to text and inserts tool lifecycle messages.
+ *
+ * @param streamEvents - Events returned by the LangChain agent's
+ * `streamEvents` method.
+ * @returns Model text interleaved with human-readable tool start/end messages.
  */
 export declare function streamEventsToAISDKWithTools(streamEvents: AsyncGenerator<StreamEvent, void, void>): AsyncGenerator<string, void, void>;
 //# sourceMappingURL=ai_sdk.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ai_sdk.d.ts","sourceRoot":"","sources":["../../../src/agents/utils/ai_sdk.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AAEtE;;;GAGG;AACH,wBAAuB,mBAAmB,CACxC,YAAY,EAAE,cAAc,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,CAAC,GACpD,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CASpC;AAED;;GAEG;AACH,wBAAgB,iCAAiC,CAC/C,SAAS,EAAE,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,GAC5C,cAAc,CAAC,MAAM,CAAC,CAaxB;AAED;;;GAGG;AACH,wBAAuB,4BAA4B,CACjD,YAAY,EAAE,cAAc,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,CAAC,GACpD,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAuBpC"}
+{"version":3,"file":"ai_sdk.d.ts","sourceRoot":"","sources":["../../../src/agents/utils/ai_sdk.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AAEtE;;;;;;GAMG;AACH,wBAAuB,mBAAmB,CACxC,YAAY,EAAE,cAAc,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,CAAC,GACpD,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CASpC;AAED;;;;;GAKG;AACH,wBAAgB,iCAAiC,CAC/C,SAAS,EAAE,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,GAC5C,cAAc,CAAC,MAAM,CAAC,CAaxB;AAED;;;;;;GAMG;AACH,wBAAuB,4BAA4B,CACjD,YAAY,EAAE,cAAc,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,CAAC,GACpD,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAuBpC"}

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

@@ -1,3 +1,3 @@
 export { createReadableStreamFromGenerator, streamEventsToAISDK, streamEventsToAISDKWithTools, } from "./ai_sdk.js";
-export { createLLMFromString, getSupportedProviders, isValidLLMString, parseLLMString, type LLMConfig, type LLMProvider, } from "./llm_provider.js";
+export { createLLMFromString, getSupportedProviders, isValidLLMString, parseLLMString, type LLMConfig, type LLMProvider, type ParsedLLMString, } from "./llm_provider.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agents/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iCAAiC,EACjC,mBAAmB,EACnB,4BAA4B,GAC7B,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,gBAAgB,EAChB,cAAc,EACd,KAAK,SAAS,EACd,KAAK,WAAW,GACjB,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agents/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iCAAiC,EACjC,mBAAmB,EACnB,4BAA4B,GAC7B,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,gBAAgB,EAChB,cAAc,EACd,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,eAAe,GACrB,MAAM,mBAAmB,CAAC"}