mcp-use 1.11.0-canary.3 → 1.11.0-canary.5

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

@@ -2,4 +2,6 @@ export { PROMPTS } from "../client/prompts.js";
 export { BaseAgent } from "./base.js";
 export { MCPAgent } from "./mcp_agent.js";
 export { RemoteAgent } from "./remote.js";
+export type { BaseMessage, ExplicitModeOptions, LanguageModel, MCPAgentOptions, MCPServerConfig, SimplifiedModeOptions, } from "./types.js";
+export type { LLMConfig, LLMProvider } from "./utils/llm_provider.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agents/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agents/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,YAAY,EACV,WAAW,EACX,mBAAmB,EACnB,aAAa,EACb,eAAe,EACf,eAAe,EACf,qBAAqB,GACtB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/src/agents/index.js

@@ -4,13 +4,15 @@ import {
 import {
   MCPAgent,
   RemoteAgent
-} from "../../chunk-KZL3RCT6.js";
+} from "../../chunk-ZP4QTLQC.js";
 import "../../chunk-JRGQRPTN.js";
 import {
   PROMPTS
-} from "../../chunk-DKLRVWPJ.js";
-import "../../chunk-YIZWQ5PM.js";
-import "../../chunk-TZ7SHSRY.js";
+} from "../../chunk-6RVQ5RGR.js";
+import "../../chunk-WK34REFK.js";
+import "../../chunk-454ZT2R7.js";
+import "../../chunk-JRFJXT2T.js";
+import "../../chunk-FONZ4CWK.js";
 import "../../chunk-FRUZDWXH.js";
 import "../../chunk-3GQAWCBQ.js";
 export {

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

@@ -1,21 +1,10 @@
-import type { BaseCallbackHandler } from "@langchain/core/callbacks/base";
-import type { BaseLanguageModelInterface, LanguageModelLike } from "@langchain/core/language_models/base";
-import type { StructuredToolInterface } from "@langchain/core/tools";
 import type { StreamEvent } from "@langchain/core/tracers/log_stream";
 import { SystemMessage } from "langchain";
 import type { ZodSchema } from "zod";
-import { LangChainAdapter } from "../adapters/langchain_adapter.js";
-import type { MCPClient } from "../client.js";
-import type { BaseConnector } from "../connectors/base.js";
-import { ServerManager } from "../managers/server_manager.js";
 import { ObservabilityManager } from "../observability/index.js";
-import type { BaseMessage } from "./types.js";
-/**
- * Language model type that accepts any LangChain chat model.
- * createAgent accepts a LanguageModelLike but ChatOpenAI, ChatAnthropic, etc. are still of type BaseLanguageModelInterface.
- * Any is used to avoid TypeScript structural typing issues with protected properties until langchain fixes the issue.
- */
-export type LanguageModel = LanguageModelLike | BaseLanguageModelInterface | any;
+import type { BaseMessage, MCPAgentOptions } from "./types.js";
+export type { LanguageModel, BaseMessage, MCPAgentOptions, MCPServerConfig, } from "./types.js";
+export type { LLMConfig } from "./utils/llm_provider.js";
 /**
  * Represents a single step in the agent's execution
  */
@@ -27,6 +16,16 @@ export interface AgentStep {
     };
     observation: string;
 }
