@mcp-use/client 2.0.2-canary.2 → 2.1.0-canary.3

package/dist/react/index.d.ts

@@ -8,6 +8,8 @@
 export type { UseMcpOptions, UseMcpResult, ReconnectionOptions, McpServer, McpServerConfig, 
 /** @deprecated Use McpServerConfig */
 McpServerOptions, PersistedMcpServerConfig, McpNotification, PendingSamplingRequest, PendingElicitationRequest, } from "./types.js";
+export type { Skill, SkillDirectoryEntry, SkillDirectoryReadResult, SkillGetResult, SkillResource, SkillsListResult, } from "../core/skills.js";
+export { SKILLS_EXTENSION_ID } from "../core/skills.js";
 export { pickPersistedServerConfig, toPersistedServerConfig } from "./types.js";
 export { useMcp } from "./useMcp.js";
 export { detectFavicon } from "../utils/favicon.js";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,YAAY,EACV,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,SAAS,EACT,eAAe;AACf,sCAAsC;AACtC,gBAAgB,EAChB,wBAAwB,EACxB,eAAe,EACf,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,yBAAyB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAChF,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAGzD,OAAO,EACL,GAAG,EACH,SAAS,EACT,kBAAkB,GACnB,MAAM,mCAAmC,CAAC;AAG3C,YAAY,EACV,cAAc,EACd,YAAY,EACZ,uBAAuB,EACvB,sBAAsB,EACtB,YAAY,EACZ,eAAe,EACf,cAAc,EACd,MAAM,EACN,kBAAkB,EAClB,QAAQ,EACR,oBAAoB,EACpB,IAAI,EACJ,SAAS,GACV,MAAM,8BAA8B,CAAC;AACtC,YAAY,EACV,2BAA2B,EAC3B,2BAA2B,GAC5B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EACV,2BAA2B,EAC3B,2BAA2B,EAC5B,MAAM,mBAAmB,CAAC;AAC3B,sDAAsD;AACtD,MAAM,MAAM,4BAA4B,GAAG;IACzC,4BAA4B;IAC5B,MAAM,EAAE,wBAAwB,CAAC;IACjC,mCAAmC;IACnC,MAAM,EAAE,2BAA2B,CAAC;CACrC,CAAC;AACF,4DAA4D;AAC5D,YAAY,EAAE,4BAA4B,IAAI,oBAAoB,EAAE,CAAC;AACrE,2DAA2D;AAC3D,YAAY,EAAE,2BAA2B,IAAI,mBAAmB,EAAE,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAG/D,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,YAAY,GACb,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,KAAK,oBAAoB,EACzB,KAAK,eAAe,GACrB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,UAAU,EACV,aAAa,EACb,kBAAkB,EAClB,YAAY,EACZ,KAAK,WAAW,GACjB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACd,UAAU,EACV,oBAAoB,EACpB,gBAAgB,EAChB,yBAAyB,EACzB,uBAAuB,EACvB,mBAAmB,EACnB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAC7B,KAAK,oCAAoC,GAC1C,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,YAAY,EACV,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,SAAS,EACT,eAAe;AACf,sCAAsC;AACtC,gBAAgB,EAChB,wBAAwB,EACxB,eAAe,EACf,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,KAAK,EACL,mBAAmB,EACnB,wBAAwB,EACxB,cAAc,EACd,aAAa,EACb,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,yBAAyB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAChF,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAGzD,OAAO,EACL,GAAG,EACH,SAAS,EACT,kBAAkB,GACnB,MAAM,mCAAmC,CAAC;AAG3C,YAAY,EACV,cAAc,EACd,YAAY,EACZ,uBAAuB,EACvB,sBAAsB,EACtB,YAAY,EACZ,eAAe,EACf,cAAc,EACd,MAAM,EACN,kBAAkB,EAClB,QAAQ,EACR,oBAAoB,EACpB,IAAI,EACJ,SAAS,GACV,MAAM,8BAA8B,CAAC;AACtC,YAAY,EACV,2BAA2B,EAC3B,2BAA2B,GAC5B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EACV,2BAA2B,EAC3B,2BAA2B,EAC5B,MAAM,mBAAmB,CAAC;AAC3B,sDAAsD;AACtD,MAAM,MAAM,4BAA4B,GAAG;IACzC,4BAA4B;IAC5B,MAAM,EAAE,wBAAwB,CAAC;IACjC,mCAAmC;IACnC,MAAM,EAAE,2BAA2B,CAAC;CACrC,CAAC;AACF,4DAA4D;AAC5D,YAAY,EAAE,4BAA4B,IAAI,oBAAoB,EAAE,CAAC;AACrE,2DAA2D;AAC3D,YAAY,EAAE,2BAA2B,IAAI,mBAAmB,EAAE,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAG/D,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,YAAY,GACb,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,KAAK,oBAAoB,EACzB,KAAK,eAAe,GACrB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,UAAU,EACV,aAAa,EACb,kBAAkB,EAClB,YAAY,EACZ,KAAK,WAAW,GACjB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACd,UAAU,EACV,oBAAoB,EACpB,gBAAgB,EAChB,yBAAyB,EACzB,uBAAuB,EACvB,mBAAmB,EACnB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAC7B,KAAK,oCAAoC,GAC1C,MAAM,wBAAwB,CAAC"}

