sublime-mcp 1.12.0 → 1.12.2

package/fallback-tools.json

@@ -354,6 +354,30 @@
         "properties": {}
       }
     },
+    {
+      "name": "click_menu_item",
+      "description": "Run an installed menu item by its caption path, e.g. path='Tools > Command Palette...' (the end of the path is enough if it is unique). Reads the *.sublime-menu resources and runs the item's command and args, as a click would; the native menu is never opened. Most built-in items have no caption in the menu file; address them by command name, e.g. 'Selection > select_all'. Errors with the candidates if several items match. The result names the scope used (window, text or application); pass scope to override it for built-in commands.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "path": {
+            "type": "string",
+            "description": "Captions joined by '>', e.g. 'Tools > Command Palette...'."
+          },
+          "scope": {
+            "type": "string",
+            "enum": [
+              "window",
+              "text",
+              "application"
+            ]
+          }
+        },
+        "required": [
+          "path"
+        ]
+      }
+    },
     {
       "name": "clone_file",
       "description": "Create a clone of the active view (opens the same file in a new tab, sharing the buffer).",
@@ -846,7 +870,7 @@
               "button",
               "close"
             ],
-            "description": "What to do (default: cancel)."
+            "description": "What to do (default: cancel, or button when 'button' is given)."
           },
           "button": {
             "type": "string",
@@ -1490,7 +1514,7 @@
     },
     {
       "name": "get_console",
-      "description": "Read Sublime Text's built-in console. mode='auto' prefers a complete visible-console capture and falls back to the reload-safe prospective capture; mode='visible' requires a complete capture; mode='captured' is non-invasive but contains only messages observed since capture began. Results include source and complete metadata.",
+      "description": "Read Sublime Text's built-in console. mode='auto' prefers a complete visible-console capture and falls back to the reload-safe prospective capture; mode='visible' requires a complete capture; mode='captured' is non-invasive but contains only messages observed since capture began. Results include source and complete metadata. The visible capture clicks in the console and copies it, so it only runs when this Sublime window is in front (otherwise it fails at once and changes nothing); force_focus=true raises it first, which can crash a portable Sublime Text. tail=N keeps the last N entries (captured) or the last N lines (visible; the result then has lines_total and truncated); tail=0 returns everything.",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -1506,6 +1530,10 @@
           "tail": {
             "type": "integer",
             "default": 200
+          },
+          "force_focus": {
+            "type": "boolean",
+            "default": false
           }
         }
       }
@@ -1577,10 +1605,15 @@
     },
     {
       "name": "get_help",
-      "description": "Return the Agent Guide (AGENT_GUIDE.md) with detailed instructions on how to use sublime-mcp tools correctly. Call this first if you are unsure how to save files, close tabs, or use eval_python.",
+      "description": "Return the Agent Guide (AGENT_GUIDE.md) with detailed instructions on how to use sublime-mcp tools correctly. Call this first if you are unsure how to save files, close tabs, or use eval_python. The full guide is about 12 KB; section=<words from a heading> returns only the matching section(s), and every result lists the section headings.",
       "inputSchema": {
         "type": "object",
-        "properties": {}
+        "properties": {
+          "section": {
+            "type": "string",
+            "description": "Return only the sections whose heading contains this text, e.g. 'console'."
+          }
+        }
       }
     },
     {
@@ -1672,6 +1705,27 @@
         "properties": {}
       }
     },
+    {
+      "name": "get_quick_panel",
+      "description": "List the items of the quick panel that a package opened with window.show_quick_panel (e.g. the Install Package picker), plus its flags and preselected index. Big pickers hold thousands of items, so the result is a page: pass text to keep only items whose first line contains it, limit (default 100, at most 1000) and offset; the result gives total, matched and the original indexes of the items returned. Only sees panels opened by packages in the same plugin host as sublime-mcp; the command palette, Goto Anything and panels from the other host are not visible and give an error.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "text": {
+            "type": "string",
+            "description": "Keep only items whose first line contains this."
+          },
+          "limit": {
+            "type": "integer",
+            "description": "Page size (default 100, at most 1000)."
+          },
+          "offset": {
+            "type": "integer",
+            "description": "Skip this many matching items (default 0)."
+          }
+        }
+      }
+    },
     {
       "name": "get_scope_at_cursor",
       "description": "Return the full syntax scope string at the cursor position.",
@@ -2707,6 +2761,23 @@
         "properties": {}
       }
     },
+    {
+      "name": "pick_quick_panel",
+      "description": "Pick an item of the quick panel shown by get_quick_panel: by index, or by text (case-insensitive match on the item's first line; must match exactly one item). index -1 cancels. Closes the panel and runs the package's own selection callback.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "index": {
+            "type": "integer",
+            "description": "Item index, or -1 to cancel."
+          },
+          "text": {
+            "type": "string",
+            "description": "Text of the item to pick."
+          }
+        }
+      }
+    },
     {
       "name": "play_macro",
       "description": "Alias of run_macro \u2014 play back the most recently recorded macro.",

package/package.json

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