@mcp-use/agent 2.0.0-beta.2 → 2.0.0-beta.20

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"}

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"}