sublime-mcp 1.6.0 → 1.7.2

package/fallback-tools.json

@@ -1,5 +1,5 @@
 {
-  "_comment": "GENERATED FILE - do not edit. Produced by tools/generate_fallback_catalog.py from packages/st-plugin/sublime_mcp.py::_MCP_TOOLS. Regenerate after changing the backend tool catalog.",
+  "_comment": "GENERATED FILE - do not edit. Produced by tools/generate_fallback_catalog.py from sublime_mcp.py::_MCP_TOOLS. Regenerate after changing the backend tool catalog.",
   "tools": [
     {
       "name": "add_folder",
@@ -272,6 +272,14 @@
         "properties": {}
       }
     },
+    {
+      "name": "diagnostics",
+      "description": "One-call plugin health snapshot: main-thread heartbeat freshness (and a likely_wedged flag), the currently in-flight _on_main dispatch (if any) with its label and running time, open IDE-companion diff reviews, on_activated/on_load/on_post_save/on_selection_modified/on_close event counts (total vs. suppressed as agent-caused), console-capture buffer size, and a live main-thread stack trace. Answers 'wedged vs slow vs fine' without needing the main thread's cooperation -- use this before assuming a timeout means the server is dead.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {}
+      }
+    },
     {
       "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.",
@@ -888,7 +896,7 @@
     },
     {
       "name": "get_package_mcp_info",
-      "description": "Return everything needed to write an MCP extension for an installed Package Control package.\nReturns: path, output_file, commands (with captions and args), settings_keys, python_files, extension_template.\nWrite the extension to output_file following extension_template; ST loads it automatically.",
+      "description": "Discover what an installed Sublime package can do, then just control it directly --\nno separate MCP server needed. Primary workflow: call this for the package name, Read\nthe files it lists under python_files to find the package's real command-dispatch table\nand settings (this tool's own commands/settings_keys are a starting point, not the full\npicture -- a package that routes many actions through one command with an 'action' arg,\nfor example, only shows up here as that one wrapper command), then call the real thing\nwith run_command or eval_python. That loop -- discover, read source, call directly -- is\nalmost always enough on its own.\nReturns: path, commands (with captions and args), settings_keys, python_files, plus\noutput_file/extension_template for the rarer case where a standing, independently-\nreachable MCP server is actually needed (e.g. a client with no eval_python-equivalent of\nits own) -- write the extension to output_file following extension_template and ST loads\nit automatically; see the package-mcp-generator skill for that heavier path.",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -1266,6 +1274,14 @@
         "properties": {}
       }
     },
+    {
+      "name": "main_thread_stack",
+      "description": "Return ST's main thread's current Python stack trace right now, read directly via sys._current_frames() from whichever thread handles this request. Works even while the main thread is wedged, since it needs no cooperation from it -- use this to see exactly what a stuck call is doing instead of guessing from symptoms.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {}
+      }
+    },
     {
       "name": "move_line_down",
       "description": "Move the current line(s) down by one line.",
@@ -1933,7 +1949,7 @@
     },
     {
       "name": "run_command",
-      "description": "Run any Sublime Text command. scope='window' (default) or 'view'.",
+      "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.",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -1946,6 +1962,14 @@
           "scope": {
             "type": "string",
             "default": "window"
+          },
+          "name": {
+            "type": "string",
+            "default": ""
+          },
+          "index": {
+            "type": "integer",
+            "default": -1
           }
         },
         "required": [

package/package.json

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