sublime-mcp 1.13.0 → 1.13.2

package/fallback-tools.json

@@ -434,7 +434,7 @@
     },
     {
       "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, 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.)",
+      "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. A tab with unsaved edits normally raises Sublime's native \"Save Changes?\" dialog, which blocks the main thread until someone answers it; pass discard=true to throw the unsaved edits away and close at once (the result then says discarded). (run_command 'close' with scope='view' does not close a tab: use this tool.)",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -449,6 +449,11 @@
           "index": {
             "type": "integer",
             "default": -1
+          },
+          "discard": {
+            "type": "boolean",
+            "default": false,
+            "description": "Close without saving: unsaved edits are lost. Default false (Sublime asks)."
           }
         }
       }
@@ -4583,7 +4588,7 @@
     },
     {
       "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.",
+      "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": {
@@ -4615,6 +4620,10 @@
             "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)."
@@ -4659,6 +4668,10 @@
           "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": [
@@ -4703,7 +4716,11 @@
           },
           "min_idle_s": {
             "type": "number",
-            "description": "For method input: required seconds since the person last used the mouse or keyboard (default 8)."
+            "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",

package/package.json

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