mcp-use 1.9.1-canary.0 → 1.10.0-canary.2

package/dist/src/session.d.ts

@@ -1,4 +1,5 @@
-import type { Notification, Root } from "@modelcontextprotocol/sdk/types.js";
+import type { CallToolResult, Notification, Root, Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { RequestOptions } from "@modelcontextprotocol/sdk/shared/protocol.js";
 import type { BaseConnector, NotificationHandler } from "./connectors/base.js";
 export declare class MCPSession {
     readonly connector: BaseConnector;
@@ -45,6 +46,340 @@ export declare class MCPSession {
      * Get the current roots.
      */
     getRoots(): Root[];
+    /**
+     * Get the cached list of tools from the server.
+     *
+     * @returns Array of available tools
+     *
+     * @example
+     * ```typescript
+     * const tools = session.tools;
+     * console.log(`Available tools: ${tools.map(t => t.name).join(", ")}`);
+     * ```
+     */
+    get tools(): Tool[];
+    /**
+     * Get the server capabilities advertised during initialization.
+     *
+     * @returns Server capabilities object
+     */
+    get serverCapabilities(): any;
+    /**
+     * Get the server information (name and version).
+     *
+     * @returns Server info object or null if not available
+     */
+    get serverInfo(): {
+        name: string;
+        version?: string;
+    } | null;
+    /**
+     * Call a tool on the server.
+     *
+     * @param name - Name of the tool to call
+     * @param args - Arguments to pass to the tool
+     * @param options - Optional request options (timeout, progress handlers, etc.)
+     * @returns Result from the tool execution
+     *
+     * @example
+     * ```typescript
+     * const result = await session.callTool("add", { a: 5, b: 3 });
+     * console.log(`Result: ${result.content[0].text}`);
+     * ```
+     */
+    callTool(name: string, args: Record<string, any>, options?: RequestOptions): Promise<CallToolResult>;
+    /**
+     * List resources from the server with optional pagination.
+     *
+     * @param cursor - Optional cursor for pagination
+     * @param options - Request options
+     * @returns Resource list with optional nextCursor for pagination
+     *
+     * @example
+     * ```typescript
+     * const result = await session.listResources();
+     * console.log(`Found ${result.resources.length} resources`);
+     * ```
+     */
+    listResources(cursor?: string, options?: RequestOptions): Promise<{
+        [x: string]: unknown;
+        resources: {
+            uri: string;
+            name: string;
+            description?: string | undefined;
+            mimeType?: string | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+            icons?: {
+                src: string;
+                mimeType?: string | undefined;
+                sizes?: string[] | undefined;
+            }[] | undefined;
+            title?: string | undefined;
+        }[];
+        _meta?: {
+            [x: string]: unknown;
+            "io.modelcontextprotocol/related-task"?: {
+                [x: string]: unknown;
+                taskId: string;
+            } | undefined;
+        } | undefined;
+        nextCursor?: string | undefined;
+    }>;
+    /**
+     * List all resources from the server, automatically handling pagination.
+     *
+     * @param options - Request options
+     * @returns Complete list of all resources
+     *
+     * @example
+     * ```typescript
+     * const result = await session.listAllResources();
+     * console.log(`Total resources: ${result.resources.length}`);
+     * ```
+     */
+    listAllResources(options?: RequestOptions): Promise<{
+        resources: any[];
+    }>;
+    /**
+     * List resource templates from the server.
+     *
+     * @param options - Request options
+     * @returns List of available resource templates
+     *
+     * @example
+     * ```typescript
+     * const result = await session.listResourceTemplates();
+     * console.log(`Available templates: ${result.resourceTemplates.length}`);
+     * ```
+     */
+    listResourceTemplates(options?: RequestOptions): Promise<{
+        [x: string]: unknown;
+        resourceTemplates: {
+            uriTemplate: string;
+            name: string;
+            description?: string | undefined;
+            mimeType?: string | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+            icons?: {
+                src: string;
+                mimeType?: string | undefined;
+                sizes?: string[] | undefined;
+            }[] | undefined;
+            title?: string | undefined;
+        }[];
+        _meta?: {
+            [x: string]: unknown;
+            "io.modelcontextprotocol/related-task"?: {
+                [x: string]: unknown;
+                taskId: string;
+            } | undefined;
+        } | undefined;
+        nextCursor?: string | undefined;
+    }>;
+    /**
+     * Read a resource by URI.
+     *
+     * @param uri - URI of the resource to read
+     * @param options - Request options
+     * @returns Resource content
+     *
+     * @example
+     * ```typescript
+     * const resource = await session.readResource("file:///path/to/file.txt");
+     * console.log(resource.contents);
+     * ```
+     */
+    readResource(uri: string, options?: RequestOptions): Promise<{
+        [x: string]: unknown;
+        contents: ({
+            uri: string;
+            text: string;
+            mimeType?: string | undefined;
+            _meta?: Record<string, unknown> | undefined;
+        } | {
+            uri: string;
+            blob: string;
+            mimeType?: string | undefined;
+            _meta?: Record<string, unknown> | undefined;
+        })[];
+        _meta?: {
+            [x: string]: unknown;
+            "io.modelcontextprotocol/related-task"?: {
+                [x: string]: unknown;
+                taskId: string;
+            } | undefined;
+        } | undefined;
+    }>;
+    /**
+     * Subscribe to resource updates.
+     *
+     * @param uri - URI of the resource to subscribe to
+     * @param options - Request options
+     *
+     * @example
+     * ```typescript
+     * await session.subscribeToResource("file:///path/to/file.txt");
+     * // Now you'll receive notifications when this resource changes
+     * ```
+     */
+    subscribeToResource(uri: string, options?: RequestOptions): Promise<{
+        _meta?: {
+            [x: string]: unknown;
+            "io.modelcontextprotocol/related-task"?: {
+                [x: string]: unknown;
+                taskId: string;
+            } | undefined;
+        } | undefined;
+    }>;
+    /**
+     * Unsubscribe from resource updates.
+     *
+     * @param uri - URI of the resource to unsubscribe from
+     * @param options - Request options
+     *
+     * @example
+     * ```typescript
+     * await session.unsubscribeFromResource("file:///path/to/file.txt");
+     * ```
+     */
+    unsubscribeFromResource(uri: string, options?: RequestOptions): Promise<{
+        _meta?: {
+            [x: string]: unknown;
+            "io.modelcontextprotocol/related-task"?: {
+                [x: string]: unknown;
+                taskId: string;
+            } | undefined;
+        } | undefined;
+    }>;
+    /**
+     * List available prompts from the server.
+     *
+     * @returns List of available prompts
+     *
+     * @example
+     * ```typescript
+     * const result = await session.listPrompts();
+     * console.log(`Available prompts: ${result.prompts.length}`);
+     * ```
+     */
+    listPrompts(): Promise<{
+        [x: string]: unknown;
+        prompts: {
+            name: string;
+            description?: string | undefined;
+            arguments?: {
+                name: string;
+                description?: string | undefined;
+                required?: boolean | undefined;
+            }[] | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+            icons?: {
+                src: string;
+                mimeType?: string | undefined;
+                sizes?: string[] | undefined;
+            }[] | undefined;
+            title?: string | undefined;
+        }[];
+        _meta?: {
+            [x: string]: unknown;
+            "io.modelcontextprotocol/related-task"?: {
+                [x: string]: unknown;
+                taskId: string;
+            } | undefined;
+        } | undefined;
+        nextCursor?: string | undefined;
+    }>;
+    /**
+     * Get a specific prompt with arguments.
+     *
+     * @param name - Name of the prompt to get
+     * @param args - Arguments for the prompt
+     * @returns Prompt result
+     *
+     * @example
+     * ```typescript
+     * const prompt = await session.getPrompt("greeting", { name: "Alice" });
+     * console.log(prompt.messages);
+     * ```
+     */
+    getPrompt(name: string, args: Record<string, any>): Promise<{
+        [x: string]: unknown;
+        messages: {
+            role: "user" | "assistant";
+            content: {
+                type: "text";
+                text: string;
+                _meta?: Record<string, unknown> | undefined;
+            } | {
+                type: "image";
+                data: string;
+                mimeType: string;
+                _meta?: Record<string, unknown> | undefined;
+            } | {
+                type: "audio";
+                data: string;
+                mimeType: string;
+                _meta?: Record<string, unknown> | undefined;
+            } | {
+                type: "resource";
+                resource: {
+                    uri: string;
+                    text: string;
+                    mimeType?: string | undefined;
+                    _meta?: Record<string, unknown> | undefined;
+                } | {
+                    uri: string;
+                    blob: string;
+                    mimeType?: string | undefined;
+                    _meta?: Record<string, unknown> | undefined;
+                };
+                _meta?: Record<string, unknown> | undefined;
+            } | {
+                uri: string;
+                name: string;
+                type: "resource_link";
+                description?: string | undefined;
+                mimeType?: string | undefined;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+                icons?: {
+                    src: string;
+                    mimeType?: string | undefined;
+                    sizes?: string[] | undefined;
+                }[] | undefined;
+                title?: string | undefined;
+            };
+        }[];
+        _meta?: {
+            [x: string]: unknown;
+            "io.modelcontextprotocol/related-task"?: {
+                [x: string]: unknown;
+                taskId: string;
+            } | undefined;
+        } | undefined;
+        description?: string | undefined;
+    }>;
+    /**
+     * Send a raw request through the client.
+     *
+     * @param method - MCP method name
+     * @param params - Request parameters
+     * @param options - Request options
+     * @returns Response from the server
+     *
+     * @example
+     * ```typescript
+     * const result = await session.request("custom/method", { key: "value" });
+     * ```
+     */
+    request(method: string, params?: Record<string, any> | null, options?: RequestOptions): Promise<any>;
 }
-export type { Notification, Root };
+export type { CallToolResult, Notification, Root, Tool };
 //# sourceMappingURL=session.d.ts.map

package/dist/src/session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE/E,qBAAa,UAAU;IACrB,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;IAClC,OAAO,CAAC,WAAW,CAAU;gBAEjB,SAAS,EAAE,aAAa,EAAE,WAAW,UAAO;IAKlD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAOjC,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,EAAE,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,mBAAmB,GAAG,IAAI;IAM7D;;;;;;;;;;;;;OAaG;IACG,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5C;;OAEG;IACH,QAAQ,IAAI,IAAI,EAAE;CAGnB;AAGD,YAAY,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/session.ts"],"names":[],"mappings":"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"}

package/dist/{tool-execution-helpers-IVUDHXMK.js → tool-execution-helpers-RRMGLAHR.js}

@@ -1,23 +1,29 @@
 import {
+  VALID_LOG_LEVELS,
   createElicitMethod,
   createEnhancedContext,
   createReportProgressMethod,
   createSampleMethod,
   findSessionContext,
+  isValidLogLevel,
   parseElicitParams,
   sendProgressNotification,
+  shouldLogMessage,
   withTimeout
-} from "./chunk-KHTTBIRP.js";
+} from "./chunk-Q3PFK7Y4.js";
 import "./chunk-KUEVOU4M.js";
 import "./chunk-MTHLLDCX.js";
 import "./chunk-3GQAWCBQ.js";
 export {
+  VALID_LOG_LEVELS,
   createElicitMethod,
   createEnhancedContext,
   createReportProgressMethod,
   createSampleMethod,
   findSessionContext,
+  isValidLogLevel,
   parseElicitParams,
   sendProgressNotification,
+  shouldLogMessage,
   withTimeout
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mcp-use",
   "type": "module",
-  "version": "1.9.1-canary.0",
+  "version": "1.10.0-canary.2",
   "description": "Opinionated MCP Framework for TypeScript (@modelcontextprotocol/sdk compatible) - Build MCP Agents, Clients and Servers with support for ChatGPT Apps, Code Mode, OAuth, Notifications, Sampling, Observability and more.",
   "author": "mcp-use, Inc.",
   "license": "MIT",
@@ -113,8 +113,8 @@
     "posthog-node": "^5.14.1",
     "ws": "^8.18.3",
     "zod": "^4.1.13",
-    "@mcp-use/cli": "2.4.9-canary.0",
-    "@mcp-use/inspector": "0.11.1-canary.0"
+    "@mcp-use/cli": "2.5.0-canary.2",
+    "@mcp-use/inspector": "0.12.0-canary.2"
   },
   "optionalDependencies": {
     "chalk": "^5.6.2",