sublime-mcp 1.12.4 → 1.13.0

package/fallback-tools.json

@@ -1734,6 +1734,10 @@
           "offset": {
             "type": "integer",
             "description": "Skip this many matching items (default 0)."
+          },
+          "wait_ms": {
+            "type": "integer",
+            "description": "Wait up to this long (at most 60000) for the panel to appear; use 15000 for Package Control's Install Package list, which loads for a while after Enter (default 0 = no waiting)."
           }
         }
       }
@@ -1819,10 +1823,16 @@
     },
     {
       "name": "get_sheets",
-      "description": "List ALL sheets (tabs) in the current window by index, including images and untitled buffers.\nReturns identity, group position, selection/focus state, type, path, name, and dirty state.\nUse index with get_sheet_content to read a specific tab.",
+      "description": "List ALL sheets (tabs) in the current window by index, including images and untitled buffers.\nReturns identity, group position, selection/focus state, type, path, name, and dirty state.\nUse index with get_sheet_content to read a specific tab.\nEvery tab also carries its full settings (over 100 keys); pass settings=false to leave them out.",
       "inputSchema": {
         "type": "object",
-        "properties": {}
+        "properties": {
+          "settings": {
+            "type": "boolean",
+            "default": true,
+            "description": "Include each tab's full settings dict (default true). false gives a compact list."
+          }
+        }
       }
     },
     {
@@ -1906,6 +1916,26 @@
         }
       }
     },
+    {
+      "name": "get_view_regions",
+      "description": "Return the regions a plugin stored in a view under a region key (view.add_regions): begin, end and the first 80 characters of each. Sublime cannot list the keys, so name them: one key or several separated by commas (for example 'ifdef,ifdeferror' for the Simple Ifdef package). Use it to check what a highlighting plugin drew without a screenshot. Omit name for the active view.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "key": {
+            "type": "string",
+            "description": "Region key, or several separated by commas."
+          },
+          "name": {
+            "type": "string",
+            "default": ""
+          }
+        },
+        "required": [
+          "key"
+        ]
+      }
+    },
     {
       "name": "get_view_size",
       "description": "Return the total character count of any open tab by name (partial match, case-insensitive).\nUse before get_view_chars to compute offsets. Omit name for the active view.",
@@ -2786,6 +2816,10 @@
           "text": {
             "type": "string",
             "description": "Text of the item to pick."
+          },
+          "wait_ms": {
+            "type": "integer",
+            "description": "Wait up to this long (at most 60000) for the panel to appear (15000 for the Install Package list); default 0."
           }
         }
       }
@@ -4547,6 +4581,185 @@
         "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. 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)."
+          },
+          "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)."
+          }
+        },
+        "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)."
+          },
+          "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.4",
+  "version": "1.13.0",
   "description": "MCP server for Sublime Text 4 — exposes editor state and editing tools to AI assistants via the Model Context Protocol.",
   "type": "module",
   "bin": {