@mcp-use/agent 0.0.0-bootstrap.0 → 2.0.0-beta.0

package/dist/adapters/base.d.ts

@@ -0,0 +1,112 @@
+import type { MCPClient } from "@mcp-use/client";
+import type { BaseConnector } from "@mcp-use/client";
+/**
+ * Abstract base class for converting MCP tools to other framework formats.
+ *
+ * This class defines the common interface that all adapter implementations
+ * should follow to ensure consistency across different frameworks.
+ */
+export declare abstract class BaseAdapter<T> {
+    /**
+     * List of tool names that should not be available.
+     */
+    protected readonly disallowedTools: string[];
+    /**
+     * Internal cache that maps a connector instance to the list of tools
+     * generated for it.
+     */
+    private readonly connectorToolMap;
+    constructor(disallowedTools?: string[]);
+    /**
+     * Create tools from an MCPClient instance.
+     *
+     * 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.
+     */
+    static createTools<TTool, TAdapter extends BaseAdapter<TTool>>(this: new (disallowedTools?: string[]) => TAdapter, client: MCPClient, disallowedTools?: string[]): Promise<TTool[]>;
+    /**
+     * 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.
+     */
+    loadToolsForConnector(connector: BaseConnector): Promise<T[]>;
+    /**
+     * Convert an MCP tool to the target framework's tool format.
+     *
+     * @param mcpTool   The MCP tool definition to convert.
+     * @param connector The connector that provides this tool.
+     * @returns         The converted tool, or null / undefined if no tool should be produced.
+     */
+    protected abstract convertTool(mcpTool: Record<string, any>, connector: BaseConnector): T | null | undefined;
+    /**
+     * Convert an MCP resource to the target framework's tool format.
+     *
+     * @param mcpResource The MCP resource definition to convert.
+     * @param connector    The connector that provides this resource.
+     * @returns            The converted resource as a tool, or null / undefined if no tool should be produced.
+     */
+    protected abstract convertResource?(mcpResource: Record<string, any>, connector: BaseConnector): T | null | undefined;
+    /**
+     * Convert an MCP prompt to the target framework's tool format.
+     *
+     * @param mcpPrompt The MCP prompt definition to convert.
+     * @param connector The connector that provides this prompt.
+     * @returns         The converted prompt as a tool, or null / undefined if no tool should be produced.
+     */
+    protected abstract convertPrompt?(mcpPrompt: Record<string, any>, connector: BaseConnector): T | null | undefined;
+    /**
+     * 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.
+     */
+    createToolsFromConnectors(connectors: BaseConnector[]): Promise<T[]>;
+    /**
+     * 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.
+     */
+    loadResourcesForConnector(connector: BaseConnector): Promise<T[]>;
+    /**
+     * 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.
+     */
+    loadPromptsForConnector(connector: BaseConnector): Promise<T[]>;
+    /**
+     * 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.
+     */
+    createResourcesFromConnectors(connectors: BaseConnector[]): Promise<T[]>;
+    /**
+     * 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.
+     */
+    createPromptsFromConnectors(connectors: BaseConnector[]): Promise<T[]>;
+    /**
+     * 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.
+     */
+    private checkConnectorInitialized;
+    /**
+     * Ensure a connector is initialized.
+     *
+     * @param connector The connector to initialize.
+     * @returns         True if initialization succeeded, false otherwise.
+     */
+    private ensureConnectorInitialized;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/adapters/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/adapters/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGrD;;;;;GAKG;AACH,8BAAsB,WAAW,CAAC,CAAC;IACjC;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,eAAe,EAAE,MAAM,EAAE,CAAC;IAE7C;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAsC;gBAE3D,eAAe,CAAC,EAAE,MAAM,EAAE;IAItC;;;;;;;;;OASG;WACU,WAAW,CAAC,KAAK,EAAE,QAAQ,SAAS,WAAW,CAAC,KAAK,CAAC,EACjE,IAAI,EAAE,KAAK,eAAe,CAAC,EAAE,MAAM,EAAE,KAAK,QAAQ,EAClD,MAAM,EAAE,SAAS,EACjB,eAAe,CAAC,EAAE,MAAM,EAAE,GACzB,OAAO,CAAC,KAAK,EAAE,CAAC;IAyBnB;;;;;OAKG;IACG,qBAAqB,CAAC,SAAS,EAAE,aAAa,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAqCnE;;;;;;OAMG;IACH,SAAS,CAAC,QAAQ,CAAC,WAAW,CAC5B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC5B,SAAS,EAAE,aAAa,GACvB,CAAC,GAAG,IAAI,GAAG,SAAS;IAEvB;;;;;;OAMG;IACH,SAAS,CAAC,QAAQ,CAAC,eAAe,CAAC,CACjC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAChC,SAAS,EAAE,aAAa,GACvB,CAAC,GAAG,IAAI,GAAG,SAAS;IAEvB;;;;;;OAMG;IACH,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,CAC/B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC9B,SAAS,EAAE,aAAa,GACvB,CAAC,GAAG,IAAI,GAAG,SAAS;IAEvB;;;;;OAKG;IACU,yBAAyB,CACpC,UAAU,EAAE,aAAa,EAAE,GAC1B,OAAO,CAAC,CAAC,EAAE,CAAC;IAWf;;;;;OAKG;IACG,yBAAyB,CAAC,SAAS,EAAE,aAAa,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAoCvE;;;;;OAKG;IACG,uBAAuB,CAAC,SAAS,EAAE,aAAa,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAoCrE;;;;;OAKG;IACU,6BAA6B,CACxC,UAAU,EAAE,aAAa,EAAE,GAC1B,OAAO,CAAC,CAAC,EAAE,CAAC;IAYf;;;;;OAKG;IACU,2BAA2B,CACtC,UAAU,EAAE,aAAa,EAAE,GAC1B,OAAO,CAAC,CAAC,EAAE,CAAC;IAWf;;;;;OAKG;IACH,OAAO,CAAC,yBAAyB;IAIjC;;;;;OAKG;YACW,0BAA0B;CAezC"}

package/dist/adapters/index.d.ts

@@ -0,0 +1,3 @@
+export { BaseAdapter } from "./base.js";
+export { NativeAdapter } from "./native_adapter.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/adapters/langchain_adapter.d.ts

@@ -0,0 +1,26 @@
+import type { StructuredToolInterface } from "@langchain/core/tools";
+import type { Tool as MCPTool, Resource, Prompt } from "@modelcontextprotocol/client";
+import type { BaseConnector } from "@mcp-use/client";
+import { BaseAdapter } from "./base.js";
+export declare class LangChainAdapter extends BaseAdapter<StructuredToolInterface> {
+    private usedToolNames;
+    constructor(disallowedTools?: string[]);
+    private reserveName;
+    createToolsFromConnectors(connectors: BaseConnector[]): Promise<StructuredToolInterface[]>;
+    /**
+     * Convert a single MCP tool specification into a LangChainJS structured tool.
+     */
+    protected convertTool(mcpTool: MCPTool, connector: BaseConnector): StructuredToolInterface | null;
+    /**
+     * Convert a single MCP resource into a LangChainJS structured tool.
+     * Each resource becomes an async tool that returns its content when called.
+     */
+    protected convertResource(mcpResource: Resource, connector: BaseConnector): StructuredToolInterface | null;
+    /**
+     * Convert a single MCP prompt into a LangChainJS structured tool.
+     * The resulting tool executes getPrompt on the connector with the prompt's name
+     * and the user-provided arguments (if any).
+     */
+    protected convertPrompt(mcpPrompt: Prompt, connector: BaseConnector): StructuredToolInterface | null;
+}
+//# sourceMappingURL=langchain_adapter.d.ts.map

package/dist/adapters/langchain_adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"langchain_adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/langchain_adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,KAAK,EAEV,IAAI,IAAI,OAAO,EACf,QAAQ,EACR,MAAM,EACP,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAKrD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAmBxC,qBAAa,gBAAiB,SAAQ,WAAW,CAAC,uBAAuB,CAAC;IACxE,OAAO,CAAC,aAAa,CAA0B;gBAEnC,eAAe,GAAE,MAAM,EAAO;IAI1C,OAAO,CAAC,WAAW;IA0BG,yBAAyB,CAC7C,UAAU,EAAE,aAAa,EAAE,GAC1B,OAAO,CAAC,uBAAuB,EAAE,CAAC;IAMrC;;OAEG;IACH,SAAS,CAAC,WAAW,CACnB,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,aAAa,GACvB,uBAAuB,GAAG,IAAI;IAoCjC;;;OAGG;IACH,SAAS,CAAC,eAAe,CACvB,WAAW,EAAE,QAAQ,EACrB,SAAS,EAAE,aAAa,GACvB,uBAAuB,GAAG,IAAI;IA2CjC;;;;OAIG;IACH,SAAS,CAAC,aAAa,CACrB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,aAAa,GACvB,uBAAuB,GAAG,IAAI;CA6DlC"}

