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

package/dist/llm/usage.d.ts

@@ -0,0 +1,4 @@
+import type { TokenUsage } from "./types.js";
+/** Normalize exact provider-reported token counters. Never estimates usage. */
+export declare function tokenUsageFromRecord(raw: unknown): TokenUsage | undefined;
+//# sourceMappingURL=usage.d.ts.map

package/dist/llm/usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/llm/usage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAe7C,+EAA+E;AAC/E,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,CA0DzE"}

package/dist/managers/server_manager.d.ts

@@ -0,0 +1,19 @@
+import type { StructuredToolInterface } from "@langchain/core/tools";
+import type { LangChainAdapter } from "../adapters/langchain_adapter.js";
+import type { MCPClient } from "@mcp-use/client";
+import type { IServerManager } from "./types.js";
+export declare class ServerManager implements IServerManager {
+    readonly initializedServers: Record<string, boolean>;
+    readonly serverTools: Record<string, StructuredToolInterface[]>;
+    readonly client: MCPClient;
+    readonly adapter: LangChainAdapter;
+    activeServer: string | null;
+    private overrideManagementTools?;
+    constructor(client: MCPClient, adapter: LangChainAdapter, managementTools?: StructuredToolInterface[]);
+    setManagementTools(tools: StructuredToolInterface[]): void;
+    logState(context: string): void;
+    initialize(): void;
+    prefetchServerTools(): Promise<void>;
+    get tools(): StructuredToolInterface[];
+}
+//# sourceMappingURL=server_manager.d.ts.map

package/dist/managers/server_manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server_manager.d.ts","sourceRoot":"","sources":["../../src/managers/server_manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAmDjD,qBAAa,aAAc,YAAW,cAAc;IAClD,SAAgB,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAM;IACjE,SAAgB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,EAAE,CAAC,CAAM;IAE5E,SAAgB,MAAM,EAAE,SAAS,CAAC;IAClC,SAAgB,OAAO,EAAE,gBAAgB,CAAC;IACnC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAQ;IAC1C,OAAO,CAAC,uBAAuB,CAAC,CAA4B;gBAG1D,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,gBAAgB,EACzB,eAAe,CAAC,EAAE,uBAAuB,EAAE;IAOtC,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,EAAE,GAAG,IAAI;IAO1D,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAqBtC,UAAU,IAAI,IAAI;IAOZ,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAwE1C,IAAI,KAAK,IAAI,uBAAuB,EAAE,CAsBrC;CACF"}

package/dist/managers/tools/acquire_active_mcp_server.d.ts

@@ -0,0 +1,13 @@
+import type { IServerManager } from "../types.js";
+import { z } from "zod";
+import { MCPServerTool } from "./base.js";
+declare const PresentActiveServerSchema: z.ZodObject<{}, z.core.$strip>;
+export declare class AcquireActiveMCPServerTool extends MCPServerTool<typeof PresentActiveServerSchema> {
+    name: string;
+    description: string;
+    schema: z.ZodObject<{}, z.core.$strip>;
+    constructor(manager: IServerManager);
+    _call(): Promise<string>;
+}
+export {};
+//# sourceMappingURL=acquire_active_mcp_server.d.ts.map

package/dist/managers/tools/acquire_active_mcp_server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acquire_active_mcp_server.d.ts","sourceRoot":"","sources":["../../../src/managers/tools/acquire_active_mcp_server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C,QAAA,MAAM,yBAAyB,gCAAe,CAAC;AAE/C,qBAAa,0BAA2B,SAAQ,aAAa,CAC3D,OAAO,yBAAyB,CACjC;IACU,IAAI,SAA2B;IAC/B,WAAW,SAC6C;IACxD,MAAM,iCAA6B;gBAEhC,OAAO,EAAE,cAAc;IAI7B,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;CAO/B"}

package/dist/managers/tools/add_server_from_config.d.ts

