sublime-mcp 1.12.2 → 1.12.4

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
           }
         }
       }
@@ -1663,13 +1671,17 @@
     },
     {
       "name": "get_output_panel",
-      "description": "Return the text content of an output panel.\nIf name is omitted, read the active output panel. Use name='exec' for build output.\nUse name='Console' to read Sublime's built-in console through the best available backend.",
+      "description": "Return the text content of an output panel.\nIf name is omitted, read the active output panel. Use name='exec' for build output.\nUse name='Console' to read Sublime's built-in console through the best available backend; for the console, force_focus=true raises the window first (needed for a complete read when the window is not in front; can crash a portable Sublime Text).",
       "inputSchema": {
         "type": "object",
         "properties": {
           "name": {
             "type": "string",
             "default": ""
+          },
+          "force_focus": {
+            "type": "boolean",
+            "default": false
           }
         }
       }
@@ -2600,7 +2612,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": {
@@ -3417,7 +3429,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": {
@@ -3438,6 +3450,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.2",
+  "version": "1.12.4",
   "description": "MCP server for Sublime Text 4 — exposes editor state and editing tools to AI assistants via the Model Context Protocol.",
   "type": "module",
   "bin": {