package/dist/adapters/native_adapter.d.ts

@@ -0,0 +1,27 @@
+import type { Prompt, Resource, Tool as MCPTool } from "@modelcontextprotocol/client";
+import type { BaseConnector } from "@mcp-use/client";
+import type { ProviderTool } from "../llm/types.js";
+import { BaseAdapter } from "./base.js";
+export interface NativeToolEntry extends ProviderTool {
+    /** Internal dispatch key (may differ from MCP name after dedup). */
+    dispatchKey: string;
+}
+export type NativeCallToolFn = (name: string, args: Record<string, unknown>) => Promise<unknown>;
+/**
+ * Converts MCP tools/resources/prompts to provider-neutral ProviderTool[]
+ * and a matching callTool dispatcher backed by @mcp-use/client connectors.
+ */
+export declare class NativeAdapter extends BaseAdapter<NativeToolEntry> {
+    private usedToolNames;
+    private handlers;
+    constructor(disallowedTools?: string[]);
+    createToolsFromConnectors(connectors: BaseConnector[]): Promise<NativeToolEntry[]>;
+    createCallTool(): NativeCallToolFn;
+    toProviderTools(entries: NativeToolEntry[]): ProviderTool[];
+    private reserveName;
+    private register;
+    protected convertTool(mcpTool: MCPTool, connector: BaseConnector): NativeToolEntry | null;
+    protected convertResource(mcpResource: Resource, connector: BaseConnector): NativeToolEntry | null;
+    protected convertPrompt(mcpPrompt: Prompt, connector: BaseConnector): NativeToolEntry | null;
+}
+//# sourceMappingURL=native_adapter.d.ts.map