@@ -0,0 +1,15 @@
+import type { IServerManager } from "../types.js";
+import { StructuredTool } from "@langchain/core/tools";
+import { z } from "zod";
+export declare class AddMCPServerFromConfigTool extends StructuredTool {
+    name: string;
+    description: string;
+    schema: z.ZodObject<{
+        serverName: z.ZodString;
+        serverConfig: z.ZodAny;
+    }, z.core.$strip>;
+    private manager;
+    constructor(manager: IServerManager);
+    protected _call({ serverName, serverConfig, }: z.infer<typeof this.schema>): Promise<string>;
+}
+//# sourceMappingURL=add_server_from_config.d.ts.map

package/dist/managers/tools/add_server_from_config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add_server_from_config.d.ts","sourceRoot":"","sources":["../../../src/managers/tools/add_server_from_config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,qBAAa,0BAA2B,SAAQ,cAAc;IAC5D,IAAI,SAAgC;IACpC,WAAW,SACyG;IAEpH,MAAM;;;sBAOH;IAEH,OAAO,CAAC,OAAO,CAAiB;gBAEpB,OAAO,EAAE,cAAc;cAKnB,KAAK,CAAC,EACpB,UAAU,EACV,YAAY,GACb,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;CA4BjD"}

package/dist/managers/tools/base.d.ts

@@ -0,0 +1,19 @@
+import type { CallbackManagerForToolRun } from "@langchain/core/callbacks/manager";
+import type { ToolRunnableConfig, ToolSchemaBase } from "@langchain/core/tools";
+import type { JSONSchema } from "@langchain/core/utils/json_schema";
+import type z from "zod";
+import type { IServerManager } from "../types.js";
+import { StructuredTool } from "@langchain/core/tools";
+type ToolOutputT = any;
+export type SchemaOutputT<T extends ToolSchemaBase> = T extends z.ZodSchema ? z.output<T> : T extends JSONSchema ? unknown : never;
+export declare class MCPServerTool<SchemaT extends ToolSchemaBase> extends StructuredTool<SchemaT, SchemaOutputT<SchemaT>> {
+    name: string;
+    description: string;
+    schema: SchemaT;
+    private readonly _manager;
+    constructor(manager: IServerManager);
+    protected _call(_arg: SchemaOutputT<SchemaT>, _runManager?: CallbackManagerForToolRun, _parentConfig?: ToolRunnableConfig): Promise<ToolOutputT>;
+    get manager(): IServerManager;
+}
+export {};
+//# sourceMappingURL=base.d.ts.map

package/dist/managers/tools/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/managers/tools/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AACnF,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAChF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAC;AACpE,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,KAAK,WAAW,GAAG,GAAG,CAAC;AACvB,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,cAAc,IAAI,CAAC,SAAS,CAAC,CAAC,SAAS,GACvE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GACX,CAAC,SAAS,UAAU,GAClB,OAAO,GACP,KAAK,CAAC;AAEZ,qBAAa,aAAa,CACxB,OAAO,SAAS,cAAc,CAC9B,SAAQ,cAAc,CAAC,OAAO,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IAC9C,IAAI,EAAE,MAAM,CAAqB;IACjC,WAAW,EAAE,MAAM,CAA0C;IAC7D,MAAM,EAAG,OAAO,CAAC;IAE1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;gBAE9B,OAAO,EAAE,cAAc;cAKnB,KAAK,CACnB,IAAI,EAAE,aAAa,CAAC,OAAO,CAAC,EAC5B,WAAW,CAAC,EAAE,yBAAyB,EACvC,aAAa,CAAC,EAAE,kBAAkB,GACjC,OAAO,CAAC,WAAW,CAAC;IAIvB,IAAI,OAAO,IAAI,cAAc,CAE5B;CACF"}

package/dist/managers/tools/connect_mcp_server.d.ts

@@ -0,0 +1,18 @@
+import type { IServerManager } from "../types.js";
+import type { SchemaOutputT } from "./base.js";
+import { z } from "zod";
+import { MCPServerTool } from "./base.js";
+declare const ConnectMCPServerSchema: z.ZodObject<{
+    serverName: z.ZodString;
+}, z.core.$strip>;
+export declare class ConnectMCPServerTool extends MCPServerTool<typeof ConnectMCPServerSchema> {
+    name: string;
+    description: string;
+    schema: z.ZodObject<{
+        serverName: z.ZodString;
+    }, z.core.$strip>;
+    constructor(manager: IServerManager);
+    _call({ serverName }: SchemaOutputT<typeof ConnectMCPServerSchema>): Promise<string>;
+}
+export {};
+//# sourceMappingURL=connect_mcp_server.d.ts.map

