sublime-mcp 1.4.2 → 1.6.0

package/bin/cli.js

@@ -1,69 +1,71 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
-const fs = require('fs/promises');
-const path = require('path');
-const prompts = require('prompts');
+const command = process.argv[2] || 'serve';
 
-async function main() {
-  console.log('Sublime-MCP Agent Configurator');
+async function probe(name, httpBase, mcpUrl) {
+  const report = { name, ok: false, httpBridge: null, mcp: null,
+    recommendedCodexConfig: { type: 'http', url: mcpUrl } };
 
-  const response = await prompts({
-    type: 'text',
-    name: 'configFile',
-    message: 'Please enter the path to your AI agent\'s configuration file (e.g., ~/.claude/settings.json):',
-    validate: async (value) => {
-      try {
-        // Resolve ~ to the home directory
-        const resolvedPath = value.startsWith('~') ? path.join(process.env.HOME || process.env.USERPROFILE, value.slice(1)) : value;
-        await fs.access(resolvedPath);
-        return true;
-      } catch (e) {
-        return 'File not found. Please enter a valid path.';
-      }
-    }
-  });
-
-  if (!response.configFile) {
-    console.log('Configuration cancelled.');
-    return;
+  try {
+    const response = await fetch(new URL('/health', httpBase), { signal: AbortSignal.timeout(5000) });
+    if (!response.ok) throw new Error(`HTTP ${response.status}`);
+    report.httpBridge = await response.json();
+  } catch (error) {
+    report.httpBridge = { ok: false, error: error.message };
   }
 
-  const configPath = response.configFile.startsWith('~') ? path.join(process.env.HOME || process.env.USERPROFILE, response.configFile.slice(1)) : response.configFile;
-  console.log(Reading configuration file: );
-
   try {
-    const configContent = await fs.readFile(configPath, 'utf-8');
-    const config = JSON.parse(configContent);
-
-    console.log('Successfully parsed configuration file.');
-
-    // Determine the correct port based on the platform
-    const port = process.platform === 'win32' ? 9502 : 9503;
-    const mcpEntry = {
-      "sublime-mcp": { "type": "sse", "url": http://127.0.0.1:/sse }
+    const rpc = async (id, method, params = {}) => {
+      const response = await fetch(mcpUrl, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json', Accept: 'application/json, text/event-stream' },
+        body: JSON.stringify({ jsonrpc: '2.0', id, method, params }),
+        signal: AbortSignal.timeout(5000),
+      });
+      if (!response.ok) throw new Error(`HTTP ${response.status}`);
+      return response.json();
+    };
+    const initialized = await rpc(1, 'initialize', {
+      protocolVersion: '2025-03-26', capabilities: {},
+      clientInfo: { name: 'sublime-mcp-doctor', version: '1' },
+    });
+    const listed = await rpc(2, 'tools/list');
+    const tools = listed?.result?.tools ?? [];
+    report.mcp = {
+      ok: Boolean(initialized?.result) && tools.length > 0,
+      serverInfo: initialized?.result?.serverInfo ?? null,
+      toolCount: tools.length,
+      tools: tools.map(tool => tool.name),
     };
-
-    // Add or update the mcpServers entry
-    if (!config.mcpServers) {
-      config.mcpServers = {};
-    }
-    config.mcpServers = { ...config.mcpServers, ...mcpEntry };
-
-    // Write the updated configuration back to the file
-    const newConfigContent = JSON.stringify(config, null, 2);
-    await fs.writeFile(configPath, newConfigContent, 'utf-8');
-
-    console.log('Successfully updated the configuration file with the sublime-mcp server.');
-    console.log('Please restart your AI agent for the changes to take effect.');
-
   } catch (error) {
-    console.error(Error processing configuration file: );
-    console.error('Please ensure the file is a valid JSON file.');
-    process.exit(1);
+    report.mcp = { ok: false, error: error.message, toolCount: 0 };
   }
+
+  report.ok = Boolean(report.httpBridge?.ok && report.mcp?.ok);
+  return report;
 }
 
-main().catch(err => {
-  console.error('An error occurred:', err);
-  process.exit(1);
-});
+async function doctor() {
+  const isWindows = process.platform === 'win32';
+  const httpBase = process.env.SUBLIME_MCP_BASE ?? `http://127.0.0.1:${isWindows ? 9500 : 9501}`;
+  const mcpUrl = process.env.SUBLIME_MCP_URL ?? `http://127.0.0.1:${isWindows ? 9502 : 9503}/mcp`;
+  const main = await probe('sublime-mcp', httpBase, mcpUrl);
+  const includeAll = process.argv.includes('--all');
+  const companions = includeAll ? await Promise.all([
+    probe('debugger-mcp', 'http://127.0.0.1:9515', 'http://127.0.0.1:9505/mcp'),
+    probe('lsp-mcp', 'http://127.0.0.1:9516', 'http://127.0.0.1:9506/mcp'),
+  ]) : [];
+  const report = { ...main, companions };
+  report.ok = main.ok && companions.every(item => item.ok);
+  process.stdout.write(`${JSON.stringify(report, null, 2)}\n`);
+  process.exitCode = report.ok ? 0 : 1;
+}
+
+if (command === 'doctor') {
+  await doctor();
+} else if (command === 'serve') {
+  await import('../index.js');
+} else {
+  process.stderr.write('Usage: sublime-mcp [serve|doctor [--all]]\n');
+  process.exitCode = 2;
+}

package/fallback-tools.json

@@ -272,6 +272,26 @@
         "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.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "query": {
+            "type": "string",
+            "description": "Capability to find, such as bookmarks, tabs, syntax, or commands."
+          },
+          "limit": {
+            "type": "integer",
+            "default": 10
+          }
+        },
+        "required": [
+          "query"
+        ]
+      }
+    },
     {
       "name": "duplicate_line",
       "description": "Duplicate the current line(s) in the active file.",
@@ -588,6 +608,38 @@
         "properties": {}
       }
     },