+/**
+ * Options for agent run, stream, and streamEvents methods
+ */
+export interface RunOptions<T = string> {
+    prompt: string;
+    maxSteps?: number;
+    manageConnector?: boolean;
+    externalHistory?: BaseMessage[];
+    schema?: ZodSchema<T>;
+}
 export declare class MCPAgent {
     /**
      * Get the mcp-use package version.
@@ -65,29 +64,12 @@ export declare class MCPAgent {
     private tags;
     private isRemote;
     private remoteAgent;
-    constructor(options: {
-        llm?: LanguageModel;
-        client?: MCPClient;
-        connectors?: BaseConnector[];
-        maxSteps?: number;
-        autoInitialize?: boolean;
-        memoryEnabled?: boolean;
-        systemPrompt?: string | null;
-        systemPromptTemplate?: string | null;
-        additionalInstructions?: string | null;
-        disallowedTools?: string[];
-        additionalTools?: StructuredToolInterface[];
-        toolsUsedNames?: string[];
-        useServerManager?: boolean;
-        verbose?: boolean;
-        observe?: boolean;
-        adapter?: LangChainAdapter;
-        serverManagerFactory?: (client: MCPClient) => ServerManager;
-        callbacks?: BaseCallbackHandler[];
-        agentId?: string;
-        apiKey?: string;
-        baseUrl?: string;
-    });
+    private isSimplifiedMode;
+    private llmString?;
+    private llmConfig?;
+    private mcpServersConfig?;
+    private clientOwnedByAgent;
+    constructor(options: MCPAgentOptions);
     initialize(): Promise<void>;
     private createSystemMessageFromTools;
     private createAgent;
@@ -224,14 +206,36 @@ export declare class MCPAgent {
      */
     private _getMessageContent;
     private _consumeAndReturn;
+    /**
+     * Runs the agent with options object and returns a promise for the final result.
+     */
+    run(options: RunOptions): Promise<string>;
+    /**
+     * Runs the agent with options object and structured output, returns a promise for the typed result.
+     */
+    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, ... })
      */
     run(query: string, maxSteps?: number, manageConnector?: boolean, externalHistory?: BaseMessage[]): 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, ... })
      */
     run<T>(query: string, maxSteps?: number, manageConnector?: boolean, externalHistory?: BaseMessage[], outputSchema?: ZodSchema<T>): Promise<T>;
+    /**
+     * Streams the agent execution with options object and returns string result.
+     */
+    stream(options: RunOptions): AsyncGenerator<AgentStep, string, void>;
+    /**
+     * Streams the agent execution with options object and structured output.
+     */
+    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, ... })
+     */
     stream<T = string>(query: string, maxSteps?: number, manageConnector?: boolean, externalHistory?: BaseMessage[], outputSchema?: ZodSchema<T>): AsyncGenerator<AgentStep, string | T, void>;
     /**
      * Flush observability traces to the configured observability platform.
@@ -239,14 +243,32 @@ export declare class MCPAgent {
      */
     flush(): Promise<void>;
     close(): Promise<void>;
+    /**
+     * Yields with pretty-printed output for code mode with options object.
+     */
+    prettyStreamEvents(options: RunOptions): AsyncGenerator<void, string, void>;
+    /**
+     * Yields with pretty-printed output for code mode with options object and structured output.
+     */
+    prettyStreamEvents<T>(options: RunOptions<T>): AsyncGenerator<void, string, void>;
     /**
      * Yields with pretty-printed output for code mode.
      * This method formats and displays tool executions in a user-friendly way with syntax highlighting.
+     * @deprecated Use options object instead: prettyStreamEvents({ prompt, maxSteps, ... })
      */
     prettyStreamEvents<T = string>(query: string, maxSteps?: number, manageConnector?: boolean, externalHistory?: BaseMessage[], outputSchema?: ZodSchema<T>): AsyncGenerator<void, string, void>;
+    /**
+     * Yields LangChain StreamEvent objects with options object.
+     */
+    streamEvents(options: RunOptions): AsyncGenerator<StreamEvent, void, void>;
+    /**
+     * Yields LangChain StreamEvent objects with options object and structured output.
+     */
+    streamEvents<T>(options: RunOptions<T>): AsyncGenerator<StreamEvent, void, void>;
     /**
      * 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, ... })
      */
     streamEvents<T = string>(query: string, maxSteps?: number, manageConnector?: boolean, externalHistory?: BaseMessage[], outputSchema?: ZodSchema<T>): AsyncGenerator<StreamEvent, void, void>;
     /**

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

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

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

@@ -2,6 +2,7 @@
  * Remote agent implementation for executing agents via API.
  */
 import type { ZodSchema } from "zod";
