sublime-mcp 1.13.6 → 1.13.8

package/fallback-tools.json

@@ -4652,7 +4652,7 @@
     },
     {
       "name": "ui_hover",
-      "description": "Hold the REAL mouse pointer over a point of one window of this Sublime Text process (Windows only) so hover popups and tooltips appear, optionally taking a picture while it is there (screenshot=true saves it and returns the path), then put the pointer back. x, y are pixels in the picture ui_screenshot returns. Same safety gates as ui_click: refused unless the person at the computer has been idle for min_idle_s seconds (default 8) and the target window is the one under that point. dwell_ms (default 900, max 5000) is how long to wait before the picture.",
+      "description": "Hold the REAL mouse pointer over a point of one window of this Sublime Text process (Windows only) so hover popups and tooltips appear, optionally taking a picture while it is there (screenshot=true returns the picture itself, image first; inline=false saves it and returns the path; region, scale and max_width work as in ui_screenshot, so a small popup can be cropped and zoomed), then put the pointer back. x, y are pixels in the picture ui_screenshot returns. Same safety gates as ui_click: refused unless the person at the computer has been idle for min_idle_s seconds (default 8) and the target window is the one under that point. dwell_ms (default 900, max 5000) is how long to wait before the picture; a language-server hover (LSP) can take a few seconds to appear, so use 3000 to 5000 for those (tried: a 4500 ms dwell over a Python symbol showed the pyright popup).",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -4670,7 +4670,37 @@
           },
           "screenshot": {
             "type": "boolean",
-            "description": "Take a picture while the pointer is there and return its path."
+            "description": "Take a picture while the pointer is there and return it (the image itself unless inline=false)."
+          },
+          "inline": {
+            "type": "boolean",
+            "description": "With screenshot: return the image itself (default true); false saves a file and returns its path."
+          },
+          "region": {
+            "type": "object",
+            "description": "With screenshot: only this part of the window picture: {x, y, width, height} in pixels.",
+            "properties": {
+              "x": {
+                "type": "integer"
+              },
+              "y": {
+                "type": "integer"
+              },
+              "width": {
+                "type": "integer"
+              },
+              "height": {
+                "type": "integer"
+              }
+            }
+          },
+          "scale": {
+            "type": "number",
+            "description": "With screenshot: resize factor (2 doubles the picture)."
+          },
+          "max_width": {
+            "type": "integer",
+            "description": "With screenshot: shrink the picture to at most this many pixels wide."
           },
           "dwell_ms": {
             "type": "integer",
@@ -4749,7 +4779,7 @@
     },
     {
       "name": "ui_screenshot",
-      "description": "Take a picture of one window of this Sublime Text process (Windows only). Returns the image itself as an image block, first in the reply, followed by one text block with the size and what was captured. Works for a window that is behind others or not focused, and for dialogs. Choose the window with window_title (part of its title; an unmatched title lists the windows) or hwnd from list_native_windows; default is the first editor window. tab shows one tab for the picture (part of its name, or its 0-based index in the active window) and puts the tab that was in front back afterwards: use it to see a tab that is not in front. region crops, scale zooms (2 doubles the size, to read small text) and max_width shrinks. save_dir (an absolute folder) also keeps the PNG in a dated subfolder and reports saved_path. inline=false returns only a file path. Only windows of Sublime Text itself can be captured, never another program.",
+      "description": "Take a picture of one window of this Sublime Text process (Windows only). Returns the image itself as an image block, first in the reply, followed by one text block with the size and what was captured. Works for a window that is behind others or not focused, and for dialogs. Choose the window with window_title (part of its title; an unmatched title lists the windows), kind ('dialog' or 'menu' for an open native dialog or menu) or hwnd from list_native_windows; default is the first editor window, and a dialog or menu open in front of it is then listed in the reply as open_popups_not_in_picture. tab shows one tab for the picture (part of its name, or its 0-based index in the active window) and puts the tab that was in front back afterwards: use it to see a tab that is not in front. region crops, scale zooms (2 doubles the size, to read small text) and max_width shrinks. save_dir (an absolute folder) also keeps the PNG in a dated subfolder and reports saved_path. inline=false returns only a file path. Only windows of Sublime Text itself can be captured, never another program.",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -4761,6 +4791,17 @@
             "type": "string",
             "description": "Capture the window whose title contains this text (case-insensitive), instead of giving hwnd."
           },
+          "kind": {
+            "type": "string",
+            "enum": [
+              "editor_window",
+              "dialog",
+              "menu",
+              "window",
+              "other"
+            ],
+            "description": "Capture the first window of this kind, for example 'dialog' for a native dialog that is open or 'menu' for an open menu (menus have no title). Combine with window_title to narrow it. When a dialog or menu is open and you name no window, the reply lists them as open_popups_not_in_picture."
+          },
           "tab": {
             "type": "string",
             "description": "Show this tab for the picture: part of its name, or digits for its 0-based index in the active window (for example '1'). The tab that was in front is restored."

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sublime-mcp",
-  "version": "1.13.6",
+  "version": "1.13.8",
   "description": "MCP server for Sublime Text 4 — exposes editor state and editing tools to AI assistants via the Model Context Protocol.",
   "type": "module",
   "bin": {