+    {
+      "name": "focus_sheet",
+      "description": "Move input focus to one sheet by global index or stable sheet ID without changing the selected sheet set.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "index": {
+            "type": "integer",
+            "minimum": 0
+          },
+          "id": {
+            "type": "integer"
+          }
+        }
+      }
+    },
+    {
+      "name": "focus_to_left",
+      "description": "Move input focus to the selected sheet on the left.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {}
+      }
+    },
+    {
+      "name": "focus_to_right",
+      "description": "Move input focus to the selected sheet on the right.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {}
+      }
+    },
     {
       "name": "fold_lines",
       "description": "Fold (collapse) lines begin through end (1-based) in the active file.",
@@ -681,9 +733,31 @@
         }
       }
     },
+    {
+      "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.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "mode": {
+            "type": "string",
+            "enum": [
+              "auto",
+              "visible",
+              "captured"
+            ],
+            "default": "auto"
+          },
+          "tail": {
+            "type": "integer",
+            "default": 200
+          }
+        }
+      }
+    },
     {
       "name": "get_console_full",
-      "description": "Return the entire captured ST console buffer with no tail limit.\nIncludes startup messages, plugin load events, and all errors since ST started.",
+      "description": "Compatibility alias for a complete visible-console capture.\nCurrently supported on Windows; prefer get_console(mode='visible').",
       "inputSchema": {
         "type": "object",
         "properties": {}
@@ -691,7 +765,7 @@
     },
     {
       "name": "get_console_log",
-      "description": "Return recent Sublime Text console output (plugin log messages and stdout).\ntail=N limits to the last N entries. tail=0 returns all captured entries.",
+      "description": "Compatibility tool for reload-safe prospective console capture.\ntail=N limits to the last N entries; tail=0 returns all retained entries.\nPrefer get_console(mode='captured') for explicit completeness metadata.",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -704,7 +778,7 @@
     },
     {
       "name": "get_console_win",
-      "description": "Windows-only fallback: captures ST console by clicking the output area via ctypes then Ctrl+A/Ctrl+C.\nUse when get_console_full fails. Returns error on non-Windows.",
+      "description": "Windows complete-console backend using reversible UI automation. Restores the previous panel, editor focus, pointer position, and text clipboard. Prefer get_console(mode='auto').",
       "inputSchema": {
         "type": "object",
         "properties": {}
@@ -801,7 +875,7 @@
     },
     {
       "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.",
+      "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.",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -851,6 +925,19 @@
         "properties": {}
       }
     },
+    {
+      "name": "get_selected_sheets",
+      "description": "Return the currently multi-selected sheets, optionally limited to one group, with stable IDs and group positions.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "group": {
+            "type": "integer",
+            "minimum": 0
+          }
+        }
+      }
+    },
     {
       "name": "get_selection",
       "description": "Return the current selection(s): text and begin/end line+col for each.",
@@ -893,9 +980,25 @@
         ]
       }
     },