+import type { RunOptions } from "./mcp_agent.js";
 import type { BaseMessage } from "./types.js";
 export declare class RemoteAgent {
     private agentId;
@@ -16,7 +17,31 @@ export declare class RemoteAgent {
     private pydanticToJsonSchema;
     private parseStructuredResponse;
     private createChatSession;
+    /**
+     * Runs the remote agent with options object and returns a promise for the final result.
+     */
+    run(options: RunOptions): Promise<string>;
+    /**
+     * Runs the remote agent with options object and structured output.
+     */
+    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, ... })
+     */
     run<T = string>(query: string, maxSteps?: number, manageConnector?: boolean, externalHistory?: BaseMessage[], outputSchema?: ZodSchema<T>): Promise<T>;
+    /**
+     * Streams the remote agent execution with options object.
+     */
+    stream(options: RunOptions): AsyncGenerator<any, string, void>;
+    /**
+     * Streams the remote agent execution with options object and structured output.
+     */
+    stream<T>(options: RunOptions<T>): AsyncGenerator<any, T, void>;
+    /**
+     * Streams the remote agent execution.
+     * @deprecated Use options object instead: stream({ prompt, maxSteps, ... })
+     */
     stream<T = string>(query: string, maxSteps?: number, manageConnector?: boolean, externalHistory?: BaseMessage[], outputSchema?: ZodSchema<T>): AsyncGenerator<any, T, void>;
     close(): Promise<void>;
 }

package/dist/src/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,WAAW,EAAE,MAAM,YAAY,CAAC;AAM9C,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAuB;gBAEzB,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE;IAgB3E,OAAO,CAAC,oBAAoB;IAO5B,OAAO,CAAC,uBAAuB;YAqDjB,iBAAiB;IAoDlB,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;IAsJC,MAAM,CAAC,CAAC,GAAG,MAAM,EAC7B,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;IAelB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAUpC"}
+{"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,gBAAgB,CAAC;AACjD,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;gBAEzB,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE;IAgB3E,OAAO,CAAC,oBAAoB;IAO5B,OAAO,CAAC,uBAAuB;YAqDjB,iBAAiB;IAoD/B;;OAEG;IACU,GAAG,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAEtD;;OAEG;IACU,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAEvD;;;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;IA0Kb;;OAEG;IACI,MAAM,CAAC,OAAO,EAAE,UAAU,GAAG,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC;IAErE;;OAEG;IACI,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,GAAG,EAAE,CAAC,EAAE,IAAI,CAAC;IAEtE;;;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;IAwBlB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAUpC"}

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

@@ -1,3 +1,79 @@
+import type { BaseCallbackHandler } from "@langchain/core/callbacks/base";
+import type { StructuredToolInterface } from "@langchain/core/tools";
 import type { AIMessage, HumanMessage, ToolMessage, SystemMessage } from "langchain";
+import type { LangChainAdapter } from "../adapters/langchain_adapter.js";
+import type { MCPClient } from "../client.js";
+import type { BaseConnector } from "../connectors/base.js";
+import type { ServerManager } from "../managers/server_manager.js";
+import type { LLMConfig } from "./utils/llm_provider.js";
 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.
