sublime-mcp 1.12.5 → 1.13.1

package/fallback-tools.json

@@ -4581,6 +4581,197 @@
         "properties": {}
       }
     },
+    {
+      "name": "ui_click",
+      "description": "Click in one window of this Sublime Text process (Windows only) with the REAL mouse, because Sublime draws its own editor, command palette and popups and ignores posted mouse messages. x, y are pixels in the picture ui_screenshot returns for the same window (top-left is 0, 0). Because it moves the pointer of the person at the computer for a moment, it is REFUSED unless they have been idle for min_idle_s seconds (default 8), and refused unless the target window is the one under that point (another window in front would take the click). The pointer is restored afterwards. To click inside an open popup menu or other native popup, pass that menu's own hwnd from list_native_windows (x, y then count from the menu's top-left corner; ui_screenshot of the menu hwnd shows it). Pass wait_idle_s to wait for a busy person instead of refusing. button: left (default) or right; double=true double-clicks. Prefer keys (ui_press_key), pick_quick_panel and editor commands when they can do the job.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "x": {
+            "type": "integer",
+            "description": "Pixels from the left edge of the window picture."
+          },
+          "y": {
+            "type": "integer",
+            "description": "Pixels from the top edge of the window picture."
+          },
+          "hwnd": {
+            "type": "integer",
+            "description": "Window handle from list_native_windows (default: first editor window)."
+          },
+          "button": {
+            "type": "string",
+            "enum": [
+              "left",
+              "right"
+            ],
+            "description": "Mouse button (default left)."
+          },
+          "double": {
+            "type": "boolean",
+            "description": "Double-click (default false)."
+          },
+          "min_idle_s": {
+            "type": "number",
+            "description": "Required seconds since the person last used the mouse or keyboard (default 8)."
+          },
+          "wait_idle_s": {
+            "type": "number",
+            "description": "Wait up to this many seconds (max 120) for the person to stop typing or moving the mouse before giving up (default 0 = refuse at once). Use it instead of retrying when they are busy."
+          },
+          "settle_ms": {
+            "type": "integer",
+            "description": "Milliseconds to wait after the click (default 250, max 5000)."
+          }
+        },
+        "required": [
+          "x",
+          "y"
+        ]
+      }
+    },
+    {
+      "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.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "x": {
+            "type": "integer",
+            "description": "Pixels from the left edge of the window picture."
+          },
+          "y": {
+            "type": "integer",
+            "description": "Pixels from the top edge of the window picture."
+          },
+          "hwnd": {
+            "type": "integer",
+            "description": "Window handle from list_native_windows (default: first editor window)."
+          },
+          "screenshot": {
+            "type": "boolean",
+            "description": "Take a picture while the pointer is there and return its path."
+          },
+          "dwell_ms": {
+            "type": "integer",
+            "description": "Milliseconds the pointer rests before the picture (default 900)."
+          },
+          "hold_ms": {
+            "type": "integer",
+            "description": "Extra milliseconds to keep the pointer there afterwards (default 0)."
+          },
+          "min_idle_s": {
+            "type": "number",
+            "description": "Required seconds since the person last used the mouse or keyboard (default 8)."
+          },
+          "wait_idle_s": {
+            "type": "number",
+            "description": "Wait up to this many seconds (max 120) for the person to stop typing or moving the mouse before giving up (default 0 = refuse at once). Use it instead of retrying when they are busy."
+          }
+        },
+        "required": [
+          "x",
+          "y"
+        ]
+      }
+    },
+    {
+      "name": "ui_press_key",
+      "description": "Send one key press to one window of this Sublime Text process (Windows only), for example Return in the command palette or Down in a quick panel. key: Return, Escape, Tab, Up, Down, Left, Right, Home, End, PageUp, PageDown, Delete, Backspace, Space, F1-F24, or a single character. mods: any of ctrl, shift, alt. method 'post' (default) posts the key to the window without moving focus; 'input' brings the window to the front, sends real input, then restores the previous foreground window. Only windows of Sublime Text itself accept input.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "key": {
+            "type": "string",
+            "description": "Key name or single character."
+          },
+          "mods": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "enum": [
+                "ctrl",
+                "shift",
+                "alt"
+              ]
+            },
+            "description": "Modifier keys held during the press."
+          },
+          "hwnd": {
+            "type": "integer",
+            "description": "Window handle from list_native_windows (default: first editor window)."
+          },
+          "method": {
+            "type": "string",
+            "enum": [
+              "post",
+              "input"
+            ],
+            "description": "post (default, no focus change, no modifier keys) or input (real keys, carry modifiers; needs the window in front and activates it with a real title-bar click only when the person is idle)."
+          },
+          "min_idle_s": {
+            "type": "number",
+            "description": "For method input: required seconds since the person last used the mouse or keyboard (default 8); real keys are never sent while they are typing."
+          },
+          "wait_idle_s": {
+            "type": "number",
+            "description": "Wait up to this many seconds (max 120) for the person to stop typing or moving the mouse before giving up (default 0 = refuse at once). Use it instead of retrying when they are busy."
+          },
+          "settle_ms": {
+            "type": "integer",
+            "description": "Milliseconds to wait after the key so it has been handled (default 150, max 5000)."
+          }
+        },
+        "required": [
+          "key"
+        ]
+      }
+    },
+    {
+      "name": "ui_screenshot",
+      "description": "Take a picture of one window of this Sublime Text process (Windows only). The PNG is saved to a file and its path is returned (open it with the Read tool); inline=true returns the image itself. Works for a window that is behind others or not focused, and for dialogs. hwnd comes from list_native_windows (default: the first editor window). Only windows of Sublime Text itself can be captured, never another program.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "hwnd": {
+            "type": "integer",
+            "description": "Window handle from list_native_windows (default: first editor window)."
+          },
+          "inline": {
+            "type": "boolean",
+            "description": "Return the image itself instead of a file path (default false)."
+          },
+          "settle_ms": {
+            "type": "integer",
+            "description": "Milliseconds to wait before the picture so earlier input has been handled (default 200, max 5000)."
+          }
+        }
+      }
+    },
+    {
+      "name": "ui_type_text",
+      "description": "Type text into one window of this Sublime Text process (Windows only), for example into the command palette's search box or a quick panel's filter, without moving focus. A newline is sent as Return. At most 2000 characters per call. Only windows of Sublime Text itself accept input.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "text": {
+            "type": "string",
+            "description": "The text to type."
+          },
+          "settle_ms": {
+            "type": "integer",
+            "description": "Milliseconds to wait after typing so it has been handled (default 150, max 5000)."
+          },
+          "hwnd": {
+            "type": "integer",
+            "description": "Window handle from list_native_windows (default: first editor window)."
+          }
+        },
+        "required": [
+          "text"
+        ]
+      }
+    },
     {
       "name": "undo",
       "description": "Undo the last edit in the active file.",

package/package.json

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