+    {
+      "name": "get_sheet_index",
+      "description": "Return a sheet's current group and index within that group. Identify it by global index or stable sheet ID.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "index": {
+            "type": "integer",
+            "minimum": 0
+          },
+          "id": {
+            "type": "integer"
+          }
+        }
+      }
+    },
     {
       "name": "get_sheets",
-      "description": "List ALL sheets (tabs) in the current window by index, including images and untitled buffers.\nReturns index, type (TextSheet/ImageSheet), path, name, is_dirty for each.\nUse index with get_sheet_content to read a specific tab.",
+      "description": "List ALL sheets (tabs) in the current window by index, including images and untitled buffers.\nReturns identity, group position, selection/focus state, type, path, name, and dirty state.\nUse index with get_sheet_content to read a specific tab.",
       "inputSchema": {
         "type": "object",
         "properties": {}
@@ -1179,6 +1282,46 @@
         "properties": {}
       }
     },
+    {
+      "name": "move_sheets_to_group",
+      "description": "Move one or more sheets together to a group and optional insertion position, preserving native multi-selection when requested.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "indices": {
+            "type": "array",
+            "items": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "minItems": 1
+          },
+          "ids": {
+            "type": "array",
+            "items": {
+              "type": "integer"
+            },
+            "minItems": 1
+          },
+          "group": {
+            "type": "integer",
+            "minimum": 0
+          },
+          "insertion_index": {
+            "type": "integer",
+            "minimum": -1,
+            "default": -1
+          },
+          "select": {
+            "type": "boolean",
+            "default": true
+          }
+        },
+        "required": [
+          "group"
+        ]
+      }
+    },
     {
       "name": "move_to_neighboring_group",
       "description": "Move the active view to the neighboring pane group.",
@@ -1541,6 +1684,49 @@
         "properties": {}
       }
     },
+    {
+      "name": "project_search",
+      "description": "Search project files with Sublime Text's native Find in Files engine and return structured {path,line,col,text} matches. This is the preferred project search tool.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "pattern": {
+            "type": "string"
+          },
+          "where": {
+            "type": "string",
+            "description": "ST Where expression; empty uses current project folders."
+          },
+          "case_sensitive": {
+            "type": "boolean",
+            "default": false
+          },
+          "regex": {
+            "type": "boolean",
+            "default": false
+          },
+          "whole_word": {
+            "type": "boolean",
+            "default": false
+          },
+          "limit": {
+            "type": "integer",
+            "default": 200
+          },
+          "timeout": {
+            "type": "number",
+            "default": 30
+          },
+          "show_panel": {
+            "type": "boolean",
+            "default": false
+          }
+        },
+        "required": [
+          "pattern"
+        ]
+      }
+    },
     {
       "name": "prompt_goto_line",
       "description": "Open the Goto Line prompt (WindowCommand).",
@@ -1881,6 +2067,37 @@
         ]
       }
     },
+    {
+      "name": "select_sheets",
+      "description": "Change native tab multi-selection across the window. Identify sheets by global indices or stable sheet IDs; optionally choose the focused sheet.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "indices": {
+            "type": "array",
+            "items": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "minItems": 1
+          },
+          "ids": {
+            "type": "array",
+            "items": {
+              "type": "integer"
+            },
+            "minItems": 1
+          },
+          "focus_index": {
+            "type": "integer",
+            "minimum": 0
+          },
+          "focus_id": {
+            "type": "integer"
+          }
+        }
+      }
+    },
     {
       "name": "select_theme",
       "description": "Open the theme picker (WindowCommand).",
@@ -1889,6 +2106,14 @@
         "properties": {}
       }
     },
+    {
+      "name": "select_to_left",
+      "description": "Add the sheet left of the focused sheet to the tab multi-selection.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {}
+      }
+    },
     {
       "name": "select_to_mark",
       "description": "Select the text between the cursor and the previously set mark (TextCommand).",
@@ -1897,6 +2122,14 @@
         "properties": {}
       }
     },