package/dist/adapters/native_adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native_adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/native_adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,MAAM,EACN,QAAQ,EACR,IAAI,IAAI,OAAO,EAChB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AASxC,MAAM,WAAW,eAAgB,SAAQ,YAAY;IACnD,oEAAoE;IACpE,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,gBAAgB,GAAG,CAC7B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC1B,OAAO,CAAC,OAAO,CAAC,CAAC;AAStB;;;GAGG;AACH,qBAAa,aAAc,SAAQ,WAAW,CAAC,eAAe,CAAC;IAC7D,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,QAAQ,CAAkC;gBAEtC,eAAe,GAAE,MAAM,EAAO;IAIpB,yBAAyB,CAC7C,UAAU,EAAE,aAAa,EAAE,GAC1B,OAAO,CAAC,eAAe,EAAE,CAAC;IAM7B,cAAc,IAAI,gBAAgB;IAuBlC,eAAe,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,YAAY,EAAE;IAQ3D,OAAO,CAAC,WAAW;IAwBnB,OAAO,CAAC,QAAQ;IAQhB,SAAS,CAAC,WAAW,CACnB,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,aAAa,GACvB,eAAe,GAAG,IAAI;IAoBzB,SAAS,CAAC,eAAe,CACvB,WAAW,EAAE,QAAQ,EACrB,SAAS,EAAE,aAAa,GACvB,eAAe,GAAG,IAAI;IAoBzB,SAAS,CAAC,aAAa,CACrB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,aAAa,GACvB,eAAe,GAAG,IAAI;CA6B1B"}

package/dist/agents/agent_options.d.ts