package/dist/react/index.js

@@ -251,6 +251,9 @@ var init_rpc_logger = __esm({
   }
 });
 
+// src/core/skills.ts
+var SKILLS_EXTENSION_ID = "io.modelcontextprotocol/skills";
+
 // src/react/types.ts
 var PERSISTED_SERVER_CONFIG_KEYS = [
   "url",
@@ -444,7 +447,6 @@ function runAuthPopup({
 import { useCallback as useCallback2, useEffect, useMemo, useRef, useState } from "react";
 
 // src/transport/http.ts
-init_logging();
 import {
   Client,
   SdkError,
@@ -489,6 +491,9 @@ var DialectJsonSchemaValidator = class {
   }
 };
 
+// src/transport/http.ts
+init_logging();
+
 // src/transport/base.ts
 init_logging();
 
@@ -1291,7 +1296,7 @@ var HttpConnector = class extends BaseConnector {
       is401Error = status === 401;
       httpStatusCode = status;
       if (status === 400 && streamableErr.message.includes("Missing session ID")) {
-        fallbackReason = "Server requires session ID (FastMCP compatibility)";
+        fallbackReason = "Server requires session ID";
         logger.warn(`\u26A0\uFE0F  ${fallbackReason}`);
       } else if (status === 404 || status === 405) {
         fallbackReason = `Server returned ${status} - server likely doesn't support streamable HTTP`;
@@ -1307,7 +1312,7 @@ var HttpConnector = class extends BaseConnector {
       const errorMsg = err.message || "";
       is401Error = detectUnauthorized(err) || errorStr.includes("401") || errorMsg.includes("Unauthorized");
       if (errorStr.includes("Missing session ID") || errorStr.includes("Bad Request: Missing session ID") || errorMsg.includes("FastMCP session ID error")) {
-        fallbackReason = "Server requires session ID (FastMCP compatibility)";
+        fallbackReason = "Server requires session ID";
         logger.warn(`\u26A0\uFE0F  ${fallbackReason}`);
       } else if (errorStr.includes("405 Method Not Allowed") || errorStr.includes("404 Not Found")) {
         fallbackReason = "Server doesn't support streamable HTTP (405/404)";
@@ -1606,7 +1611,7 @@ var HttpConnector = class extends BaseConnector {
 };
 
 // src/utils/version.ts
-var VERSION = "2.0.2-canary.2";
+var VERSION = "2.1.0-canary.3";
 function getPackageVersion() {
   return VERSION;
 }
@@ -3688,6 +3693,48 @@ var MCPConnection = class {
   async request(method, params = null, options) {
     return this.connector.request(method, params, options);
   }
+  /** List one page of skills advertised through the experimental extension. */
+  async listSkills(cursor, options) {
+    return await this.request(
+      "skills/list",
+      cursor === void 0 ? {} : { cursor },
+      options
+    );
+  }
+  /** List the complete skill catalog, following pagination defensively. */
+  async listAllSkills(options) {
+    const skills = [];
+    const seenCursors = /* @__PURE__ */ new Set();
+    let cursor;
+    do {
+      const page = await this.listSkills(cursor, options);
+      skills.push(...Array.isArray(page.skills) ? page.skills : []);
+      cursor = page.nextCursor;
+      if (cursor !== void 0) {
+        if (seenCursors.has(cursor)) {
+          throw new Error("skills/list returned a repeated pagination cursor");
+        }
+        seenCursors.add(cursor);
+      }
+    } while (cursor !== void 0);
+    return { skills };
+  }
+  /** Get one skill by its canonical `SKILL.md` URI. */
+  async getSkill(uri, options) {
+    return await this.request(
+      "skills/get",
+      { uri },
+      options
+    );
+  }
+  /** Read one non-recursive skill directory. */
+  async readResourceDirectory(uri, cursor, options) {
+    return await this.request(
+      "resources/directory/read",
+      cursor === void 0 ? { uri } : { uri, cursor },
+      options
+    );
+  }
 };
 
 // src/telemetry/client-telemetry.ts
@@ -4648,6 +4695,28 @@ function useMcpOperations(params) {
     },
     [params.addLog]
   );
+  const listSkills = useCallback(async () => {
+    const connection = requireConnection(params, "list skills");
+    params.addLog("info", "Listing skills");
+    const result = await connection.listAllSkills();
+    params.setSkills(result.skills);
+  }, [params.addLog]);
+  const getSkill = useCallback(
+    async (uri) => {
+      const connection = requireConnection(params, "get skill");
+      params.addLog("info", `Getting skill: ${uri}`);
+      return connection.getSkill(uri);
+    },
+    [params.addLog]
+  );
+  const readResourceDirectory = useCallback(
+    async (uri, cursor) => {
+      const connection = requireConnection(params, "read resource directory");
+      params.addLog("info", `Reading resource directory: ${uri}`);
+      return connection.readResourceDirectory(uri, cursor);
+    },
+    [params.addLog]
+  );
   const listPrompts = useCallback(async () => {
     const connection = requireConnection(params, "list prompts");
     params.addLog("info", "Listing prompts");
@@ -4683,6 +4752,17 @@ function useMcpOperations(params) {
       params.addLog("warn", "Failed to refresh prompts:", error);
     }
   }, [params.addLog]);
+  const refreshSkills = useCallback(async () => {
+    if (params.stateRef.current !== "ready" || !params.connectionRef.current)
+      return;
+    try {
+      const result = await params.connectionRef.current.listAllSkills();
+      params.setSkills(result.skills);
+    } catch (error) {
+      params.setSkills([]);
+      params.addLog("debug", "Skills are unavailable after refresh:", error);
+    }
+  }, [params.addLog]);
   const refreshResourceTemplates = useCallback(async () => {
     const connection = requireConnection(params, "refresh resource templates");
     const result = await connection.listResourceTemplates();
@@ -4714,10 +4794,14 @@ function useMcpOperations(params) {
     callTool,
     listResources,
     readResource,
+    listSkills,
+    getSkill,
+    readResourceDirectory,
     listPrompts,
     refreshTools,
     refreshResources,
     refreshPrompts,
+    refreshSkills,
     refreshResourceTemplates,
     refreshAll,
     getPrompt,
@@ -4917,6 +5001,7 @@ function useMcp(options) {
   const [resources, setResources] = useState([]);
   const [resourceTemplates, setResourceTemplates] = useState([]);
   const [prompts, setPrompts] = useState([]);
+  const [skills, setSkills] = useState([]);
   const [serverInfo, setServerInfo] = useState(
     // Only use cached metadata if it has at least a name
     options._initialServerInfo?.name ? options._initialServerInfo : void 0
@@ -5023,6 +5108,7 @@ function useMcp(options) {
     setResources,
     setResourceTemplates,
     setPrompts,
+    setSkills,
     addLog
   });
   const disconnect = useCallback2(
@@ -5059,6 +5145,7 @@ function useMcp(options) {
         setResources([]);
         setResourceTemplates([]);
         setPrompts([]);
+        setSkills([]);
         setError(void 0);
         setAuthUrl(void 0);
         setAuthTokens(void 0);
@@ -5171,6 +5258,7 @@ function useMcp(options) {
     setResources([]);
     setResourceTemplates([]);
     setPrompts([]);
+    setSkills([]);
     setServerInfo(void 0);
     setCapabilities(void 0);
     setProtocolEra(void 0);
@@ -5300,7 +5388,13 @@ function useMcp(options) {
               );
             } else if (notification.method === "notifications/resources/list_changed") {
               addLog("info", "Resources list changed, auto-refreshing...");
-              connectionOperations.refreshResources().catch(
+              const clientInfoExtensions = mergedClientInfo.capabilities?.extensions;
+              const optionExtensions = effectiveClientOptions?.capabilities?.extensions;
+              const supportsSkills = optionExtensions?.[SKILLS_EXTENSION_ID] !== void 0 || clientInfoExtensions?.[SKILLS_EXTENSION_ID] !== void 0;
+              Promise.all([
+                connectionOperations.refreshResources(),
+                ...supportsSkills ? [connectionOperations.refreshSkills()] : []
+              ]).catch(
                 (err) => addLog("warn", "Auto-refresh resources failed:", err)
               );
             } else if (notification.method === "notifications/prompts/list_changed") {
@@ -5414,6 +5508,17 @@ function useMcp(options) {
           setProtocolVersion(protocolVersion2);
           setInstructions(instructions2);
           setExtensions(extensions2);
+          if (extensions2["io.modelcontextprotocol/skills"] !== void 0) {
+            try {
+              const result = await connection.listAllSkills();
+              if (isMountedRef.current) setSkills(result.skills);
+            } catch (error2) {
+              addLog("warn", "Failed to load initial skills:", error2);
+              if (isMountedRef.current) setSkills([]);
+            }
+          } else {
+            setSkills([]);
+          }
         }
         if (serverInfo2) {
           addLog("debug", "Server info:", serverInfo2);
@@ -6073,6 +6178,7 @@ function useMcp(options) {
     resources,
     resourceTemplates,
     prompts,
+    skills,
     serverInfo,
     capabilities,
     protocolEra,
@@ -8410,15 +8516,17 @@ function ViewRendererBase({
         });
         return;
       }
-      if (event.data?.type === "iframe-console-log" && onLogRef.current) {
-        onLogRef.current({
+      if (event.data?.type === "iframe-console-log") {
+        event.stopImmediatePropagation();
+        onLogRef.current?.({
           level: event.data.level ?? "log",
           data: event.data.args
         });
+        return;
       }
     };
-    window.addEventListener("message", handleMessage);
-    return () => window.removeEventListener("message", handleMessage);
+    window.addEventListener("message", handleMessage, true);
+    return () => window.removeEventListener("message", handleMessage, true);
   }, [sandboxOrigin, isBlobSandbox]);
   useEffect5(() => {
     if (!resolved || !activeSandboxUrl) return;
@@ -8866,6 +8974,7 @@ export {
   LocalStorageProvider,
   McpClientProvider,
   MemoryStorageProvider,
+  SKILLS_EXTENSION_ID,
   Tel,
   Telemetry,
   ViewRenderer,