sublime-mcp 1.9.0 → 1.11.0

package/fallback-tools.json

@@ -3,7 +3,7 @@
   "tools": [
     {
       "name": "add_directory",
-      "description": "Opens an OS dialog box to prompt for a folder to the 'Where' field in the 'Find in Files' panel. (WindowCommand) Opens a native OS dialog that blocks Sublime Text until it is dismissed.",
+      "description": "Opens an OS dialog box to prompt for a folder to the 'Where' field in the 'Find in Files' panel. (WindowCommand)",
       "inputSchema": {
         "type": "object",
         "properties": {}
@@ -67,7 +67,7 @@
     },
     {
       "name": "add_word",
-      "description": "Adds the given word to the 'added_words' setting in the user preferences. (TextCommand)",
+      "description": "Adds the given word to the 'added_words' setting in the user preferences. (TextCommand) Observed on Sublime Text 4215: writes Sublime Text settings.",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -112,7 +112,7 @@
     },
     {
       "name": "auto_complete",
-      "description": "Shows the auto completion popup. (TextCommand)",
+      "description": "Shows the auto completion popup. (TextCommand) Observed on Sublime Text 4215: shows an in-app panel, popup or overlay (dismiss with hide_overlay, hide_panel or hide_popup).",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -210,7 +210,7 @@
     },
     {
       "name": "build",
-      "description": "Executes the provided build system or prompt for selection (select: true) and choose a default. build_system should be a resource path to a build system file or the name of a project-specific build system. (WindowCommand)",
+      "description": "Executes the provided build system or prompt for selection (select: true) and choose a default. build_system should be a resource path to a build system file or the name of a project-specific build system. (WindowCommand) Observed on Sublime Text 4215: when given arguments: shows an in-app panel, popup or overlay (dismiss with hide_overlay, hide_panel or hide_popup).",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -533,7 +533,7 @@
     },
     {
       "name": "close_window",
-      "description": "Closes the active window. (WindowCommand) Warning: closes the active window (unsaved buffers may prompt).",
+      "description": "Closes the active window. (WindowCommand) Observed on Sublime Text 4215: quits Sublime Text (which also stops this MCP server).",
       "inputSchema": {
         "type": "object",
         "properties": {}
@@ -570,7 +570,7 @@
     },
     {
       "name": "context_menu",
-      "description": "Shows the context menu for the current view. (WindowCommand)",
+      "description": "Shows the context menu for the current view. (WindowCommand) Observed on Sublime Text 4215: opens a native OS window (\"native menu\") that blocks Sublime's main thread until a person dismisses it.",
       "inputSchema": {
         "type": "object",
         "properties": {}
@@ -623,7 +623,7 @@
     },
     {
       "name": "copy_as_html",
-      "description": "Copies the contents of the current view as rich HTML to the system clipboard. (TextCommand)",
+      "description": "Copies the contents of the current view as rich HTML to the system clipboard. (TextCommand) Observed on Sublime Text 4215: changes the clipboard.",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -691,7 +691,7 @@
     },
     {
       "name": "decrease_font_size",
-      "description": "Increases the global font size. (ApplicationCommand)",
+      "description": "Increases the global font size. (ApplicationCommand) Observed on Sublime Text 4215: writes Sublime Text settings.",
       "inputSchema": {
         "type": "object",
         "properties": {}
@@ -699,7 +699,7 @@
     },
     {
       "name": "delete_file",
-      "description": "Deletes the given file(s) by moving the file(s) to the system trash/recycle bin. (WindowCommand) Warning: moves the file(s) to the recycle bin.",
+      "description": "Deletes the given file(s) by moving the file(s) to the system trash/recycle bin. (WindowCommand) Observed on Sublime Text 4215: when given arguments: opens a native OS window (\"Delete File\") that blocks Sublime's main thread until a person dismisses it.",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -716,7 +716,7 @@
     },
     {
       "name": "delete_folder",
-      "description": "Deletes the given folder(s) by moving the folder(s) to the system trash bin. (WindowCommand) Warning: moves the folder(s) to the recycle bin.",
+      "description": "Deletes the given folder(s) by moving the folder(s) to the system trash bin. (WindowCommand) Observed on Sublime Text 4215: when given arguments: opens a native OS window (\"Delete Folder\") that blocks Sublime's main thread until a person dismisses it.",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -774,22 +774,50 @@
     },
     {
       "name": "discover_tools",
-      "description": "Search advanced Sublime capabilities hidden from the default tool surface. Returns matching names, descriptions, and schemas. Invoke a result through batch(calls=[{tool: <name>, args: {...}}]), including for a single call.",
+      "description": "Find advanced Sublime tools hidden from the default tool surface. With no arguments it lists the top-level categories; category=<path> opens a category (then a subcategory, which lists its tools with schemas); query=<words> searches all tools. Invoke a result through batch(calls=[{tool: <name>, args: {...}}]), including for a single call.",
       "inputSchema": {
         "type": "object",
         "properties": {
+          "category": {
+            "type": "string",
+            "description": "Category path, such as editing or editing/lines. Empty lists the categories."
+          },
           "query": {
             "type": "string",
-            "description": "Capability to find, such as bookmarks, tabs, syntax, or commands."
+            "description": "Words to search for, such as bookmarks, tabs, syntax, or commands."
           },
           "limit": {
             "type": "integer",
             "default": 10
           }
-        },
-        "required": [
-          "query"
-        ]
+        }
+      }
+    },
+    {
+      "name": "dismiss_native_window",
+      "description": "Dismiss a native dialog or menu of this Sublime Text process (Windows only), even while it has blocked Sublime's main thread. action: 'cancel' (default; clicks Cancel/No or closes), 'ok' (clicks OK/Yes/the default button), 'button' (click the button named in 'button') or 'close'. hwnd defaults to the first dialog, then the first menu; take it from list_native_windows. Acts only on windows of the Sublime Text process. 'ok' clicks OK/Yes/the default button.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "hwnd": {
+            "type": "integer",
+            "description": "Window handle from list_native_windows (default: first dialog, then first menu)."
+          },
+          "action": {
+            "type": "string",
+            "enum": [
+              "cancel",
+              "ok",
+              "button",
+              "close"
+            ],
+            "description": "What to do (default: cancel)."
+          },
+          "button": {
+            "type": "string",
+            "description": "Button label for action 'button' (ignores case and & mnemonics)."
+          }
+        }
       }
     },
     {
@@ -951,7 +979,7 @@
     },
     {
       "name": "exit",
-      "description": "Closes all windows and exists the application. (ApplicationCommand) Warning: quits Sublime Text, which also stops this MCP server.",
+      "description": "Closes all windows and exists the application. (ApplicationCommand) Observed on Sublime Text 4215: quits Sublime Text (which also stops this MCP server).",
       "inputSchema": {
         "type": "object",
         "properties": {}
@@ -1879,7 +1907,7 @@
     },
     {
       "name": "hot_exit",
-      "description": "Saves the session and exits the application even if the 'hot_exit' setting is disabled in preferences. (ApplicationCommand) Warning: quits Sublime Text, which also stops this MCP server.",
+      "description": "Saves the session and exits the application even if the 'hot_exit' setting is disabled in preferences. (ApplicationCommand) Observed on Sublime Text 4215: quits Sublime Text (which also stops this MCP server).",
       "inputSchema": {
         "type": "object",
         "properties": {}
@@ -1895,7 +1923,7 @@
     },
     {
       "name": "ignore_word",
-      "description": "Adds the given word to the ignored_words setting. (TextCommand)",
+      "description": "Adds the given word to the ignored_words setting. (TextCommand) Observed on Sublime Text 4215: writes Sublime Text settings.",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -1908,7 +1936,7 @@
     },
     {
       "name": "increase_font_size",
-      "description": "Increases the global font size. (ApplicationCommand)",
+      "description": "Increases the global font size. (ApplicationCommand) Observed on Sublime Text 4215: writes Sublime Text settings.",
       "inputSchema": {
         "type": "object",
         "properties": {}
@@ -2016,6 +2044,14 @@
         "properties": {}
       }
     },
+    {
+      "name": "list_native_windows",
+      "description": "List the native OS windows, dialogs and menus of this Sublime Text process (Windows only): kind (dialog, menu, editor_window, window), title, hwnd, and for dialogs their buttons and message text. Works while a native dialog has BLOCKED Sublime's main thread (every other tool then times out); the result says whether the main thread is blocked and which tool blocked it.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {}
+      }
+    },
     {
       "name": "lookup_symbol",
       "description": "Find where a symbol is defined across all open files.",
@@ -2278,7 +2314,7 @@
     },
     {
       "name": "new_window",
-      "description": "Opens a new ST window. (ApplicationCommand)",
+      "description": "Opens a new ST window. (ApplicationCommand) Observed on Sublime Text 4215: opens a new Sublime Text window.",
       "inputSchema": {
         "type": "object",
         "properties": {}
@@ -2490,7 +2526,7 @@
     },
     {
       "name": "open_project_or_workspace",
-      "description": "Opens the specified project or workspace file, in a new window by default. (WindowCommand)",
+      "description": "Opens the specified project or workspace file, in a new window by default. (WindowCommand) Observed on Sublime Text 4215: when given arguments: opens a native OS window (\"Sublime Text\") that blocks Sublime's main thread until a person dismisses it; writes files.",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -2710,7 +2746,7 @@
     },
     {
       "name": "primary_j_changed",
-      "description": "Shows a dialog stating about the change of keybindings for the join_lines command. (WindowCommand)",
+      "description": "Shows a dialog stating about the change of keybindings for the join_lines command. (WindowCommand) Observed on Sublime Text 4215: opens a native OS window (\"Sublime Text\") that blocks Sublime's main thread until a person dismisses it.",
       "inputSchema": {
         "type": "object",
         "properties": {}
@@ -2777,7 +2813,7 @@
     },
     {
       "name": "prompt_add_folder",
-      "description": "Shows the OS native open dialog, so the user can choose what folder they want to add to the sidebar. (WindowCommand) Opens a native OS dialog that blocks Sublime Text until it is dismissed.",
+      "description": "Shows the OS native open dialog, so the user can choose what folder they want to add to the sidebar. (WindowCommand) Observed on Sublime Text 4215: opens a native OS window (\"Select Folder\") that blocks Sublime's main thread until a person dismisses it.",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -2798,7 +2834,7 @@
     },
     {
       "name": "prompt_open",
-      "description": "Shows the MacOS native open dialog, so that the user can choose what file they want to open. (WindowCommand) Opens a native OS dialog that blocks Sublime Text until it is dismissed.",
+      "description": "Shows the MacOS native open dialog, so that the user can choose what file they want to open. (WindowCommand) Observed on Sublime Text 4215: shows an in-app panel, popup or overlay (dismiss with hide_overlay, hide_panel or hide_popup).",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -2811,7 +2847,7 @@
     },
     {
       "name": "prompt_open_file",
-      "description": "Shows the OS native open dialog, so that the user can choose what file they want to open. (WindowCommand) Opens a native OS dialog that blocks Sublime Text until it is dismissed.",
+      "description": "Shows the OS native open dialog, so that the user can choose what file they want to open. (WindowCommand) Observed on Sublime Text 4215: opens a native OS window (\"Open\") that blocks Sublime's main thread until a person dismisses it.",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -2824,7 +2860,7 @@
     },
     {
       "name": "prompt_open_folder",
-      "description": "Shows the OS native open dialog, so that the user can choose what folder they want to open. (WindowCommand) Opens a native OS dialog that blocks Sublime Text until it is dismissed.",
+      "description": "Shows the OS native open dialog, so that the user can choose what folder they want to open. (WindowCommand) Observed on Sublime Text 4215: opens a native OS window (\"Select Folder\") that blocks Sublime's main thread until a person dismisses it.",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -2837,7 +2873,7 @@
     },
     {
       "name": "prompt_open_project_or_workspace",
-      "description": "Show the OS' native open dialog, so the user can choose what project they want to open. (WindowCommand) Opens a native OS dialog that blocks Sublime Text until it is dismissed.",
+      "description": "Show the OS' native open dialog, so the user can choose what project they want to open. (WindowCommand) Observed on Sublime Text 4215: opens a native OS window (\"Open\") that blocks Sublime's main thread until a person dismisses it.",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -2850,7 +2886,7 @@
     },
     {
       "name": "prompt_save_as",
-      "description": "Show the OS native save as dialog, so the user can choose the path where they want the file to be saved. (WindowCommand) Opens a native OS dialog that blocks Sublime Text until it is dismissed.",
+      "description": "Show the OS native save as dialog, so the user can choose the path where they want the file to be saved. (WindowCommand) Observed on Sublime Text 4215: opens a native OS window (\"Save As\") that blocks Sublime's main thread until a person dismisses it.",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -2863,7 +2899,7 @@
     },
     {
       "name": "prompt_select_workspace",
-      "description": "Opens the Quick Switch Project window. (WindowCommand)",
+      "description": "Opens the Quick Switch Project window. (WindowCommand) Observed on Sublime Text 4215: opens a separate window (\"Switch Project\").",
       "inputSchema": {
         "type": "object",
         "properties": {}
@@ -2871,7 +2907,7 @@
     },
     {
       "name": "prompt_switch_project_or_workspace",
-      "description": "Show the OS native open dialog, so the user can choose what project they want to switch to. (WindowCommand) Opens a native OS dialog that blocks Sublime Text until it is dismissed.",
+      "description": "Show the OS native open dialog, so the user can choose what project they want to switch to. (WindowCommand) Observed on Sublime Text 4215: opens a native OS window (\"Open\") that blocks Sublime's main thread until a person dismisses it.",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -2884,7 +2920,7 @@
     },
     {
       "name": "purchase_license",
-      "description": "Navigates to the url https://www.sublimehq.com/store/text in the default browser to allow a user to purchase a license.. (ApplicationCommand)",
+      "description": "Navigates to the url https://www.sublimehq.com/store/text in the default browser to allow a user to purchase a license.. (ApplicationCommand) Observed on Sublime Text 4215: starts another program (msedge.exe).",
       "inputSchema": {
         "type": "object",
         "properties": {}
@@ -2954,7 +2990,7 @@
     },
     {
       "name": "remove_license",
-      "description": "Removes the license. This will cause Sublime Text/Merge to go into an unregistered state. (ApplicationCommand) Warning: unregisters Sublime Text.",
+      "description": "Removes the license. This will cause Sublime Text/Merge to go into an unregistered state. (ApplicationCommand) Observed on Sublime Text 4215: opens a native OS window (\"Remove license key?\") that blocks Sublime's main thread until a person dismisses it.",
       "inputSchema": {
         "type": "object",
         "properties": {}
@@ -2977,7 +3013,7 @@
     },
     {
       "name": "rename_path",
-      "description": "Renames the given file(s) on disk. (WindowCommand)",
+      "description": "Renames the given file(s) on disk. (WindowCommand) Observed on Sublime Text 4215: when given arguments: shows an in-app panel, popup or overlay (dismiss with hide_overlay, hide_panel or hide_popup).",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -3027,7 +3063,7 @@
     },
     {
       "name": "replace_completion_with_auto_complete",
-      "description": "Replaces the most recently inserted completion with the next result provided by the auto completion engine. (TextCommand)",
+      "description": "Replaces the most recently inserted completion with the next result provided by the auto completion engine. (TextCommand) Observed on Sublime Text 4215: shows an in-app panel, popup or overlay (dismiss with hide_overlay, hide_panel or hide_popup).",
       "inputSchema": {
         "type": "object",
         "properties": {}
@@ -3132,7 +3168,7 @@
     },
     {
       "name": "reset_font_size",
-      "description": "Resets the font size to the default value. (ApplicationCommand)",
+      "description": "Resets the font size to the default value. (ApplicationCommand) Observed on Sublime Text 4215: writes Sublime Text settings.",
       "inputSchema": {
         "type": "object",
         "properties": {}
@@ -3178,7 +3214,7 @@
     },
     {
       "name": "revert",
-      "description": "Reloads the file. (TextCommand) Warning: discards unsaved changes in the view.",
+      "description": "Reloads the file. (TextCommand)",
       "inputSchema": {
         "type": "object",
         "properties": {}
@@ -3194,7 +3230,7 @@
     },
     {
       "name": "revert_hunk",
-      "description": "Reverts a diff hunk. (TextCommand) Warning: discards the changes in the diff hunk.",
+      "description": "Reverts a diff hunk. (TextCommand)",
       "inputSchema": {
         "type": "object",
         "properties": {}
@@ -3202,7 +3238,7 @@
     },
     {
       "name": "revert_modification",
-      "description": "Reverts a single modification. (TextCommand) Warning: discards the modification.",
+      "description": "Reverts a single modification. (TextCommand)",
       "inputSchema": {
         "type": "object",
         "properties": {}
@@ -3307,7 +3343,7 @@
     },
     {
       "name": "save",
-      "description": "Saves the active view/document. (TextCommand)",
+      "description": "Saves the active view/document. (TextCommand) Observed on Sublime Text 4215: writes files.",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -3357,7 +3393,7 @@
     },
     {
       "name": "save_project_and_workspace_as",
-      "description": "Opens the OS dialog window to save the active project. (WindowCommand) Opens a native OS dialog that blocks Sublime Text until it is dismissed.",
+      "description": "Opens the OS dialog window to save the active project. (WindowCommand) Observed on Sublime Text 4215: opens a native OS window (\"Save As\") that blocks Sublime's main thread until a person dismisses it.",
       "inputSchema": {
         "type": "object",
         "properties": {}
@@ -3365,7 +3401,7 @@
     },
     {
       "name": "save_workspace_as",
-      "description": "Opens the OS dialog window to save the active workspace. (WindowCommand) Opens a native OS dialog that blocks Sublime Text until it is dismissed.",
+      "description": "Opens the OS dialog window to save the active workspace. (WindowCommand) Observed on Sublime Text 4215: opens a native OS window (\"Save As\") that blocks Sublime's main thread until a person dismisses it.",
       "inputSchema": {
         "type": "object",
         "properties": {}
@@ -3610,7 +3646,7 @@
     },
     {
       "name": "set_file_type",
-      "description": "Sets the syntax for the active view. (TextCommand)",
+      "description": "Sets the syntax for the active view. (TextCommand) Observed on Sublime Text 4215: when given arguments: opens a separate window (\"Sublime Text\").",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -3773,7 +3809,7 @@
     },
     {
       "name": "show_about_window",
-      "description": "Displays the about dialog. (ApplicationCommand)",
+      "description": "Displays the about dialog. (ApplicationCommand) Observed on Sublime Text 4215: opens a separate window (\"Sublime Text\").",
       "inputSchema": {
         "type": "object",
         "properties": {}
@@ -3789,7 +3825,7 @@
     },
     {
       "name": "show_changelog",
-      "description": "Displays the changelog dialog. (ApplicationCommand)",
+      "description": "Displays the changelog dialog. (ApplicationCommand) Observed on Sublime Text 4215: opens a separate window (\"Changelog\").",
       "inputSchema": {
         "type": "object",
         "properties": {}
@@ -3797,7 +3833,7 @@
     },
     {
       "name": "show_license_window",
-      "description": "Displays the license dialog. This will only work if you are running an unregistered copy of Sublime Text. (ApplicationCommand)",
+      "description": "Displays the license dialog. This will only work if you are running an unregistered copy of Sublime Text. (ApplicationCommand) Observed on Sublime Text 4215: opens a separate window (\"Enter License\").",
       "inputSchema": {
         "type": "object",
         "properties": {}
@@ -3818,7 +3854,7 @@
     },
     {
       "name": "show_progress_window",
-      "description": "Displays the indexing status dialog. (ApplicationCommand)",
+      "description": "Displays the indexing status dialog. (ApplicationCommand) Observed on Sublime Text 4215: opens a separate window (\"Indexing Status\").",
       "inputSchema": {
         "type": "object",
         "properties": {}
@@ -3961,7 +3997,7 @@
     },
     {
       "name": "sublime_merge_blame_file",
-      "description": "Git blame selected file(s) with Sublime Merge. (WindowCommand)",
+      "description": "Git blame selected file(s) with Sublime Merge. (WindowCommand) Observed on Sublime Text 4215: opens a native OS window (\"Sublime Merge Not Found\") that blocks Sublime's main thread until a person dismisses it.",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -3973,7 +4009,7 @@
     },
     {
       "name": "sublime_merge_file_history",
-      "description": "Show the history of the selected file(s) in Sublime Merge. (WindowCommand)",
+      "description": "Show the history of the selected file(s) in Sublime Merge. (WindowCommand) Observed on Sublime Text 4215: opens a native OS window (\"Sublime Merge Not Found\") that blocks Sublime's main thread until a person dismisses it.",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -4244,7 +4280,7 @@
     },
     {
       "name": "toggle_show_open_files",
-      "description": "Toggles the visibility of the list of open files in the sidebar. (WindowCommand)",
+      "description": "Toggles the visibility of the list of open files in the sidebar. (WindowCommand) Observed on Sublime Text 4215: shows an in-app panel, popup or overlay (dismiss with hide_overlay, hide_panel or hide_popup).",
       "inputSchema": {
         "type": "object",
         "properties": {}
@@ -4428,7 +4464,7 @@
     },
     {
       "name": "update_check",
-      "description": "Opens the update dialog box of Sublime Text. (ApplicationCommand)",
+      "description": "Opens the update dialog box of Sublime Text. (ApplicationCommand) Observed on Sublime Text 4215: opens a separate window (\"Update\").",
       "inputSchema": {
         "type": "object",
         "properties": {}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sublime-mcp",
-  "version": "1.9.0",
+  "version": "1.11.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": {