@@ -0,0 +1,38 @@
+import type { MCPClient } from "@mcp-use/client";
+import type { BaseConnector } from "@mcp-use/client";
+import type { ProviderConfig } from "../llm/types.js";
+import type { NativeLLMConfig } from "../llm/provider_config.js";
+import type { MCPServerConfig } from "./types.js";
+/** Live MCP connection handle (McpServer from useMcp / useMcpClient). */
+export interface McpConnectionLike {
+    tools?: Array<{
+        name: string;
+        description?: string;
+        inputSchema?: Record<string, unknown>;
+    }>;
+    callTool: (name: string, args: Record<string, unknown>, options?: {
+        signal?: AbortSignal;
+    }) => Promise<unknown>;
+}
+/** Spawn configs (Node) OR live connections (browser). */
+export type McpServersInput = Record<string, MCPServerConfig> | McpConnectionLike[];
+export interface MCPAgentOptions {
+    /** Simplified: `"openai/gpt-4o"`. Explicit: `ProviderConfig`. */
+    llm: string | ProviderConfig;
+    llmConfig?: NativeLLMConfig;
+    client?: MCPClient;
+    connectors?: BaseConnector[];
+    /** Config map to spawn servers, or live connection array. */
+    mcpServers?: McpServersInput;
+    maxSteps?: number;
+    autoInitialize?: boolean;
+    memoryEnabled?: boolean;
+    systemPrompt?: string | null;
+    disallowedTools?: string[];
+    exposeResourcesAsTools?: boolean;
+    exposePromptsAsTools?: boolean;
+    agentId?: string;
+    apiKey?: string;
+    baseUrl?: string;
+}
+//# sourceMappingURL=agent_options.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent_options.d.ts","sourceRoot":"","sources":["../../src/agents/agent_options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,yEAAyE;AACzE,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,KAAK,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACvC,CAAC,CAAC;IACH,QAAQ,EAAE,CACR,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,KAC/B,OAAO,CAAC,OAAO,CAAC,CAAC;CACvB;AAED,0DAA0D;AAC1D,MAAM,MAAM,eAAe,GACvB,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,GAC/B,iBAAiB,EAAE,CAAC;AAExB,MAAM,WAAW,eAAe;IAC9B,iEAAiE;IACjE,GAAG,EAAE,MAAM,GAAG,cAAc,CAAC;IAC7B,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,UAAU,CAAC,EAAE,aAAa,EAAE,CAAC;IAC7B,6DAA6D;IAC7D,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,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,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/agents/base.d.ts

@@ -0,0 +1,27 @@
+import type { MCPSession } from "@mcp-use/client";
+export declare abstract class BaseAgent {
+    protected session: MCPSession;
+    /**
+     * @param session MCP session used for tool invocation
+     */
+    constructor(session: MCPSession);
+    /**
+     * Initialize the agent, including initializing the MCP session
+     */
+    abstract initialize(): Promise<void>;
+    /**
+     * Run the agent on a query with a maximum number of steps
+     * @param query The user query
+     * @param maxSteps Maximum steps allowed (default: 10)
+     * @returns Final result of agent execution
+     */
+    abstract run(query: string, maxSteps?: number): Promise<Record<string, any>>;
+    /**
+     * Perform a single step given the query and previous steps
+     * @param query The user query or intermediate input
+     * @param previousSteps History of steps so far
+     * @returns Result of this step
+     */
+    abstract step(query: string, previousSteps?: Array<Record<string, any>>): Promise<Record<string, any>>;
+}
+//# sourceMappingURL=base.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/agents/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,8BAAsB,SAAS;IAC7B,SAAS,CAAC,OAAO,EAAE,UAAU,CAAC;IAE9B;;OAEG;gBACS,OAAO,EAAE,UAAU;IAI/B;;OAEG;aACa,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAE3C;;;;;OAKG;aACa,GAAG,CACjB,KAAK,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE/B;;;;;OAKG;aACa,IAAI,CAClB,KAAK,EAAE,MAAM,EACb,aAAa,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,GACzC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC"}

package/dist/agents/display.d.ts

@@ -0,0 +1,6 @@
+import type { StreamEvent } from "@langchain/core/tracers/log_stream";
+/**
+ * Stream events with pretty printing
+ */
+export declare function prettyStreamEvents(streamEventsGenerator: AsyncGenerator<StreamEvent, void, void>): AsyncGenerator<void, string, void>;
+//# sourceMappingURL=display.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"display.d.ts","sourceRoot":"","sources":["../../src/agents/display.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AAwrBtE;;GAEG;AACH,wBAAuB,kBAAkB,CACvC,qBAAqB,EAAE,cAAc,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,CAAC,GAC7D,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,CAoCpC"}

package/dist/agents/index.d.ts

@@ -0,0 +1,9 @@
+export { PROMPTS } from "./prompts/index.js";
+export { BaseAgent } from "./base.js";
+export { MCPAgent } from "./mcp_agent.js";
+export { RemoteAgent } from "./remote.js";
+export type { MCPAgentOptions, McpConnectionLike, McpServersInput, } from "./agent_options.js";
+export type { BaseMessage, ExplicitModeOptions, LanguageModel, MCPServerConfig, SimplifiedModeOptions, } from "./types.js";
+export type { LLMConfig, LLMProvider } from "./utils/llm_provider.js";
+export type { RunOptions } from "./run_options.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,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,eAAe,EACf,iBAAiB,EACjB,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,WAAW,EACX,mBAAmB,EACnB,aAAa,EACb,eAAe,EACf,qBAAqB,GACtB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtE,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/agents/mcp_agent.d.ts

