@rushstack/mcp-server 0.3.14 → 0.4.1

package/CHANGELOG.json

@@ -1,6 +1,58 @@
 {
   "name": "@rushstack/mcp-server",
   "entries": [
+    {
+      "version": "0.4.1",
+      "tag": "@rushstack/mcp-server_v0.4.1",
+      "date": "Fri, 20 Feb 2026 00:15:04 GMT",
+      "comments": {
+        "patch": [
+          {
+            "comment": "Add `\"node\"` condition before `\"import\"` in the `\"exports\"` map so that Node.js uses the CJS output (which handles extensionless imports), while bundlers still use ESM via `\"import\"`. Fixes https://github.com/microsoft/rushstack/issues/5644."
+          }
+        ],
+        "dependency": [
+          {
+            "comment": "Updating dependency \"@rushstack/node-core-library\" to `5.20.1`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/terminal\" to `0.22.1`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/ts-command-line\" to `5.3.1`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/heft\" to `1.2.1`"
+          }
+        ]
+      }
+    },
+    {
+      "version": "0.4.0",
+      "tag": "@rushstack/mcp-server_v0.4.0",
+      "date": "Thu, 19 Feb 2026 00:04:53 GMT",
+      "comments": {
+        "minor": [
+          {
+            "comment": "Normalize package layout. CommonJS is now under `lib-commonjs`, DTS is now under `lib-dts`, and ESM is now under `lib-esm`. Imports to `lib` still work as before, handled by the `\"exports\"` field in `package.json`."
+          }
+        ],
+        "dependency": [
+          {
+            "comment": "Updating dependency \"@rushstack/node-core-library\" to `5.20.0`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/terminal\" to `0.22.0`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/ts-command-line\" to `5.3.0`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/heft\" to `1.2.0`"
+          }
+        ]
+      }
+    },
     {
       "version": "0.3.14",
       "tag": "@rushstack/mcp-server_v0.3.14",

package/CHANGELOG.md

@@ -1,6 +1,20 @@
 # Change Log - @rushstack/mcp-server
 
-This log was last generated on Sat, 07 Feb 2026 01:13:26 GMT and should not be manually modified.
+This log was last generated on Fri, 20 Feb 2026 00:15:04 GMT and should not be manually modified.
+
+## 0.4.1
+Fri, 20 Feb 2026 00:15:04 GMT
+
+### Patches
+
+- Add `"node"` condition before `"import"` in the `"exports"` map so that Node.js uses the CJS output (which handles extensionless imports), while bundlers still use ESM via `"import"`. Fixes https://github.com/microsoft/rushstack/issues/5644.
+
+## 0.4.0
+Thu, 19 Feb 2026 00:04:53 GMT
+
+### Minor changes
+
+- Normalize package layout. CommonJS is now under `lib-commonjs`, DTS is now under `lib-dts`, and ESM is now under `lib-esm`. Imports to `lib` still work as before, handled by the `"exports"` field in `package.json`.
 
 ## 0.3.14
 Sat, 07 Feb 2026 01:13:26 GMT

package/bin/mcp-server

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-require('../lib/start.js');
+require('../lib-commonjs/start.js');

package/dist/tsdoc-metadata.json

@@ -5,7 +5,7 @@
   "toolPackages": [
     {
       "packageName": "@microsoft/api-extractor",
-      "packageVersion": "7.56.2"
+      "packageVersion": "7.57.0"
     }
   ]
 }

package/lib-esm/index.js

@@ -0,0 +1,5 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+export { RushMcpPluginSession } from './pluginFramework/RushMcpPluginSession';
+export { CallToolResultSchema } from './pluginFramework/zodTypes';
+//# sourceMappingURL=index.js.map

package/lib-esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,2DAA2D;AAS3D,OAAO,EAA6B,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AACzG,OAAO,EAAE,oBAAoB,EAAuC,MAAM,4BAA4B,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\n/**\n * API for use by MCP plugins.\n * @packageDocumentation\n */\n\nexport { type IRushMcpPlugin, type RushMcpPluginFactory } from './pluginFramework/IRushMcpPlugin';\nexport type { IRushMcpTool } from './pluginFramework/IRushMcpTool';\nexport { type IRegisterToolOptions, RushMcpPluginSession } from './pluginFramework/RushMcpPluginSession';\nexport { CallToolResultSchema, type CallToolResult, type zodModule } from './pluginFramework/zodTypes';\n"]}

package/lib-esm/pluginFramework/IRushMcpPlugin.js

@@ -0,0 +1,4 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+export {};
+//# sourceMappingURL=IRushMcpPlugin.js.map

package/lib-esm/pluginFramework/IRushMcpPlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IRushMcpPlugin.js","sourceRoot":"","sources":["../../src/pluginFramework/IRushMcpPlugin.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,2DAA2D","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 type { RushMcpPluginSession } from './RushMcpPluginSession';\n\n/**\n * MCP plugins should implement this interface.\n * @public\n */\nexport interface IRushMcpPlugin {\n  onInitializeAsync(): Promise<void>;\n}\n\n/**\n * The plugin's entry point should return this function as its default export.\n * @public\n */\nexport type RushMcpPluginFactory<TConfigFile = {}> = (\n  session: RushMcpPluginSession,\n  configFile: TConfigFile | undefined\n) => IRushMcpPlugin;\n"]}

package/lib-esm/pluginFramework/IRushMcpTool.js

@@ -0,0 +1,4 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+export {};
+//# sourceMappingURL=IRushMcpTool.js.map

package/lib-esm/pluginFramework/IRushMcpTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IRushMcpTool.js","sourceRoot":"","sources":["../../src/pluginFramework/IRushMcpTool.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,2DAA2D","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 type * as zod from 'zod';\n\nimport type { CallToolResult } from './zodTypes';\n\n/**\n * MCP plugins should implement this interface.\n * @public\n */\nexport interface IRushMcpTool<\n  TSchema extends zod.ZodObject<zod.ZodRawShape> = zod.ZodObject<zod.ZodRawShape>\n> {\n  readonly schema: TSchema;\n  executeAsync(input: zod.infer<TSchema>): Promise<CallToolResult>;\n}\n"]}

package/lib-esm/pluginFramework/RushMcpPluginLoader.js

@@ -0,0 +1,97 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+import * as path from 'node:path';
+import { FileSystem, Import, JsonFile, JsonSchema } from '@rushstack/node-core-library';
+import { Autoinstaller } from '@rushstack/rush-sdk/lib/logic/Autoinstaller';
+import { RushGlobalFolder } from '@rushstack/rush-sdk/lib/api/RushGlobalFolder';
+import { RushConfiguration } from '@rushstack/rush-sdk/lib/api/RushConfiguration';
+import { RushMcpPluginSessionInternal } from './RushMcpPluginSession';
+import rushMcpJsonSchemaObject from '../schemas/rush-mcp.schema.json';
+import rushMcpPluginSchemaObject from '../schemas/rush-mcp-plugin.schema.json';
+export class RushMcpPluginLoader {
+    constructor(rushWorkspacePath, mcpServer) {
+        this._rushWorkspacePath = rushWorkspacePath;
+        this._mcpServer = mcpServer;
+    }
+    static _formatError(e) {
+        var _a;
+        return (_a = e.stack) !== null && _a !== void 0 ? _a : RushMcpPluginLoader._formatError(e);
+    }
+    async loadAsync() {
+        const rushMcpFilePath = path.join(this._rushWorkspacePath, 'common/config/rush-mcp/rush-mcp.json');
+        if (!(await FileSystem.existsAsync(rushMcpFilePath))) {
+            return;
+        }
+        const rushConfiguration = RushConfiguration.loadFromDefaultLocation({
+            startingFolder: this._rushWorkspacePath
+        });
+        const jsonRushMcpConfig = await JsonFile.loadAndValidateAsync(rushMcpFilePath, RushMcpPluginLoader._rushMcpJsonSchema);
+        if (jsonRushMcpConfig.mcpPlugins.length === 0) {
+            return;
+        }
+        const rushGlobalFolder = new RushGlobalFolder();
+        for (const jsonMcpPlugin of jsonRushMcpConfig.mcpPlugins) {
+            // Ensure the autoinstaller is installed
+            const autoinstaller = new Autoinstaller({
+                autoinstallerName: jsonMcpPlugin.autoinstaller,
+                rushConfiguration,
+                rushGlobalFolder,
+                restrictConsoleOutput: false
+            });
+            await autoinstaller.prepareAsync();
+            // Load the manifest
+            // Suppose the autoinstaller is "my-autoinstaller" and the package is "rush-mcp-example-plugin".
+            // Then the folder will be:
+            // "/path/to/my-repo/common/autoinstallers/my-autoinstaller/node_modules/rush-mcp-example-plugin"
+            const installedPluginPackageFolder = await Import.resolvePackageAsync({
+                baseFolderPath: autoinstaller.folderFullPath,
+                packageName: jsonMcpPlugin.packageName
+            });
+            const manifestFilePath = path.join(installedPluginPackageFolder, 'rush-mcp-plugin.json');
+            if (!(await FileSystem.existsAsync(manifestFilePath))) {
+                throw new Error('The "rush-mcp-plugin.json" manifest file was not found under ' + installedPluginPackageFolder);
+            }
+            const jsonManifest = await JsonFile.loadAndValidateAsync(manifestFilePath, RushMcpPluginLoader._rushMcpPluginSchemaObject);
+            let rushMcpPluginOptions = {};
+            if (jsonManifest.configFileSchema) {
+                const mcpPluginSchemaFilePath = path.resolve(installedPluginPackageFolder, jsonManifest.configFileSchema);
+                const mcpPluginSchema = await JsonSchema.fromFile(mcpPluginSchemaFilePath);
+                const rushMcpPluginOptionsFilePath = path.resolve(this._rushWorkspacePath, `common/config/rush-mcp/${jsonManifest.pluginName}.json`);
+                // Example: /path/to/my-repo/common/config/rush-mcp/rush-mcp-example-plugin.json
+                rushMcpPluginOptions = await JsonFile.loadAndValidateAsync(rushMcpPluginOptionsFilePath, mcpPluginSchema);
+            }
+            const fullEntryPointPath = path.join(installedPluginPackageFolder, jsonManifest.entryPoint);
+            let pluginFactory;
+            try {
+                const entryPointModule = require(fullEntryPointPath);
+                if (entryPointModule.default === undefined) {
+                    throw new Error('The commonJS "default" export is missing');
+                }
+                pluginFactory = entryPointModule.default;
+            }
+            catch (e) {
+                throw new Error(`Unable to load plugin entry point at ${fullEntryPointPath}:\n` +
+                    RushMcpPluginLoader._formatError(e));
+            }
+            const session = new RushMcpPluginSessionInternal(this._mcpServer);
+            let plugin;
+            try {
+                plugin = pluginFactory(session, rushMcpPluginOptions);
+            }
+            catch (e) {
+                throw new Error(`Error invoking entry point for plugin ${jsonManifest.pluginName}:\n` +
+                    RushMcpPluginLoader._formatError(e));
+            }
+            try {
+                await plugin.onInitializeAsync();
+            }
+            catch (e) {
+                throw new Error(`Error occurred in onInitializeAsync() for plugin ${jsonManifest.pluginName}:\n` +
+                    RushMcpPluginLoader._formatError(e));
+            }
+        }
+    }
+}
+RushMcpPluginLoader._rushMcpJsonSchema = JsonSchema.fromLoadedObject(rushMcpJsonSchemaObject);
+RushMcpPluginLoader._rushMcpPluginSchemaObject = JsonSchema.fromLoadedObject(rushMcpPluginSchemaObject);
+//# sourceMappingURL=RushMcpPluginLoader.js.map

package/lib-esm/pluginFramework/RushMcpPluginLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RushMcpPluginLoader.js","sourceRoot":"","sources":["../../src/pluginFramework/RushMcpPluginLoader.ts"],"names":[],"mappings":"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","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 * as path from 'node:path';\n\nimport type { McpServer } from '@modelcontextprotocol/sdk/server/mcp';\n\nimport { FileSystem, Import, JsonFile, type JsonObject, JsonSchema } from '@rushstack/node-core-library';\nimport { Autoinstaller } from '@rushstack/rush-sdk/lib/logic/Autoinstaller';\nimport { RushGlobalFolder } from '@rushstack/rush-sdk/lib/api/RushGlobalFolder';\nimport { RushConfiguration } from '@rushstack/rush-sdk/lib/api/RushConfiguration';\n\nimport type { IRushMcpPlugin, RushMcpPluginFactory } from './IRushMcpPlugin';\nimport { RushMcpPluginSessionInternal } from './RushMcpPluginSession';\nimport rushMcpJsonSchemaObject from '../schemas/rush-mcp.schema.json';\nimport rushMcpPluginSchemaObject from '../schemas/rush-mcp-plugin.schema.json';\n\n/**\n * Configuration for @rushstack/mcp-server in a monorepo.\n * Corresponds to the contents of common/config/rush-mcp/rush-mcp.json\n */\nexport interface IJsonRushMcpConfig {\n  /**\n   * The list of plugins that @rushstack/mcp-server should load when processing this monorepo.\n   */\n  mcpPlugins: IJsonRushMcpPlugin[];\n}\n\n/**\n * Describes a single MCP plugin entry.\n */\nexport interface IJsonRushMcpPlugin {\n  /**\n   * The name of an NPM package that appears in the package.json \"dependencies\" for the autoinstaller.\n   */\n  packageName: string;\n\n  /**\n   * The name of a Rush autoinstaller with this package as its dependency.\n   * @rushstack/mcp-server will ensure this folder is installed before loading the plugin.\n   */\n  autoinstaller: string;\n}\n\n/**\n * Manifest file for a Rush MCP plugin.\n * Every plugin package must contain a \"rush-mcp-plugin.json\" manifest in the top-level folder.\n */\nexport interface IJsonRushMcpPluginManifest {\n  /**\n   * A name that uniquely identifies your plugin.\n   * Generally this should match the NPM package name; two plugins with the same pluginName cannot be loaded together.\n   */\n  pluginName: string;\n\n  /**\n   * Optional. Indicates that your plugin accepts a config file.\n   * The MCP server will load this schema file and provide it to the plugin.\n   * Path is typically `<rush-repo>/common/config/rush-mcp/<plugin-name>.json`.\n   */\n  configFileSchema?: string;\n\n  /**\n   * The module path to the plugin's entry point.\n   * Its default export must be a class implementing the MCP plugin interface.\n   */\n  entryPoint: string;\n}\n\nexport class RushMcpPluginLoader {\n  private static readonly _rushMcpJsonSchema: JsonSchema =\n    JsonSchema.fromLoadedObject(rushMcpJsonSchemaObject);\n  private static readonly _rushMcpPluginSchemaObject: JsonSchema =\n    JsonSchema.fromLoadedObject(rushMcpPluginSchemaObject);\n\n  private readonly _rushWorkspacePath: string;\n  private readonly _mcpServer: McpServer;\n\n  public constructor(rushWorkspacePath: string, mcpServer: McpServer) {\n    this._rushWorkspacePath = rushWorkspacePath;\n    this._mcpServer = mcpServer;\n  }\n\n  private static _formatError(e: Error): string {\n    return e.stack ?? RushMcpPluginLoader._formatError(e);\n  }\n\n  public async loadAsync(): Promise<void> {\n    const rushMcpFilePath: string = path.join(\n      this._rushWorkspacePath,\n      'common/config/rush-mcp/rush-mcp.json'\n    );\n\n    if (!(await FileSystem.existsAsync(rushMcpFilePath))) {\n      return;\n    }\n\n    const rushConfiguration: RushConfiguration = RushConfiguration.loadFromDefaultLocation({\n      startingFolder: this._rushWorkspacePath\n    });\n\n    const jsonRushMcpConfig: IJsonRushMcpConfig = await JsonFile.loadAndValidateAsync(\n      rushMcpFilePath,\n      RushMcpPluginLoader._rushMcpJsonSchema\n    );\n\n    if (jsonRushMcpConfig.mcpPlugins.length === 0) {\n      return;\n    }\n\n    const rushGlobalFolder: RushGlobalFolder = new RushGlobalFolder();\n\n    for (const jsonMcpPlugin of jsonRushMcpConfig.mcpPlugins) {\n      // Ensure the autoinstaller is installed\n      const autoinstaller: Autoinstaller = new Autoinstaller({\n        autoinstallerName: jsonMcpPlugin.autoinstaller,\n        rushConfiguration,\n        rushGlobalFolder,\n        restrictConsoleOutput: false\n      });\n      await autoinstaller.prepareAsync();\n\n      // Load the manifest\n\n      // Suppose the autoinstaller is \"my-autoinstaller\" and the package is \"rush-mcp-example-plugin\".\n      // Then the folder will be:\n      // \"/path/to/my-repo/common/autoinstallers/my-autoinstaller/node_modules/rush-mcp-example-plugin\"\n      const installedPluginPackageFolder: string = await Import.resolvePackageAsync({\n        baseFolderPath: autoinstaller.folderFullPath,\n        packageName: jsonMcpPlugin.packageName\n      });\n\n      const manifestFilePath: string = path.join(installedPluginPackageFolder, 'rush-mcp-plugin.json');\n      if (!(await FileSystem.existsAsync(manifestFilePath))) {\n        throw new Error(\n          'The \"rush-mcp-plugin.json\" manifest file was not found under ' + installedPluginPackageFolder\n        );\n      }\n\n      const jsonManifest: IJsonRushMcpPluginManifest = await JsonFile.loadAndValidateAsync(\n        manifestFilePath,\n        RushMcpPluginLoader._rushMcpPluginSchemaObject\n      );\n\n      let rushMcpPluginOptions: JsonObject = {};\n      if (jsonManifest.configFileSchema) {\n        const mcpPluginSchemaFilePath: string = path.resolve(\n          installedPluginPackageFolder,\n          jsonManifest.configFileSchema\n        );\n        const mcpPluginSchema: JsonSchema = await JsonSchema.fromFile(mcpPluginSchemaFilePath);\n        const rushMcpPluginOptionsFilePath: string = path.resolve(\n          this._rushWorkspacePath,\n          `common/config/rush-mcp/${jsonManifest.pluginName}.json`\n        );\n        // Example: /path/to/my-repo/common/config/rush-mcp/rush-mcp-example-plugin.json\n        rushMcpPluginOptions = await JsonFile.loadAndValidateAsync(\n          rushMcpPluginOptionsFilePath,\n          mcpPluginSchema\n        );\n      }\n\n      const fullEntryPointPath: string = path.join(installedPluginPackageFolder, jsonManifest.entryPoint);\n      let pluginFactory: RushMcpPluginFactory;\n      try {\n        const entryPointModule: { default?: RushMcpPluginFactory } = require(fullEntryPointPath);\n        if (entryPointModule.default === undefined) {\n          throw new Error('The commonJS \"default\" export is missing');\n        }\n        pluginFactory = entryPointModule.default;\n      } catch (e) {\n        throw new Error(\n          `Unable to load plugin entry point at ${fullEntryPointPath}:\\n` +\n            RushMcpPluginLoader._formatError(e)\n        );\n      }\n\n      const session: RushMcpPluginSessionInternal = new RushMcpPluginSessionInternal(this._mcpServer);\n\n      let plugin: IRushMcpPlugin;\n      try {\n        plugin = pluginFactory(session, rushMcpPluginOptions);\n      } catch (e) {\n        throw new Error(\n          `Error invoking entry point for plugin ${jsonManifest.pluginName}:\\n` +\n            RushMcpPluginLoader._formatError(e)\n        );\n      }\n\n      try {\n        await plugin.onInitializeAsync();\n      } catch (e) {\n        throw new Error(\n          `Error occurred in onInitializeAsync() for plugin ${jsonManifest.pluginName}:\\n` +\n            RushMcpPluginLoader._formatError(e)\n        );\n      }\n    }\n  }\n}\n"]}

package/lib-esm/pluginFramework/RushMcpPluginSession.js

@@ -0,0 +1,28 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+import * as zod from 'zod';
+/**
+ * Each plugin gets its own session.
+ *
+ * @public
+ */
+export class RushMcpPluginSession {
+    constructor() {
+        this.zod = zod;
+    }
+}
+export class RushMcpPluginSessionInternal extends RushMcpPluginSession {
+    constructor(mcpServer) {
+        super();
+        this._mcpServer = mcpServer;
+    }
+    registerTool(options, tool) {
+        if (options.description) {
+            this._mcpServer.tool(options.toolName, options.description, tool.schema.shape, tool.executeAsync.bind(tool));
+        }
+        else {
+            this._mcpServer.tool(options.toolName, tool.schema.shape, tool.executeAsync.bind(tool));
+        }
+    }
+}
+//# sourceMappingURL=RushMcpPluginSession.js.map

package/lib-esm/pluginFramework/RushMcpPluginSession.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RushMcpPluginSession.js","sourceRoot":"","sources":["../../src/pluginFramework/RushMcpPluginSession.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,2DAA2D;AAE3D,OAAO,KAAK,GAAG,MAAM,KAAK,CAAC;AAgB3B;;;;GAIG;AACH,MAAM,OAAgB,oBAAoB;IAA1C;QACkB,QAAG,GAAqB,GAAG,CAAC;IAE9C,CAAC;CAAA;AAED,MAAM,OAAO,4BAA6B,SAAQ,oBAAoB;IAGpE,YAAmB,SAAoB;QACrC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;IAC9B,CAAC;IAEe,YAAY,CAAC,OAA6B,EAAE,IAAkB;QAC5E,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YACxB,IAAI,CAAC,UAAU,CAAC,IAAI,CAClB,OAAO,CAAC,QAAQ,EAChB,OAAO,CAAC,WAAW,EACnB,IAAI,CAAC,MAAM,CAAC,KAAK,EACjB,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAC7B,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC1F,CAAC;IACH,CAAC;CACF","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 * as zod from 'zod';\nimport type { McpServer } from '@modelcontextprotocol/sdk/server/mcp';\n\nimport type { IRushMcpTool } from './IRushMcpTool';\nimport type { zodModule } from './zodTypes';\n\n/**\n * Each plugin gets its own session.\n *\n * @public\n */\nexport interface IRegisterToolOptions {\n  toolName: string;\n  description?: string;\n}\n\n/**\n * Each plugin gets its own session.\n *\n * @public\n */\nexport abstract class RushMcpPluginSession {\n  public readonly zod: typeof zodModule = zod;\n  public abstract registerTool(options: IRegisterToolOptions, tool: IRushMcpTool): void;\n}\n\nexport class RushMcpPluginSessionInternal extends RushMcpPluginSession {\n  private readonly _mcpServer: McpServer;\n\n  public constructor(mcpServer: McpServer) {\n    super();\n    this._mcpServer = mcpServer;\n  }\n\n  public override registerTool(options: IRegisterToolOptions, tool: IRushMcpTool): void {\n    if (options.description) {\n      this._mcpServer.tool(\n        options.toolName,\n        options.description,\n        tool.schema.shape,\n        tool.executeAsync.bind(tool)\n      );\n    } else {\n      this._mcpServer.tool(options.toolName, tool.schema.shape, tool.executeAsync.bind(tool));\n    }\n  }\n}\n"]}

package/lib-esm/pluginFramework/zodTypes.js

@@ -0,0 +1,5 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+import { CallToolResultSchema } from '@modelcontextprotocol/sdk/types';
+export { CallToolResultSchema };
+//# sourceMappingURL=zodTypes.js.map

package/lib-esm/pluginFramework/zodTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zodTypes.js","sourceRoot":"","sources":["../../src/pluginFramework/zodTypes.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,2DAA2D;AAG3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAGvE,OAAO,EAAE,oBAAoB,EAAE,CAAC","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 type * as zod from 'zod';\nimport { CallToolResultSchema } from '@modelcontextprotocol/sdk/types';\n\nexport type { zod as zodModule };\nexport { CallToolResultSchema };\n\n/**\n * @public\n */\nexport type CallToolResult = zod.infer<typeof CallToolResultSchema>;\n"]}

package/lib-esm/schemas/rush-mcp-plugin.schema.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Rush MCP Plugin Manifest",
+  "type": "object",
+  "properties": {
+    "pluginName": {
+      "type": "string",
+      "description": "A name that uniquely identifies your plugin. Generally this should match the NPM package name; two plugins with the same pluginName cannot be loaded together."
+    },
+    "configFileSchema": {
+      "type": "string",
+      "description": "Optional. Indicates that your plugin accepts a config file. The MCP server will load this schema file and provide it to the plugin. Path is typically `<rush-repo>/common/config/rush-mcp/<plugin-name>.json`."
+    },
+    "entryPoint": {
+      "type": "string",
+      "description": "The module path to the plugin's entry point. Its default export must be a class implementing the MCP plugin interface."
+    }
+  },
+  "required": ["pluginName", "entryPoint"],
+  "additionalProperties": false
+}

package/lib-esm/schemas/rush-mcp.schema.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "rush-mcp.json Configuration Schema",
+  "type": "object",
+  "properties": {
+    "mcpPlugins": {
+      "type": "array",
+      "description": "The list of plugins that `@rushstack/mcp-server` should load when processing this monorepo.",
+      "items": {
+        "type": "object",
+        "properties": {
+          "packageName": {
+            "type": "string",
+            "description": "The name of an NPM package that appears in the package.json \"dependencies\" for the autoinstaller."
+          },
+          "autoinstaller": {
+            "type": "string",
+            "description": "The name of a Rush autoinstaller with this package as its dependency."
+          }
+        },
+        "required": ["packageName", "autoinstaller"],
+        "additionalProperties": false
+      }
+    }
+  },
+  "required": ["mcpPlugins"],
+  "additionalProperties": false
+}

package/lib-esm/server.js

@@ -0,0 +1,35 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { RushConflictResolverTool, RushMigrateProjectTool, RushCommandValidatorTool, RushWorkspaceDetailsTool, RushProjectDetailsTool } from './tools';
+import { RushMcpPluginLoader } from './pluginFramework/RushMcpPluginLoader';
+export class RushMCPServer extends McpServer {
+    constructor(rushWorkspacePath) {
+        super({
+            name: 'rush',
+            version: '1.0.0'
+        });
+        this._tools = [];
+        this._rushWorkspacePath = rushWorkspacePath;
+        this._pluginLoader = new RushMcpPluginLoader(this._rushWorkspacePath, this);
+    }
+    async startAsync() {
+        this._initializeTools();
+        this._registerTools();
+        await this._pluginLoader.loadAsync();
+    }
+    _initializeTools() {
+        this._tools.push(new RushConflictResolverTool());
+        this._tools.push(new RushMigrateProjectTool(this._rushWorkspacePath));
+        this._tools.push(new RushCommandValidatorTool());
+        this._tools.push(new RushWorkspaceDetailsTool());
+        this._tools.push(new RushProjectDetailsTool());
+    }
+    _registerTools() {
+        process.chdir(this._rushWorkspacePath);
+        for (const tool of this._tools) {
+            tool.register(this);
+        }
+    }
+}
+//# sourceMappingURL=server.js.map

package/lib-esm/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,2DAA2D;AAE3D,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAEL,wBAAwB,EACxB,sBAAsB,EACtB,wBAAwB,EACxB,wBAAwB,EACxB,sBAAsB,EACvB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAE5E,MAAM,OAAO,aAAc,SAAQ,SAAS;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,mBAAmB,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,wBAAwB,EAAE,CAAC,CAAC;QACjD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,sBAAsB,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC;QACtE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,wBAAwB,EAAE,CAAC,CAAC;QACjD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,wBAAwB,EAAE,CAAC,CAAC;QACjD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,sBAAsB,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","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';\n\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-esm/start.js

@@ -0,0 +1,33 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+import * as path from 'node:path';
+import * as process from 'node:process';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { FileSystem } from '@rushstack/node-core-library';
+import { RushSdkLoader } from '@rushstack/rush-sdk/loader';
+import { log } from './utilities/log';
+const main = async () => {
+    const rushWorkspacePath = process.argv[2];
+    if (!rushWorkspacePath) {
+        throw new Error('Please provide workspace root path as the first argument');
+    }
+    const rushWorkspaceFullPath = path.resolve(rushWorkspacePath);
+    if (!(await FileSystem.existsAsync(rushWorkspaceFullPath))) {
+        throw new Error('The specified workspace root path does not exist:\n  ' + JSON.stringify(rushWorkspacePath));
+    }
+    // Load rush-sdk from the specified repository
+    await RushSdkLoader.loadAsync({
+        rushJsonSearchFolder: rushWorkspaceFullPath
+    });
+    const RushMCPServerClass = (await import('./server')).RushMCPServer;
+    const server = new RushMCPServerClass(rushWorkspaceFullPath);
+    await server.startAsync();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    log('Rush MCP Server running on stdio');
+};
+main().catch((error) => {
+    log('Fatal error running server:', error instanceof Error ? error.message : error);
+    process.exit(1);
+});
+//# sourceMappingURL=start.js.map

package/lib-esm/start.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.js","sourceRoot":"","sources":["../src/start.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,2DAA2D;AAE3D,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AAExC,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE3D,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAGtC,MAAM,IAAI,GAAG,KAAK,IAAmB,EAAE;IACrC,MAAM,iBAAiB,GAAuB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC9D,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;IAC9E,CAAC;IAED,MAAM,qBAAqB,GAAW,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAEtE,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,WAAW,CAAC,qBAAqB,CAAC,CAAC,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CACb,uDAAuD,GAAG,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAC5F,CAAC;IACJ,CAAC;IAED,8CAA8C;IAC9C,MAAM,aAAa,CAAC,SAAS,CAAC;QAC5B,oBAAoB,EAAE,qBAAqB;KAC5C,CAAC,CAAC;IAEH,MAAM,kBAAkB,GAAyB,CAAC,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,aAAa,CAAC;IAE1F,MAAM,MAAM,GAAkB,IAAI,kBAAkB,CAAC,qBAAqB,CAAC,CAAC;IAC5E,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC;IAC1B,MAAM,SAAS,GAAyB,IAAI,oBAAoB,EAAE,CAAC;IACnE,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,GAAG,CAAC,kCAAkC,CAAC,CAAC;AAC1C,CAAC,CAAC;AAEF,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,GAAG,CAAC,6BAA6B,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACnF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC","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 * as path from 'node:path';\nimport * as process from 'node:process';\n\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';\n\nimport { FileSystem } from '@rushstack/node-core-library';\nimport { RushSdkLoader } from '@rushstack/rush-sdk/loader';\n\nimport { log } from './utilities/log';\nimport type { RushMCPServer } from './server';\n\nconst main = async (): Promise<void> => {\n  const rushWorkspacePath: string | undefined = process.argv[2];\n  if (!rushWorkspacePath) {\n    throw new Error('Please provide workspace root path as the first argument');\n  }\n\n  const rushWorkspaceFullPath: string = path.resolve(rushWorkspacePath);\n\n  if (!(await FileSystem.existsAsync(rushWorkspaceFullPath))) {\n    throw new Error(\n      'The specified workspace root path does not exist:\\n  ' + JSON.stringify(rushWorkspacePath)\n    );\n  }\n\n  // Load rush-sdk from the specified repository\n  await RushSdkLoader.loadAsync({\n    rushJsonSearchFolder: rushWorkspaceFullPath\n  });\n\n  const RushMCPServerClass: typeof RushMCPServer = (await import('./server')).RushMCPServer;\n\n  const server: RushMCPServer = new RushMCPServerClass(rushWorkspaceFullPath);\n  await server.startAsync();\n  const transport: StdioServerTransport = new StdioServerTransport();\n  await server.connect(transport);\n\n  log('Rush MCP Server running on stdio');\n};\n\nmain().catch((error) => {\n  log('Fatal error running server:', error instanceof Error ? error.message : error);\n  process.exit(1);\n});\n"]}

package/lib-esm/tools/base.tool.js

@@ -0,0 +1,29 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+export class BaseTool {
+    constructor(options) {
+        this._options = options;
+    }
+    register(server) {
+        // TODO: remove ts-ignore
+        // @ts-ignore
+        server.tool(this._options.name, this._options.description, this._options.schema, async (...args) => {
+            try {
+                const result = await this.executeAsync(...args);
+                return result;
+            }
+            catch (error) {
+                return {
+                    isError: true,
+                    content: [
+                        {
+                            type: 'text',
+                            text: error instanceof Error ? error.message : error
+                        }
+                    ]
+                };
+            }
+        });
+    }
+}
+//# sourceMappingURL=base.tool.js.map

package/lib-esm/tools/base.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.tool.js","sourceRoot":"","sources":["../../src/tools/base.tool.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,2DAA2D;AA4B3D,MAAM,OAAgB,QAAQ;IAG5B,YAAsB,OAA+B;QACnD,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC1B,CAAC;IAIM,QAAQ,CAAC,MAAiB;QAC/B,yBAAyB;QACzB,aAAa;QACb,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,EAAE;YACjG,IAAI,CAAC;gBACH,MAAM,MAAM,GAAmB,MAAM,IAAI,CAAC,YAAY,CAAC,GAAI,IAAuC,CAAC,CAAC;gBACpG,OAAO,MAAM,CAAC;YAChB,CAAC;YAAC,OAAO,KAAc,EAAE,CAAC;gBACxB,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK;yBACrD;qBACF;iBACF,CAAC;YACJ,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;CACF","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 type { McpServer } from '@modelcontextprotocol/sdk/server/mcp';\nimport type { RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol';\nimport type {\n  CallToolResultSchema,\n  ServerNotification,\n  ServerRequest\n} from '@modelcontextprotocol/sdk/types';\nimport type { z, ZodRawShape, ZodTypeAny } from 'zod';\n\nexport type CallToolResult = z.infer<typeof CallToolResultSchema>;\n\ntype ToolCallback<Args extends undefined | ZodRawShape = undefined> = Args extends ZodRawShape\n  ? (\n      args: z.objectOutputType<Args, ZodTypeAny>,\n      extra: RequestHandlerExtra<ServerRequest, ServerNotification>\n    ) => CallToolResult | Promise<CallToolResult>\n  : (\n      extra: RequestHandlerExtra<ServerRequest, ServerNotification>\n    ) => CallToolResult | Promise<CallToolResult>;\n\nexport interface IBaseToolOptions<Args extends ZodRawShape = ZodRawShape> {\n  name: string;\n  description: string;\n  schema: Args;\n}\n\nexport abstract class BaseTool<Args extends ZodRawShape = ZodRawShape> {\n  private _options: IBaseToolOptions<Args>;\n\n  protected constructor(options: IBaseToolOptions<Args>) {\n    this._options = options;\n  }\n\n  protected abstract executeAsync(...args: Parameters<ToolCallback<Args>>): ReturnType<ToolCallback<Args>>;\n\n  public register(server: McpServer): void {\n    // TODO: remove ts-ignore\n    // @ts-ignore\n    server.tool(this._options.name, this._options.description, this._options.schema, async (...args) => {\n      try {\n        const result: CallToolResult = await this.executeAsync(...(args as Parameters<ToolCallback<Args>>));\n        return result;\n      } catch (error: unknown) {\n        return {\n          isError: true,\n          content: [\n            {\n              type: 'text',\n              text: error instanceof Error ? error.message : error\n            }\n          ]\n        };\n      }\n    });\n  }\n}\n"]}

package/lib-esm/tools/conflict-resolver.tool.js

@@ -0,0 +1,48 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+import { z } from 'zod';
+import { CommandRunner } from '../utilities/command-runner';
+import { getRushConfiguration } from '../utilities/common';
+import { BaseTool } from './base.tool';
+export class RushConflictResolverTool extends BaseTool {
+    constructor() {
+        super({
+            name: 'rush_pnpm_lock_file_conflict_resolver',
+            description: 'If a user requests to resolve a pnpm-lock.yaml file conflict, use this tool to automatically fix the conflict directly.',
+            schema: {
+                lockfilePath: z.string().describe('The path to the pnpm-lock.yaml file, should pass absolute path')
+            }
+        });
+    }
+    _tryGetSubspaceNameFromLockfilePath(lockfilePath, rushConfiguration) {
+        for (const subspace of rushConfiguration.subspaces) {
+            const folderPath = subspace.getSubspaceConfigFolderPath();
+            if (lockfilePath.startsWith(folderPath)) {
+                return subspace.subspaceName;
+            }
+        }
+        return null;
+    }
+    async executeAsync({ lockfilePath }) {
+        const rushConfiguration = await getRushConfiguration();
+        const subspaceName = this._tryGetSubspaceNameFromLockfilePath(lockfilePath, rushConfiguration);
+        if (!subspaceName) {
+            throw new Error('subspace name not found');
+        }
+        const options = {
+            stdio: 'inherit',
+            currentWorkingDirectory: rushConfiguration.rushJsonFolder
+        };
+        await CommandRunner.runGitCommandAsync(['checkout', '--theirs', lockfilePath], options);
+        await CommandRunner.runRushCommandAsync(['update', '--subspace', subspaceName], options);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: 'Conflict resolved successfully'
+                }
+            ]
+        };
+    }
+}
+//# sourceMappingURL=conflict-resolver.tool.js.map

package/lib-esm/tools/conflict-resolver.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conflict-resolver.tool.js","sourceRoot":"","sources":["../../src/tools/conflict-resolver.tool.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,2DAA2D;AAE3D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAuB,MAAM,aAAa,CAAC;AAE5D,MAAM,OAAO,wBAAyB,SAAQ,QAAQ;IACpD;QACE,KAAK,CAAC;YACJ,IAAI,EAAE,uCAAuC;YAC7C,WAAW,EACT,yHAAyH;YAC3H,MAAM,EAAE;gBACN,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gEAAgE,CAAC;aACpG;SACF,CAAC,CAAC;IACL,CAAC;IAEO,mCAAmC,CACzC,YAAoB,EACpB,iBAAoC;QAEpC,KAAK,MAAM,QAAQ,IAAI,iBAAiB,CAAC,SAAS,EAAE,CAAC;YACnD,MAAM,UAAU,GAAW,QAAQ,CAAC,2BAA2B,EAAE,CAAC;YAClE,IAAI,YAAY,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;gBACxC,OAAO,QAAQ,CAAC,YAAY,CAAC;YAC/B,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,KAAK,CAAC,YAAY,CAAC,EAAE,YAAY,EAA4B;QAClE,MAAM,iBAAiB,GAAsB,MAAM,oBAAoB,EAAE,CAAC;QAC1E,MAAM,YAAY,GAAkB,IAAI,CAAC,mCAAmC,CAC1E,YAAY,EACZ,iBAAiB,CAClB,CAAC;QACF,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC7C,CAAC;QAED,MAAM,OAAO,GAAgC;YAC3C,KAAK,EAAE,SAAS;YAChB,uBAAuB,EAAE,iBAAiB,CAAC,cAAc;SAC1D,CAAC;QACF,MAAM,aAAa,CAAC,kBAAkB,CAAC,CAAC,UAAU,EAAE,UAAU,EAAE,YAAY,CAAC,EAAE,OAAO,CAAC,CAAC;QACxF,MAAM,aAAa,CAAC,mBAAmB,CAAC,CAAC,QAAQ,EAAE,YAAY,EAAE,YAAY,CAAC,EAAE,OAAO,CAAC,CAAC;QAEzF,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,gCAAgC;iBACvC;aACF;SACF,CAAC;IACJ,CAAC;CACF","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';\n\nimport type { RushConfiguration } from '@rushstack/rush-sdk';\nimport type { IExecutableSpawnSyncOptions } from '@rushstack/node-core-library';\n\nimport { CommandRunner } from '../utilities/command-runner';\nimport { getRushConfiguration } from '../utilities/common';\nimport { BaseTool, type CallToolResult } from './base.tool';\n\nexport class RushConflictResolverTool extends BaseTool {\n  public constructor() {\n    super({\n      name: 'rush_pnpm_lock_file_conflict_resolver',\n      description:\n        'If a user requests to resolve a pnpm-lock.yaml file conflict, use this tool to automatically fix the conflict directly.',\n      schema: {\n        lockfilePath: z.string().describe('The path to the pnpm-lock.yaml file, should pass absolute path')\n      }\n    });\n  }\n\n  private _tryGetSubspaceNameFromLockfilePath(\n    lockfilePath: string,\n    rushConfiguration: RushConfiguration\n  ): string | null {\n    for (const subspace of rushConfiguration.subspaces) {\n      const folderPath: string = subspace.getSubspaceConfigFolderPath();\n      if (lockfilePath.startsWith(folderPath)) {\n        return subspace.subspaceName;\n      }\n    }\n    return null;\n  }\n\n  public async executeAsync({ lockfilePath }: { lockfilePath: string }): Promise<CallToolResult> {\n    const rushConfiguration: RushConfiguration = await getRushConfiguration();\n    const subspaceName: string | null = this._tryGetSubspaceNameFromLockfilePath(\n      lockfilePath,\n      rushConfiguration\n    );\n    if (!subspaceName) {\n      throw new Error('subspace name not found');\n    }\n\n    const options: IExecutableSpawnSyncOptions = {\n      stdio: 'inherit',\n      currentWorkingDirectory: rushConfiguration.rushJsonFolder\n    };\n    await CommandRunner.runGitCommandAsync(['checkout', '--theirs', lockfilePath], options);\n    await CommandRunner.runRushCommandAsync(['update', '--subspace', subspaceName], options);\n\n    return {\n      content: [\n        {\n          type: 'text',\n          text: 'Conflict resolved successfully'\n        }\n      ]\n    };\n  }\n}\n"]}

package/lib-esm/tools/index.js

@@ -0,0 +1,9 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+export { BaseTool } from './base.tool';
+export { RushMigrateProjectTool } from './migrate-project.tool';
+export { RushProjectDetailsTool } from './project-details.tool';
+export { RushCommandValidatorTool } from './rush-command-validator.tool';
+export { RushWorkspaceDetailsTool } from './workspace-details';
+export { RushConflictResolverTool } from './conflict-resolver.tool';
+//# sourceMappingURL=index.js.map

package/lib-esm/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,2DAA2D;AAE3D,OAAO,EAAE,QAAQ,EAA8C,MAAM,aAAa,CAAC;AACnF,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC","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 { BaseTool, type IBaseToolOptions, type CallToolResult } from './base.tool';\nexport { RushMigrateProjectTool } from './migrate-project.tool';\nexport { RushProjectDetailsTool } from './project-details.tool';\nexport { RushCommandValidatorTool } from './rush-command-validator.tool';\nexport { RushWorkspaceDetailsTool } from './workspace-details';\nexport { RushConflictResolverTool } from './conflict-resolver.tool';\n"]}