sublime-mcp 1.12.3 → 1.12.5

package/fallback-tools.json

@@ -434,13 +434,21 @@
     },
     {
       "name": "close_file",
-      "description": "Close a file by path, or close the active file if path is omitted. Routed through Sublime's real close command (not a direct API call), so a host-side close-blocking hook gets a chance to run -- e.g. GhostShell's ai_terminal package refuses this outright (no dialog, just a no-op) for any ai_terminal tab, so calling this on one does nothing rather than closing it. Only ever targets an already-open view found by path or the current active view -- it cannot target an unsaved/path-less tab (like an ai_terminal tab) by index; do not call this expecting it to close 'whatever tab you mean' when no path resolves.",
+      "description": "Close a file by path, or close the active file if path is omitted. Routed through Sublime's real close command (not a direct API call), so a host-side close-blocking hook gets a chance to run -- e.g. GhostShell's ai_terminal package refuses this outright (no dialog, just a no-op) for any ai_terminal tab, so calling this on one does nothing rather than closing it. Only ever targets an already-open view found by path, by name or index, or the current active view. Pass path for a saved file. For a tab with no path (unsaved buffer, scratch view) pass name (partial, case-insensitive match on the tab's title) or index (0-based, from get_open_files); with none of the three it closes whichever tab is active, so name the tab you mean. A name or index that matches nothing is an error and closes nothing. (run_command 'close' with scope='view' does not close a tab: use this tool.)",
       "inputSchema": {
         "type": "object",
         "properties": {
           "path": {
             "type": "string",
             "default": ""
+          },
+          "name": {
+            "type": "string",
+            "default": ""
+          },
+          "index": {
+            "type": "integer",
+            "default": -1
           }
         }
       }
@@ -1726,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)."
           }
         }
       }
@@ -1811,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."
+          }
+        }
       }
     },
     {
@@ -1898,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.",
@@ -2604,7 +2642,7 @@
     },
     {
       "name": "open_folder",
-      "description": "Open a folder in a new window (WindowCommand). Pass 'path' in args.",
+      "description": "Open a folder in a NEW window (makes the window and sets the folder as its project data; returns window_id and folders). Pass 'path' (an existing folder).",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -2778,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."
           }
         }
       }
@@ -3421,7 +3463,7 @@
     },
     {
       "name": "run_command",
-      "description": "Run any Sublime Text command. scope='window' (default) or 'view'.\nFor scope='view'/'text', optionally target a specific tab with name (partial, case-insensitive) or index (0-based, from get_open_files) instead of whatever tab happens to be globally focused -- important when another agent/session may be sharing this Sublime instance.",
+      "description": "Run any Sublime Text command. scope='window' (default) or 'view'.\nFor scope='view'/'text', optionally target a specific tab with name (partial, case-insensitive) or index (0-based, from get_open_files) instead of whatever tab happens to be globally focused -- important when another agent/session may be sharing this Sublime instance.\nok means the command was dispatched, not that it did anything: a command that opens a dialog often does so a moment after this returns. Pass settle_ms (for example 300) to wait up to that long and get any dialog that appeared in the result as 'dialogs' (Windows; same fields as list_native_windows).",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -3442,6 +3484,10 @@
           "index": {
             "type": "integer",
             "default": -1
+          },
+          "settle_ms": {
+            "type": "integer",
+            "default": 0
           }
         },
         "required": [

package/package.json

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