package/dist/managers/tools/connect_mcp_server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect_mcp_server.d.ts","sourceRoot":"","sources":["../../../src/managers/tools/connect_mcp_server.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C,QAAA,MAAM,sBAAsB;;iBAE1B,CAAC;AAEH,qBAAa,oBAAqB,SAAQ,aAAa,CACrD,OAAO,sBAAsB,CAC9B;IACU,IAAI,SAA2B;IAC/B,WAAW,SAC6H;IACxI,MAAM;;sBAA0B;gBAE7B,OAAO,EAAE,cAAc;IAI7B,KAAK,CAAC,EAAE,UAAU,EAAE,EAAE,aAAa,CAAC,OAAO,sBAAsB,CAAC;CAgDzE"}

package/dist/managers/tools/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./acquire_active_mcp_server.js";
+export * from "./add_server_from_config.js";
+export * from "./connect_mcp_server.js";
+export * from "./list_mcp_servers.js";
+export * from "./release_mcp_server_connection.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/managers/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/managers/tools/index.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oCAAoC,CAAC"}

package/dist/managers/tools/list_mcp_servers.d.ts

@@ -0,0 +1,13 @@
+import type { IServerManager } from "../types.js";
+import { z } from "zod";
+import { MCPServerTool } from "./base.js";
+declare const EnumerateServersSchema: z.ZodObject<{}, z.core.$strip>;
+export declare class ListMCPServersTool extends MCPServerTool<typeof EnumerateServersSchema> {
+    name: string;
+    description: string;
+    schema: z.ZodObject<{}, z.core.$strip>;
+    constructor(manager: IServerManager);
+    _call(): Promise<string>;
+}
+export {};
+//# sourceMappingURL=list_mcp_servers.d.ts.map

package/dist/managers/tools/list_mcp_servers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list_mcp_servers.d.ts","sourceRoot":"","sources":["../../../src/managers/tools/list_mcp_servers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C,QAAA,MAAM,sBAAsB,gCAAe,CAAC;AAE5C,qBAAa,kBAAmB,SAAQ,aAAa,CACnD,OAAO,sBAAsB,CAC9B;IACU,IAAI,SAAsB;IAC1B,WAAW,SAAkN;IAC7N,MAAM,iCAA0B;gBAE7B,OAAO,EAAE,cAAc;IAI7B,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;CA2B/B"}

package/dist/managers/tools/release_mcp_server_connection.d.ts

@@ -0,0 +1,13 @@
+import type { IServerManager } from "../types.js";
+import { z } from "zod";
+import { MCPServerTool } from "./base.js";
+declare const ReleaseConnectionSchema: z.ZodObject<{}, z.core.$strip>;
+export declare class ReleaseMCPServerConnectionTool extends MCPServerTool<typeof ReleaseConnectionSchema> {
+    name: string;
+    description: string;
+    schema: z.ZodObject<{}, z.core.$strip>;
+    constructor(manager: IServerManager);
+    _call(): Promise<string>;
+}
+export {};
+//# sourceMappingURL=release_mcp_server_connection.d.ts.map

package/dist/managers/tools/release_mcp_server_connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"release_mcp_server_connection.d.ts","sourceRoot":"","sources":["../../../src/managers/tools/release_mcp_server_connection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C,QAAA,MAAM,uBAAuB,gCAAe,CAAC;AAE7C,qBAAa,8BAA+B,SAAQ,aAAa,CAC/D,OAAO,uBAAuB,CAC/B;IACU,IAAI,SAAgC;IACpC,WAAW,SACyD;IACpE,MAAM,iCAA2B;gBAE9B,OAAO,EAAE,cAAc;IAI7B,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;CAQ/B"}

package/dist/managers/types.d.ts