+ */
+export type LanguageModel = any;
+/**
+ * Configuration for MCP servers in simplified mode
+ */
+export interface MCPServerConfig {
+    command?: string;
+    args?: string[];
+    env?: Record<string, string>;
+    url?: string;
+    headers?: Record<string, string>;
+    auth_token?: string;
+    authToken?: string;
+    transport?: "http" | "sse";
+    preferSse?: boolean;
+}
+/**
+ * Common options shared between both explicit and simplified modes
+ */
+interface CommonAgentOptions {
+    maxSteps?: number;
+    autoInitialize?: boolean;
+    memoryEnabled?: boolean;
+    systemPrompt?: string | null;
+    systemPromptTemplate?: string | null;
+    additionalInstructions?: string | null;
+    disallowedTools?: string[];
+    additionalTools?: StructuredToolInterface[];
+    toolsUsedNames?: string[];
+    useServerManager?: boolean;
+    verbose?: boolean;
+    observe?: boolean;
+    adapter?: LangChainAdapter;
+    serverManagerFactory?: (client: MCPClient) => ServerManager;
+    callbacks?: BaseCallbackHandler[];
+    agentId?: string;
+    apiKey?: string;
+    baseUrl?: string;
+}
+/**
+ * Explicit mode: User provides pre-instantiated LLM and client/connectors
+ * This is the traditional initialization pattern with full control
+ */
+export interface ExplicitModeOptions extends CommonAgentOptions {
+    llm: LanguageModel;
+    client?: MCPClient;
+    connectors?: BaseConnector[];
+    mcpServers?: never;
+    llmConfig?: never;
+}
+/**
+ * Simplified mode: User provides LLM string and mcpServers config
+ * The agent handles client creation and LLM instantiation internally
+ */
+export interface SimplifiedModeOptions extends CommonAgentOptions {
+    llm: string;
+    llmConfig?: LLMConfig;
+    mcpServers: Record<string, MCPServerConfig>;
+    client?: never;
+    connectors?: never;
+}
+/**
+ * MCPAgent constructor options - supports both explicit and simplified modes
+ */
+export type MCPAgentOptions = ExplicitModeOptions | SimplifiedModeOptions;
+export {};
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/agents/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,YAAY,EACZ,WAAW,EACX,aAAa,EACd,MAAM,WAAW,CAAC;AAEnB,MAAM,MAAM,WAAW,GACnB,SAAS,GACT,YAAY,GACZ,WAAW,GACX,aAAa,CAAC"}
+{"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,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,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;IACnB,SAAS,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAC3B,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;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,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"}

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

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

package/dist/src/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"}
+{"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"}

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

@@ -0,0 +1,53 @@
+import type { LanguageModel } from "../types.js";
+/**
+ * Configuration for LLM instances
+ */
+export interface LLMConfig {
+    apiKey?: string;
+    temperature?: number;
+    maxTokens?: number;
+    topP?: number;
+    [key: string]: any;
+}
+/**
+ * Supported LLM providers
+ */
+export type LLMProvider = "openai" | "anthropic" | "google" | "groq";
+/**
+ * Parse LLM string format: "provider/model"
+ * Examples:
+ *   - "openai/gpt-4" -> { provider: "openai", model: "gpt-4" }
+ *   - "anthropic/claude-3-5-sonnet-20241022" -> { provider: "anthropic", model: "claude-3-5-sonnet-20241022" }
+ *   - "google/gemini-pro" -> { provider: "google", model: "gemini-pro" }
+ */
+export declare function parseLLMString(llmString: string): {
+    provider: LLMProvider;
+    model: string;
+};
+/**
+ * Dynamically import and instantiate an LLM from a string specification
+ *
+ * @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
+ *
+ * @example
+ * ```typescript
+ * const llm = await createLLMFromString('openai/gpt-4', { temperature: 0.7 });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * const llm = await createLLMFromString('anthropic/claude-3-5-sonnet-20241022');
+ * ```
+ */
+export declare function createLLMFromString(llmString: string, config?: LLMConfig): Promise<LanguageModel>;
+/**
+ * Validate that an LLM string is in the correct format
+ */
+export declare function isValidLLMString(llmString: string): boolean;
+/**
+ * Get list of supported providers
+ */
+export declare function getSupportedProviders(): LLMProvider[];
+//# sourceMappingURL=llm_provider.d.ts.map

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

@@ -0,0 +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;AAgCD;;;;;;;;;;;;;;;;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"}