@rushstack/mcp-server 0.2.1 → 0.2.2

package/CHANGELOG.json

@@ -1,6 +1,18 @@
 {
   "name": "@rushstack/mcp-server",
   "entries": [
+    {
+      "version": "0.2.2",
+      "tag": "@rushstack/mcp-server_v0.2.2",
+      "date": "Sat, 14 Jun 2025 00:11:30 GMT",
+      "comments": {
+        "patch": [
+          {
+            "comment": "Move the `rush docs` tool to a plugin package `@rushstack/rush-mcp-docs-plugin`"
+          }
+        ]
+      }
+    },
     {
       "version": "0.2.1",
       "tag": "@rushstack/mcp-server_v0.2.1",

package/CHANGELOG.md

@@ -1,6 +1,13 @@
 # Change Log - @rushstack/mcp-server
 
-This log was last generated on Fri, 06 Jun 2025 08:20:18 GMT and should not be manually modified.
+This log was last generated on Sat, 14 Jun 2025 00:11:30 GMT and should not be manually modified.
+
+## 0.2.2
+Sat, 14 Jun 2025 00:11:30 GMT
+
+### Patches
+
+- Move the `rush docs` tool to a plugin package `@rushstack/rush-mcp-docs-plugin`
 
 ## 0.2.1
 Fri, 06 Jun 2025 08:20:18 GMT

package/lib/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAYpE,qBAAa,aAAc,SAAQ,SAAS;IAC1C,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,aAAa,CAAsB;gBAExB,iBAAiB,EAAE,MAAM;IAU/B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAOxC,OAAO,CAAC,gBAAgB;IASxB,OAAO,CAAC,cAAc;CAOvB"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAWpE,qBAAa,aAAc,SAAQ,SAAS;IAC1C,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,aAAa,CAAsB;gBAExB,iBAAiB,EAAE,MAAM;IAU/B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAOxC,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,cAAc;CAOvB"}

package/lib/server.js

@@ -27,7 +27,6 @@ class RushMCPServer extends mcp_js_1.McpServer {
         this._tools.push(new tools_1.RushCommandValidatorTool());
         this._tools.push(new tools_1.RushWorkspaceDetailsTool());
         this._tools.push(new tools_1.RushProjectDetailsTool());
-        this._tools.push(new tools_1.RushDocsTool());
     }
     _registerTools() {
         process.chdir(this._rushWorkspacePath);

package/lib/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;AAE3D,oEAAoE;AACpE,mCAQiB;AACjB,+EAA4E;AAE5E,MAAa,aAAc,SAAQ,kBAAS;IAK1C,YAAmB,iBAAyB;QAC1C,KAAK,CAAC;YACJ,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,OAAO;SACjB,CAAC,CAAC;QAPG,WAAM,GAAe,EAAE,CAAC;QAS9B,IAAI,CAAC,kBAAkB,GAAG,iBAAiB,CAAC;QAC5C,IAAI,CAAC,aAAa,GAAG,IAAI,yCAAmB,CAAC,IAAI,CAAC,kBAAkB,EAAE,IAAI,CAAC,CAAC;IAC9E,CAAC;IAEM,KAAK,CAAC,UAAU;QACrB,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACxB,IAAI,CAAC,cAAc,EAAE,CAAC;QAEtB,MAAM,IAAI,CAAC,aAAa,CAAC,SAAS,EAAE,CAAC;IACvC,CAAC;IAEO,gBAAgB;QACtB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,gCAAwB,EAAE,CAAC,CAAC;QACjD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,8BAAsB,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC;QACtE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,gCAAwB,EAAE,CAAC,CAAC;QACjD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,gCAAwB,EAAE,CAAC,CAAC;QACjD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,8BAAsB,EAAE,CAAC,CAAC;QAC/C,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,oBAAY,EAAE,CAAC,CAAC;IACvC,CAAC;IAEO,cAAc;QACpB,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAEvC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAC/B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;CACF;AAtCD,sCAsCC","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport {\n  type BaseTool,\n  RushConflictResolverTool,\n  RushMigrateProjectTool,\n  RushCommandValidatorTool,\n  RushWorkspaceDetailsTool,\n  RushProjectDetailsTool,\n  RushDocsTool\n} from './tools';\nimport { RushMcpPluginLoader } from './pluginFramework/RushMcpPluginLoader';\n\nexport class RushMCPServer extends McpServer {\n  private _rushWorkspacePath: string;\n  private _tools: BaseTool[] = [];\n  private _pluginLoader: RushMcpPluginLoader;\n\n  public constructor(rushWorkspacePath: string) {\n    super({\n      name: 'rush',\n      version: '1.0.0'\n    });\n\n    this._rushWorkspacePath = rushWorkspacePath;\n    this._pluginLoader = new RushMcpPluginLoader(this._rushWorkspacePath, this);\n  }\n\n  public async startAsync(): Promise<void> {\n    this._initializeTools();\n    this._registerTools();\n\n    await this._pluginLoader.loadAsync();\n  }\n\n  private _initializeTools(): void {\n    this._tools.push(new RushConflictResolverTool());\n    this._tools.push(new RushMigrateProjectTool(this._rushWorkspacePath));\n    this._tools.push(new RushCommandValidatorTool());\n    this._tools.push(new RushWorkspaceDetailsTool());\n    this._tools.push(new RushProjectDetailsTool());\n    this._tools.push(new RushDocsTool());\n  }\n\n  private _registerTools(): void {\n    process.chdir(this._rushWorkspacePath);\n\n    for (const tool of this._tools) {\n      tool.register(this);\n    }\n  }\n}\n"]}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;AAE3D,oEAAoE;AACpE,mCAOiB;AACjB,+EAA4E;AAE5E,MAAa,aAAc,SAAQ,kBAAS;IAK1C,YAAmB,iBAAyB;QAC1C,KAAK,CAAC;YACJ,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,OAAO;SACjB,CAAC,CAAC;QAPG,WAAM,GAAe,EAAE,CAAC;QAS9B,IAAI,CAAC,kBAAkB,GAAG,iBAAiB,CAAC;QAC5C,IAAI,CAAC,aAAa,GAAG,IAAI,yCAAmB,CAAC,IAAI,CAAC,kBAAkB,EAAE,IAAI,CAAC,CAAC;IAC9E,CAAC;IAEM,KAAK,CAAC,UAAU;QACrB,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACxB,IAAI,CAAC,cAAc,EAAE,CAAC;QAEtB,MAAM,IAAI,CAAC,aAAa,CAAC,SAAS,EAAE,CAAC;IACvC,CAAC;IAEO,gBAAgB;QACtB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,gCAAwB,EAAE,CAAC,CAAC;QACjD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,8BAAsB,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC;QACtE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,gCAAwB,EAAE,CAAC,CAAC;QACjD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,gCAAwB,EAAE,CAAC,CAAC;QACjD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,8BAAsB,EAAE,CAAC,CAAC;IACjD,CAAC;IAEO,cAAc;QACpB,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAEvC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAC/B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;CACF;AArCD,sCAqCC","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport {\n  type BaseTool,\n  RushConflictResolverTool,\n  RushMigrateProjectTool,\n  RushCommandValidatorTool,\n  RushWorkspaceDetailsTool,\n  RushProjectDetailsTool\n} from './tools';\nimport { RushMcpPluginLoader } from './pluginFramework/RushMcpPluginLoader';\n\nexport class RushMCPServer extends McpServer {\n  private _rushWorkspacePath: string;\n  private _tools: BaseTool[] = [];\n  private _pluginLoader: RushMcpPluginLoader;\n\n  public constructor(rushWorkspacePath: string) {\n    super({\n      name: 'rush',\n      version: '1.0.0'\n    });\n\n    this._rushWorkspacePath = rushWorkspacePath;\n    this._pluginLoader = new RushMcpPluginLoader(this._rushWorkspacePath, this);\n  }\n\n  public async startAsync(): Promise<void> {\n    this._initializeTools();\n    this._registerTools();\n\n    await this._pluginLoader.loadAsync();\n  }\n\n  private _initializeTools(): void {\n    this._tools.push(new RushConflictResolverTool());\n    this._tools.push(new RushMigrateProjectTool(this._rushWorkspacePath));\n    this._tools.push(new RushCommandValidatorTool());\n    this._tools.push(new RushWorkspaceDetailsTool());\n    this._tools.push(new RushProjectDetailsTool());\n  }\n\n  private _registerTools(): void {\n    process.chdir(this._rushWorkspacePath);\n\n    for (const tool of this._tools) {\n      tool.register(this);\n    }\n  }\n}\n"]}

package/lib/tools/index.d.ts

@@ -4,5 +4,4 @@ export * from './project-details.tool';
 export * from './rush-command-validator.tool';
 export * from './workspace-details';
 export * from './conflict-resolver.tool';
-export * from './docs.tool';
 //# sourceMappingURL=index.d.ts.map

package/lib/tools/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAGA,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAGA,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC"}

package/lib/tools/index.js

@@ -22,5 +22,4 @@ __exportStar(require("./project-details.tool"), exports);
 __exportStar(require("./rush-command-validator.tool"), exports);
 __exportStar(require("./workspace-details"), exports);
 __exportStar(require("./conflict-resolver.tool"), exports);
-__exportStar(require("./docs.tool"), exports);
 //# sourceMappingURL=index.js.map

package/lib/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;;;;;;;;;;;;;;AAE3D,8CAA4B;AAC5B,yDAAuC;AACvC,yDAAuC;AACvC,gEAA8C;AAC9C,sDAAoC;AACpC,2DAAyC;AACzC,8CAA4B","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nexport * from './base.tool';\nexport * from './migrate-project.tool';\nexport * from './project-details.tool';\nexport * from './rush-command-validator.tool';\nexport * from './workspace-details';\nexport * from './conflict-resolver.tool';\nexport * from './docs.tool';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;;;;;;;;;;;;;;AAE3D,8CAA4B;AAC5B,yDAAuC;AACvC,yDAAuC;AACvC,gEAA8C;AAC9C,sDAAoC;AACpC,2DAAyC","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nexport * from './base.tool';\nexport * from './migrate-project.tool';\nexport * from './project-details.tool';\nexport * from './rush-command-validator.tool';\nexport * from './workspace-details';\nexport * from './conflict-resolver.tool';\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rushstack/mcp-server",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "A Model Context Protocol server implementation for Rush",
   "keywords": [
     "rush",
@@ -30,7 +30,7 @@
     "zod": "~3.24.3",
     "@rushstack/node-core-library": "5.13.1",
     "@rushstack/terminal": "0.15.3",
-    "@rushstack/rush-sdk": "5.153.2",
+    "@rushstack/rush-sdk": "5.155.0",
     "@rushstack/ts-command-line": "5.0.1"
   },
   "devDependencies": {

package/lib/rush-doc-fragment.mock.json

@@ -1,18 +0,0 @@
-[
-  {
-    "text": "---\ntitle: rush install-autoinstaller\n---\n\n```\nusage: rush install-autoinstaller [-h] --name AUTOINSTALLER_NAME\n\nUse this command to install dependencies for an autoinstaller folder.\n\nOptional arguments:\n  -h, --help            Show this help message and exit.\n  --name AUTOINSTALLER_NAME\n                        The name of the autoinstaller, which must be one of\n                        the folders under common/autoinstallers.\n```\n\n## See also\n\n- [rush update-autoinstaller](../commands/rush_update-autoinstaller.md)\n- [rush init-autoinstaller](../commands/rush_init-autoinstaller.md)",
-    "score": 0.7231232
-  },
-  {
-    "text": "---\ntitle: rush install-autoinstaller\n---\n\n```\n用法：rush install-autoinstaller [-h] --name AUTOINSTALLER_NAME\n\n使用该指令给一个项目安装依赖。\n\n可选参数：\n  -h, --help            展示帮助信息并退出\n  --name AUTOINSTALLER_NAME\n                        指定自动安装的包名，它必须是 common/autoinstallers\n                        下的一个文件夹。\n```\n\n## See also\n\n- [rush update-autoinstaller](../commands/rush_update-autoinstaller.md)\n- [rush init-autoinstaller](../commands/rush_init-autoinstaller.md)",
-    "score": 0.7132133
-  },
-  {
-    "text": "---\ntitle: rush update-autoinstaller\n---\n\n```\nusage: rush update-autoinstaller [-h] --name AUTOINSTALLER_NAME\n\nUse this command to regenerate the shrinkwrap file for an autoinstaller\nfolder.\n\nOptional arguments:\n  -h, --help            Show this help message and exit.\n  --name AUTOINSTALLER_NAME\n                        The name of the autoinstaller, which must be one of\n                        the folders under common/autoinstallers.\n```\n\n## See also\n\n- [rush install-autoinstaller](../commands/rush_install-autoinstaller.md)\n- [rush init-autoinstaller](../commands/rush_init-autoinstaller.md)",
-    "score": 0.6632131
-  },
-  {
-    "text": "---\ntitle: rush update-autoinstaller\n---\n\n```\nusage: rush update-autoinstaller [-h] --name AUTOINSTALLER_NAME\n\nUse this command to regenerate the shrinkwrap file for an autoinstaller\nfolder.\n\nOptional arguments:\n  -h, --help            Show this help message and exit.\n  --name AUTOINSTALLER_NAME\n                        The name of the autoinstaller, which must be one of\n                        the folders under common/autoinstallers.\n```\n\n## See also\n\n- [rush install-autoinstaller](../commands/rush_install-autoinstaller.md)\n- [rush init-autoinstaller](../commands/rush_init-autoinstaller.md)",
-    "score": 0.6528328
-  }
-]

package/lib/tools/docs.tool.d.ts

@@ -1,9 +0,0 @@
-import { BaseTool, type CallToolResult } from './base.tool';
-export declare class RushDocsTool extends BaseTool {
-    constructor();
-    private _searchDocs;
-    executeAsync({ userQuery }: {
-        userQuery: string;
-    }): Promise<CallToolResult>;
-}
-//# sourceMappingURL=docs.tool.d.ts.map

package/lib/tools/docs.tool.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"docs.tool.d.ts","sourceRoot":"","sources":["../../src/tools/docs.tool.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,QAAQ,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAY5D,qBAAa,YAAa,SAAQ,QAAQ;;IAaxC,OAAO,CAAC,WAAW;IAeN,YAAY,CAAC,EAAE,SAAS,EAAE,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,CAAC;CAYzF"}

package/lib/tools/docs.tool.js

@@ -1,47 +0,0 @@
-"use strict";
-// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
-// See LICENSE in the project root for license information.
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.RushDocsTool = void 0;
-const zod_1 = require("zod");
-const node_core_library_1 = require("@rushstack/node-core-library");
-const path_1 = __importDefault(require("path"));
-const base_tool_1 = require("./base.tool");
-class RushDocsTool extends base_tool_1.BaseTool {
-    constructor() {
-        super({
-            name: 'rush_docs',
-            description: 'Search and retrieve relevant sections from the official Rush documentation based on user queries.',
-            schema: {
-                userQuery: zod_1.z.string().describe('The user query to search for relevant documentation sections.')
-            }
-        });
-    }
-    // TODO: replace with Microsoft's service
-    _searchDocs(query) {
-        const startTime = Date.now();
-        const results = node_core_library_1.JsonFile.load(path_1.default.join(__dirname, '../rush-doc-fragment.mock.json'));
-        return {
-            query,
-            results,
-            count: results.length,
-            searchTimeMs: Date.now() - startTime
-        };
-    }
-    async executeAsync({ userQuery }) {
-        const docSearchResult = this._searchDocs(userQuery);
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: docSearchResult.results.map((item) => item.text).join('\n\n')
-                }
-            ]
-        };
-    }
-}
-exports.RushDocsTool = RushDocsTool;
-//# sourceMappingURL=docs.tool.js.map