+    {
+      "name": "select_to_right",
+      "description": "Add the sheet right of the focused sheet to the tab multi-selection.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {}
+      }
+    },
     {
       "name": "send_to_view",
       "description": "Send a string to any open tab by name (partial match, case-insensitive).\nInserts the text at the cursor of the resolved view using the standard insert command; returns an error if the view is read-only.\nUse index (0-based, from get_open_files) to target a tab by position instead of name.\nOmit both name and index to target the active view.",
@@ -2010,6 +2243,34 @@
         ]
       }
     },
+    {
+      "name": "set_sheet_index",
+      "description": "Move one sheet to a group and position using Sublime's set_sheet_index API.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "index": {
+            "type": "integer",
+            "minimum": 0
+          },
+          "id": {
+            "type": "integer"
+          },
+          "group": {
+            "type": "integer",
+            "minimum": 0
+          },
+          "sheet_index": {
+            "type": "integer",
+            "minimum": 0
+          }
+        },
+        "required": [
+          "group",
+          "sheet_index"
+        ]
+      }
+    },
     {
       "name": "set_status",
       "description": "Write a message to Sublime Text's status bar.",
@@ -2405,6 +2666,30 @@
         "properties": {}
       }
     },
+    {
+      "name": "unselect_others",
+      "description": "Collapse tab multi-selection to the focused sheet.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {}
+      }
+    },
+    {
+      "name": "unselect_to_left",
+      "description": "Remove sheets left of the focused sheet from the tab multi-selection.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {}
+      }
+    },
+    {
+      "name": "unselect_to_right",
+      "description": "Remove sheets right of the focused sheet from the tab multi-selection.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {}
+      }
+    },
     {
       "name": "upper_case",
       "description": "Convert the current selection(s) to UPPER CASE.",

package/http.js

@@ -13,6 +13,7 @@ export const SLOW_ENDPOINTS = new Set([
   '/install_package',
   '/search_packages',
   '/find_in_files',
+  '/project_search',
   '/eval_python_latest',
   '/run_build',
 ]);

package/index.js

@@ -14,6 +14,35 @@ const FALLBACK_TOOLS = JSON.parse(
   readFileSync(join(dirname(fileURLToPath(import.meta.url)), 'fallback-tools.json'), 'utf8'),
 ).tools;
 
+const DEFAULT_TOOL_NAMES = new Set([
+  'get_help',
+  'batch',
+  'get_active_file',
+  'project_search',
+  'str_replace_based_edit_tool',
+  'save_file',
+  'discover_tools',
+]);
+const GATEWAY_FALLBACKS = [
+  {
+    name: 'discover_tools',
+    description: 'Search advanced Sublime capabilities. Invoke a result through batch.',
+    inputSchema: { type: 'object', properties: {
+      query: { type: 'string' }, limit: { type: 'integer', default: 10 },
+    }, required: ['query'] },
+  },
+  {
+    name: 'project_search',
+    description: "Search project files with Sublime Text's native Find in Files engine and return structured matches.",
+    inputSchema: { type: 'object', properties: {
+      pattern: { type: 'string' }, where: { type: 'string' },
+      case_sensitive: { type: 'boolean', default: false }, regex: { type: 'boolean', default: false },
+      whole_word: { type: 'boolean', default: false }, limit: { type: 'integer', default: 200 },
+      timeout: { type: 'number', default: 30 }, show_panel: { type: 'boolean', default: false },
+    }, required: ['pattern'] },
+  },
+];
+
 process.stderr.write(`mcp-commander: BASE=${BASE} platform=${process.platform}\n`);
 
 function ok(data) {
@@ -132,14 +161,16 @@ function registerFallbackTools() {
   // exposes the same tool surface the backend actually serves instead of a
   // hand-maintained subset (F10). Every backend tool has a POST /{name}
   // alias, so one uniform call shape works for all of them.
-  for (const tool of FALLBACK_TOOLS) {
+  const byName = new Map(FALLBACK_TOOLS.map(tool => [tool.name, tool]));
+  for (const tool of GATEWAY_FALLBACKS) byName.set(tool.name, tool);
+  for (const tool of [...byName.values()].filter(tool => DEFAULT_TOOL_NAMES.has(tool.name))) {
     server.registerTool(
       tool.name,
       { description: tool.description, inputSchema: jsonSchemaToZod(tool.inputSchema) },
       async (args) => ok(await post('/' + tool.name, args ?? {})),
     );
   }
-  process.stderr.write(`mcp-commander: registered ${FALLBACK_TOOLS.length} generated fallback tools\n`);
+  process.stderr.write('mcp-commander: registered focused fallback tool surface\n');
 }
 
 // ── startup ───────────────────────────────────────────────────────────────────

package/package.json

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

package/test_batch.mjs

@@ -1,72 +0,0 @@
-// Integration test for packages/node-proxy/index.js.
-//
-// Unlike hitting port 9500 or 9502 directly, this launches index.js as a real
-// subprocess and speaks MCP over stdio — the same code path a real MCP client
-// (e.g. Claude Code configured with a stdio server entry) uses. This is what
-// caught the missing `_POST["/batch"]` route on the HTTP bridge: node-proxy's
-// dynamic tool discovery (loadDynamicTools) picks up `batch` from /mcp_tools
-// fine, but the generic passthrough posts to /batch on port 9500, which
-// 404'd until that route was added to sublime_mcp.py.
-//
-// Prerequisites:
-//   - Sublime Text running with sublime_mcp.py loaded (HTTP bridge on 9500)
-//   - At least one file open in ST
-//
-// Run:
-//   cd packages/node-proxy
-//   node test_batch.mjs
-
-import assert from 'node:assert/strict';
-import { Client } from '@modelcontextprotocol/sdk/client/index.js';
-import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
-
-async function main() {
-  const transport = new StdioClientTransport({
-    command: 'node',
-    args: ['index.js'],
-    cwd: import.meta.dirname,
-    stderr: 'pipe',
-  });
-
-  const client = new Client({ name: 'test-batch', version: '1.0.0' });
-  await client.connect(transport);
-
-  try {
-    const tools = await client.listTools();
-    const names = tools.tools.map(t => t.name);
-    assert.ok(names.includes('batch'), 'batch tool not discovered from backend');
-    console.log('PASS: batch discovered dynamically (%d tools total)', names.length);
-
-    const result = await client.callTool({
-      name: 'batch',
-      arguments: { calls: [{ tool: 'get_line_count' }, { tool: 'get_selection' }] },
-    });
-    const data = JSON.parse(result.content[0].text);
-    assert.ok(Array.isArray(data.results), 'batch response missing results array');
-    assert.equal(data.results.length, 2, 'expected 2 results');
-    assert.ok('line_count' in data.results[0], 'get_line_count result missing line_count');
-    assert.ok('selections' in data.results[1], 'get_selection result missing selections');
-    console.log('PASS: batch call returned populated results via the real proxy subprocess');
-
-    const failResult = await client.callTool({
-      name: 'batch',
-      arguments: { calls: [{ tool: 'get_line_count' }, { tool: 'no_such_tool_xyz' }] },
-    });
-    const failData = JSON.parse(failResult.content[0].text);
-    assert.equal(failData.results.length, 2);
-    assert.ok('error' in failData.results[1], 'expected error for unknown tool');
-    console.log('PASS: batch partial failure does not abort the whole call');
-  } finally {
-    await client.close();
-  }
-}
-
-main()
-  .then(() => {
-    console.log('All tests passed.');
-    process.exit(0);
-  })
-  .catch(err => {
-    console.error('FAIL:', err);
-    process.exit(1);
-  });

package/test_fallback_catalog.mjs

@@ -1,125 +0,0 @@
-// Integration test for the generated fallback catalog (F10).
-//
-// Launches index.js as a real MCP stdio subprocess against a fake backend
-// that deliberately fails `/mcp_tools` discovery, forcing the fallback path.
-// Before the fix that path exposed a hand-maintained 71-tool subset; it must
-// now expose the full generated catalog and route calls correctly.
-//
-// No Sublime Text required — the fake backend stands in for the HTTP bridge.
-//
-// Run:
-//   cd packages/node-proxy
-//   node test_fallback_catalog.mjs
-
-import assert from 'node:assert/strict';
-import http from 'node:http';
-import { readFileSync } from 'node:fs';
-import { Client } from '@modelcontextprotocol/sdk/client/index.js';
-import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
-
-const CATALOG = JSON.parse(
-  readFileSync(new URL('./fallback-tools.json', import.meta.url), 'utf8'),
-).tools;
-
-// Fake bridge: 404 on /mcp_tools (kills discovery), echo on POST /{tool}.
-function startFakeBackend() {
-  const seen = [];
-  const server = http.createServer((req, res) => {
-    if (req.url.startsWith('/mcp_tools')) {
-      res.writeHead(404).end('no discovery for you');
-      return;
-    }
-    let body = '';
-    req.on('data', chunk => { body += chunk; });
-    req.on('end', () => {
-      seen.push({ url: req.url, method: req.method, body });
-      res.writeHead(200, { 'Content-Type': 'application/json' });
-      res.end(JSON.stringify({ echo: req.url, args: body ? JSON.parse(body) : null }));
-    });
-  });
-  return new Promise(resolve => {
-    server.listen(0, '127.0.0.1', () => resolve({ server, seen, port: server.address().port }));
-  });
-}
-
-async function main() {
-  const { server, seen, port } = await startFakeBackend();
-
-  const transport = new StdioClientTransport({
-    command: 'node',
-    args: ['index.js'],
-    cwd: import.meta.dirname,
-    env: { ...process.env, SUBLIME_MCP_BASE: `http://127.0.0.1:${port}` },
-    stderr: 'pipe',
-  });
-
-  const client = new Client({ name: 'test-fallback-catalog', version: '1.0.0' });
-  await client.connect(transport);
-
-  try {
-    const listed = await client.listTools();
-    const names = new Set(listed.tools.map(t => t.name));
-
-    assert.equal(
-      names.size,
-      CATALOG.length,
-      `fallback exposed ${names.size} tools, expected the full generated catalog (${CATALOG.length})`,
-    );
-    for (const tool of CATALOG) {
-      assert.ok(names.has(tool.name), `fallback is missing ${tool.name}`);
-    }
-    console.log('PASS: discovery failure still exposes all %d generated tools', names.size);
-
-    // batch was the headline F10 omission: absent from the old hand-written
-    // fallback, so a discovery miss removed it from the agent entirely.
-    assert.ok(names.has('batch'), 'batch missing from fallback catalog');
-    const result = await client.callTool({
-      name: 'batch',
-      arguments: { calls: [{ tool: 'get_line_count' }] },
-    });
-    const data = JSON.parse(result.content[0].text);
-    assert.equal(data.echo, '/batch', 'batch did not route to POST /batch');
-    assert.deepEqual(data.args, { calls: [{ tool: 'get_line_count' }] });
-    console.log('PASS: batch routes through the fallback path with its arguments intact');
-
-    // A no-parameter tool must still post cleanly.
-    await client.callTool({ name: 'get_line_count', arguments: {} });
-    assert.ok(
-      seen.some(r => r.url === '/get_line_count' && r.method === 'POST'),
-      'get_line_count did not POST to its tool-name alias',
-    );
-    console.log('PASS: no-parameter tools post to their /{name} alias');
-
-    // Schemas must survive, not degrade to untyped passthrough.
-    const openFile = listed.tools.find(t => t.name === 'open_file');
-    assert.ok(openFile.inputSchema?.properties?.path, 'open_file lost its typed schema');
-    console.log('PASS: generated schemas reach the client');
-
-    // The server must report the published package version. This is also the
-    // check that catches index.js failing to even start: package.json here is
-    // BOM-prefixed, and JSON.parse rejects a leading BOM.
-    const pkg = JSON.parse(
-      readFileSync(new URL('./package.json', import.meta.url), 'utf8').replace(/^\uFEFF/, ''),
-    );
-    const reported = client.getServerVersion();
-    assert.equal(
-      reported?.version,
-      pkg.version,
-      `server reported version ${reported?.version}, package.json says ${pkg.version}`,
-    );
-    console.log('PASS: server reports the package.json version (%s)', pkg.version);
-  } finally {
-    await client.close();
-    server.close();
-  }
-}
-
-main()
-  .then(() => {
-    console.log('All tests passed.');
-    process.exit(0);
-  })
-  .catch(err => {
-    console.error('FAIL:', err);
-    process.exit(1);
-  });