@@ -0,0 +1,14 @@
+import type { StructuredToolInterface } from "@langchain/core/tools";
+import type { LangChainAdapter } from "../adapters/langchain_adapter.js";
+import type { MCPClient } from "@mcp-use/client";
+export interface IServerManager {
+    readonly initializedServers: Record<string, boolean>;
+    readonly serverTools: Record<string, StructuredToolInterface[]>;
+    readonly client: MCPClient;
+    readonly adapter: LangChainAdapter;
+    activeServer: string | null;
+    setManagementTools(tools: StructuredToolInterface[]): void;
+    prefetchServerTools(): Promise<void>;
+    get tools(): StructuredToolInterface[];
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/managers/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,EAAE,CAAC,CAAC;IAChE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;IACnC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5B,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,EAAE,GAAG,IAAI,CAAC;IAC3D,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,IAAI,KAAK,IAAI,uBAAuB,EAAE,CAAC;CACxC"}

package/dist/observability/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Observability module for MCP-use.
+ *
+ * This module provides centralized observability management for LangChain agents,
+ * supporting multiple platforms like Langfuse and Laminar.
+ */
+import "./langfuse.js";
+export { type ObservabilityConfig, ObservabilityManager } from "./manager.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/observability/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,eAAe,CAAC;AAGvB,OAAO,EAAE,KAAK,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC"}

package/dist/observability/langfuse.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Langfuse observability integration for MCP-use.
+ *
+ * This module provides automatic instrumentation and callback handler
+ * for Langfuse observability platform.
+ *
+ * Note: This module expects environment variables to be loaded before import.
+ * Users should load their environment variables using their preferred method
+ * (e.g., dotenv, direct process.env assignment, or system environment).
+ */
+import type { BaseCallbackHandler } from "@langchain/core/callbacks/base";
+/**
+ * Initializes Langfuse observability for the application and installs a callback handler that augments traces with optional agent metadata and tags.
+ *
+ * This will attempt to dynamically load the Langfuse LangChain integration and, if available, create and store a wrapped callback handler (and optionally a Langfuse client) on the module state so tracing can be used elsewhere in the application.
+ *
+ * @param agentId - Optional identifier for the agent to include in traces
+ * @param metadata - Optional static metadata to attach to traces; merged with dynamic metadata if a provider is supplied
+ * @param metadataProvider - Optional function that returns dynamic metadata to attach to traces at runtime
+ * @param tagsProvider - Optional function that returns an array of tags to attach to traces at runtime
+ */
+declare function initializeLangfuse(agentId?: string, metadata?: Record<string, any>, metadataProvider?: () => Record<string, any>, tagsProvider?: () => string[]): Promise<void>;
+export declare const langfuseHandler: () => BaseCallbackHandler | null;
+export declare const langfuseInitPromise: () => Promise<void> | null;
+export { initializeLangfuse };
+//# sourceMappingURL=langfuse.d.ts.map