package/lib/tools/docs.tool.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"docs.tool.js","sourceRoot":"","sources":["../../src/tools/docs.tool.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;;;;AAE3D,6BAAwB;AACxB,oEAAwD;AACxD,gDAAwB;AAExB,2CAA4D;AAY5D,MAAa,YAAa,SAAQ,oBAAQ;IACxC;QACE,KAAK,CAAC;YACJ,IAAI,EAAE,WAAW;YACjB,WAAW,EACT,mGAAmG;YACrG,MAAM,EAAE;gBACN,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+DAA+D,CAAC;aAChG;SACF,CAAC,CAAC;IACL,CAAC;IAED,yCAAyC;IACjC,WAAW,CAAC,KAAa;QAC/B,MAAM,SAAS,GAAW,IAAI,CAAC,GAAG,EAAE,CAAC;QAErC,MAAM,OAAO,GAA2B,4BAAQ,CAAC,IAAI,CACnD,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,gCAAgC,CAAC,CACvD,CAAC;QAEF,OAAO;YACL,KAAK;YACL,OAAO;YACP,KAAK,EAAE,OAAO,CAAC,MAAM;YACrB,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;SACrC,CAAC;IACJ,CAAC;IAEM,KAAK,CAAC,YAAY,CAAC,EAAE,SAAS,EAAyB;QAC5D,MAAM,eAAe,GAAgB,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QAEjE,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,eAAe,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;iBACpE;aACF;SACF,CAAC;IACJ,CAAC;CACF;AAxCD,oCAwCC","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport { z } from 'zod';\nimport { JsonFile } from '@rushstack/node-core-library';\nimport path from 'path';\n\nimport { BaseTool, type CallToolResult } from './base.tool';\n\ninterface IDocsResult {\n  query: string;\n  results: {\n    score: number;\n    text: string;\n  }[];\n  count: number;\n  searchTimeMs: number;\n}\n\nexport class RushDocsTool extends BaseTool {\n  public constructor() {\n    super({\n      name: 'rush_docs',\n      description:\n        'Search and retrieve relevant sections from the official Rush documentation based on user queries.',\n      schema: {\n        userQuery: z.string().describe('The user query to search for relevant documentation sections.')\n      }\n    });\n  }\n\n  // TODO: replace with Microsoft's service\n  private _searchDocs(query: string): IDocsResult {\n    const startTime: number = Date.now();\n\n    const results: IDocsResult['results'] = JsonFile.load(\n      path.join(__dirname, '../rush-doc-fragment.mock.json')\n    );\n\n    return {\n      query,\n      results,\n      count: results.length,\n      searchTimeMs: Date.now() - startTime\n    };\n  }\n\n  public async executeAsync({ userQuery }: { userQuery: string }): Promise<CallToolResult> {\n    const docSearchResult: IDocsResult = this._searchDocs(userQuery);\n\n    return {\n      content: [\n        {\n          type: 'text',\n          text: docSearchResult.results.map((item) => item.text).join('\\n\\n')\n        }\n      ]\n    };\n  }\n}\n"]}