@@ -0,0 +1,90 @@
+import type { ZodSchema } from "zod";
+import { parseLLMStringToProviderConfig, providerConfigFromOptions } from "../llm/provider_config.js";
+import type { LlmStreamEvent, ProviderConfig, ProviderMessage, ProviderName, TokenUsage } from "../llm/types.js";
+import type { MCPAgentOptions } from "./agent_options.js";
+import type { RunOptions } from "./run_options.js";
+export type { ProviderName, ProviderConfig, ProviderMessage, LlmStreamEvent, TokenUsage, };
+export type { MCPAgentOptions, McpConnectionLike, McpServersInput, } from "./agent_options.js";
+export type { RunOptions } from "./run_options.js";
+export interface AgentStep {
+    action: {
+        tool: string;
+        toolInput: Record<string, unknown>;
+        log: string;
+    };
+    observation: string;
+}
+/**
+ * Cross-platform MCP agent: Inspector → MCPAgent → loop → fetch + @mcp-use/client.
+ */
+export declare class MCPAgent {
+    static getPackageVersion(): string;
+    private driver?;
+    private client?;
+    private connectors;
+    private clientOwnedByAgent;
+    private nativeAdapter;
+    private providerTools;
+    private callTool?;
+    private maxSteps;
+    private autoInitialize;
+    private systemPrompt;
+    private disallowedTools;
+    private exposeResourcesAsTools;
+    private exposePromptsAsTools;
+    private initialized;
+    private isRemote;
+    private remoteAgent;
+    private isSimplifiedMode;
+    private llmString?;
+    private llmConfig?;
+    private mcpServersConfig?;
+    private explicitProviderConfig?;
+    private conversationMessages;
+    private memoryEnabled;
+    private boundConnections?;
+    constructor(options: MCPAgentOptions);
+    private resolveMcpServers;
+    private hasLiveConnections;
+    initialize(): Promise<void>;
+    private loadTools;
+    private bindConnections;
+    private buildMessages;
+    getConversationHistory(): ProviderMessage[];
+    clearConversationHistory(): void;
+    setSystemMessage(message: string): void;
+    private ensureReady;
+    private nativeRunParams;
+    run(options: RunOptions): Promise<string>;
+    run<T>(options: RunOptions<T>): Promise<T>;
+    /** @deprecated Use run({ prompt, maxSteps, ... }) */
+    run(query: string, maxSteps?: number, manageConnector?: boolean, externalHistory?: unknown, outputSchema?: undefined, signal?: AbortSignal): Promise<string>;
+    /** @deprecated Use run({ prompt, schema, maxSteps, ... }) */
+    run<T>(query: string, maxSteps?: number, manageConnector?: boolean, externalHistory?: unknown, outputSchema?: ZodSchema<T>, signal?: AbortSignal): Promise<T>;
+    stream(options: RunOptions): AsyncGenerator<AgentStep, string, void>;
+    stream<T>(options: RunOptions<T>): AsyncGenerator<AgentStep, T, void>;
+    /** @deprecated Use stream({ prompt, maxSteps, ... }) */
+    stream<T = string>(query: string, maxSteps?: number, manageConnector?: boolean, externalHistory?: unknown, outputSchema?: ZodSchema<T>, signal?: AbortSignal): AsyncGenerator<AgentStep, string | T, void>;
+    streamEvents(options: RunOptions): AsyncGenerator<LlmStreamEvent, void, unknown>;
+    streamEvents<T>(options: RunOptions<T>): AsyncGenerator<LlmStreamEvent, void, unknown>;
+    /** @deprecated Use streamEvents({ prompt, maxSteps, ... }) */
+    streamEvents<T = string>(query: string, maxSteps?: number, manageConnector?: boolean, externalHistory?: unknown, outputSchema?: ZodSchema<T>, signal?: AbortSignal): AsyncGenerator<LlmStreamEvent, void, unknown>;
+    /** Single-shot completion without tools (sampling, props generation). */
+    chat(options: {
+        messages: ProviderMessage[];
+        signal?: AbortSignal;
+    }): Promise<string>;
+    close(): Promise<void>;
+}
+/** Inspector / config UI LLM shape. */
+export interface LLMConfig {
+    provider: ProviderName;
+    model: string;
+    apiKey: string;
+    temperature?: number;
+    baseUrl?: string;
+}
+export { providerConfigFromOptions, parseLLMStringToProviderConfig };
+export { LlmRequestError } from "../llm/providers/openai-chat-completions.js";
+export { convertMessagesToProvider } from "../llm/messageFormat.js";
+//# sourceMappingURL=mcp_agent.d.ts.map

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

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