package/dist/observability/langfuse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"langfuse.d.ts","sourceRoot":"","sources":["../../src/observability/langfuse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AA2B1E;;;;;;;;;GASG;AACH,iBAAe,kBAAkB,CAC/B,OAAO,CAAC,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC9B,gBAAgB,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC5C,YAAY,CAAC,EAAE,MAAM,MAAM,EAAE,GAC5B,OAAO,CAAC,IAAI,CAAC,CAqRf;AAoBD,eAAO,MAAM,eAAe,kCAA8B,CAAC;AAC3D,eAAO,MAAM,mBAAmB,4BAAkC,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/observability/manager.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Observability callbacks manager for MCP-use.
+ *
+ * This module provides a centralized manager for handling observability callbacks
+ * from various platforms (Langfuse, Laminar, etc.) in a clean and extensible way.
+ */
+import type { BaseCallbackHandler } from "@langchain/core/callbacks/base";
+export interface ObservabilityConfig {
+    /** Custom callbacks to use instead of defaults */
+    customCallbacks?: BaseCallbackHandler[];
+    /** Whether to enable verbose logging */
+    verbose?: boolean;
+    /** Whether to enable observability (defaults to true) */
+    observe?: boolean;
+    /** Agent ID for tagging traces */
+    agentId?: string;
+    /** Metadata to add to traces */
+    metadata?: Record<string, any>;
+    /** Function to get current metadata from agent */
+    metadataProvider?: () => Record<string, any>;
+    /** Function to get current tags from agent */
+    tagsProvider?: () => string[];
+}
+export declare class ObservabilityManager {
+    private customCallbacks?;
+    private availableHandlers;
+    private handlerNames;
+    private initialized;
+    private verbose;
+    private observe;
+    private agentId?;
+    private metadata?;
+    private metadataProvider?;
+    private tagsProvider?;
+    constructor(config?: ObservabilityConfig);
+    /**
+     * Collect all available observability handlers from configured platforms.
+     */
+    private collectAvailableHandlers;
+    /**
+     * Get the list of callbacks to use.
+     * @returns List of callbacks - either custom callbacks if provided, or all available observability handlers.
+     */
+    getCallbacks(): Promise<BaseCallbackHandler[]>;
+    /**
+     * Get the names of available handlers.
+     * @returns List of handler names (e.g., ["Langfuse", "Laminar"])
+     */
+    getHandlerNames(): Promise<string[]>;
+    /**
+     * Check if any callbacks are available.
+     * @returns True if callbacks are available, False otherwise.
+     */
+    hasCallbacks(): Promise<boolean>;
+    /**
+     * Get the current observability status including metadata and tags.
+     * @returns Object containing enabled status, callback count, handler names, metadata, and tags.
+     */
+    getStatus(): Promise<{
+        enabled: boolean;
+        callbackCount: number;
+        handlerNames: string[];
+        metadata: Record<string, any>;
+        tags: string[];
+    }>;
+    /**
+     * Add a callback to the custom callbacks list.
+     * @param callback The callback to add.
+     */
+    addCallback(callback: BaseCallbackHandler): void;
+    /**
+     * Clear all custom callbacks.
+     */
+    clearCallbacks(): void;
+    /**
+     * Flush all pending traces to observability platforms.
+     * Important for serverless environments and short-lived processes.
+     */
+    flush(): Promise<void>;
+    /**
+     * Shutdown all handlers gracefully (for serverless environments).
+     */
+    shutdown(): Promise<void>;
+    /**
+     * String representation of the ObservabilityManager.
+     */
+    toString(): string;
+}
+//# sourceMappingURL=manager.d.ts.map

package/dist/observability/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/observability/manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAG1E,MAAM,WAAW,mBAAmB;IAClC,kDAAkD;IAClD,eAAe,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACxC,wCAAwC;IACxC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,yDAAyD;IACzD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,kCAAkC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gCAAgC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/B,kDAAkD;IAClD,gBAAgB,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7C,8CAA8C;IAC9C,YAAY,CAAC,EAAE,MAAM,MAAM,EAAE,CAAC;CAC/B;AAED,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,eAAe,CAAC,CAAwB;IAChD,OAAO,CAAC,iBAAiB,CAA6B;IACtD,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,OAAO,CAAC,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAC,CAAsB;IACvC,OAAO,CAAC,gBAAgB,CAAC,CAA4B;IACrD,OAAO,CAAC,YAAY,CAAC,CAAiB;gBAE1B,MAAM,GAAE,mBAAwB;IAU5C;;OAEG;YACW,wBAAwB;IAmDtC;;;OAGG;IACG,YAAY,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;IA+BpD;;;OAGG;IACG,eAAe,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAe1C;;;OAGG;IACG,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC;IAUtC;;;OAGG;IACG,SAAS,IAAI,OAAO,CAAC;QACzB,OAAO,EAAE,OAAO,CAAC;QACjB,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC9B,IAAI,EAAE,MAAM,EAAE,CAAC;KAChB,CAAC;IAqBF;;;OAGG;IACH,WAAW,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI;IAUhD;;OAEG;IACH,cAAc,IAAI,IAAI;IAKtB;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAc5B;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAuB/B;;OAEG;IACH,QAAQ,IAAI,MAAM;CAOnB"}

package/dist/telemetry/utils.d.ts

@@ -0,0 +1,4 @@
+import type { BaseLanguageModel } from "@langchain/core/language_models/base";
+export { getPackageVersion } from "../version.js";
+export declare function extractModelInfo(llm: BaseLanguageModel): [string, string];
+//# sourceMappingURL=utils.d.ts.map

package/dist/telemetry/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/telemetry/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAiClD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,iBAAiB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAEzE"}

package/dist/version.d.ts

@@ -0,0 +1,3 @@
+export declare const VERSION: string;
+export declare function getPackageVersion(): string;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,OAAO,QAA8B,CAAC;AAEnD,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C"}

package/package.json

@@ -1,18 +1,119 @@
 {
   "name": "@mcp-use/agent",
-  "version": "0.0.0-bootstrap.0",
-  "description": "Package-name reservation for GitHub OIDC releases of @mcp-use/agent.",
+  "type": "module",
+  "version": "2.0.0-beta.0",
+  "description": "Native cross-platform MCP agent. Inspector → MCPAgent → loop → fetch + @mcp-use/client. LangChain bridge at @mcp-use/agent/langchain.",
+  "author": "mcp-use, Inc.",
   "license": "MIT",
+  "homepage": "https://github.com/mcp-use/mcp-use#readme",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/mcp-use/mcp-use.git"
+    "url": "git+https://github.com/mcp-use/mcp-use.git",
+    "directory": "libraries/typescript/packages/agent"
   },
-  "homepage": "https://github.com/mcp-use/mcp-use",
+  "bugs": {
+    "url": "https://github.com/mcp-use/mcp-use/issues"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "agent",
+    "langchain",
+    "ai",
+    "typescript"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./browser": {
+      "types": "./dist/browser-agent.d.ts",
+      "import": "./dist/browser-agent.js",
+      "require": "./dist/browser-agent.cjs"
+    },
+    "./langchain": {
+      "types": "./dist/langchain.d.ts",
+      "import": "./dist/langchain.js",
+      "require": "./dist/langchain.cjs"
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "files": [
-    "README.md"
+    "dist"
   ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/client": "2.0.0-beta.3",
+    "chalk": "4.1.2",
+    "@mcp-use/client": "2.0.0-beta.0"
+  },
+  "optionalDependencies": {
+    "cli-highlight": "2.1.11"
+  },
+  "peerDependencies": {
+    "@langchain/anthropic": "^1.3.0",
+    "@langchain/core": "^1.1.0",
+    "@langchain/openai": "^1.2.0",
+    "langchain": "^1.2.10",
+    "langfuse": "^3.38.6",
+    "langfuse-langchain": "^3.38.6",
+    "zod": "^4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@langchain/anthropic": {
+      "optional": true
+    },
+    "@langchain/core": {
+      "optional": true
+    },
+    "@langchain/openai": {
+      "optional": true
+    },
+    "langchain": {
+      "optional": true
+    },
+    "langfuse": {
+      "optional": true
+    },
+    "langfuse-langchain": {
+      "optional": true
+    },
+    "zod": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@langchain/openai": "^1.2.8",
+    "ai": "^6.0.116",
+    "rimraf": "^6.1.3",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.0",
+    "zod": "4.3.5"
+  },
   "publishConfig": {
-    "access": "public",
-    "tag": "bootstrap"
+    "access": "public"
+  },
+  "scripts": {
+    "build": "rimraf dist && tsup && tsc --emitDeclarationOnly --declaration",
+    "dev": "tsc --watch",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "test:unit": "vitest run --exclude 'tests/integration/**'",
+    "test:integration": "vitest run tests/integration",
+    "test:integration:agent": "vitest run tests/integration/agent",
+    "test:integration:run": "vitest run tests/integration/agent/test_agent_run.test.ts",
+    "test:integration:stream": "vitest run tests/integration/agent/test_agent_stream.test.ts",
+    "test:integration:streamevents": "vitest run tests/integration/agent/test_agent_stream_events.test.ts",
+    "test:integration:structured": "vitest run tests/integration/agent/test_agent_structured_output.test.ts",
+    "test:integration:manager": "vitest run tests/integration/agent/test_server_manager.test.ts",
+    "test:integration:observability": "vitest run tests/integration/agent/test_agent_observability.test.ts",
+    "test:integration:codemode": "vitest run tests/integration/agent/test_code_mode.test.ts"
   }
-}
+}

package/README.md

@@ -1,5 +0,0 @@
-# @mcp-use/agent bootstrap reservation
-
-This inert package version only reserves the npm package name so trusted
-publishing can be configured. Install a release from the `beta` or `latest`
-dist-tag instead.