@azure-devops/mcp 2.9.0 → 2.10.0-nightly.20260909

package/README.md

@@ -1,27 +1,32 @@
-# ⭐ Azure DevOps MCP Server
+# Azure DevOps MCP Server
 
-> [!IMPORTANT]
-> We recommend using the [Remote MCP Server](https://learn.microsoft.com/en-us/azure/devops/mcp-server/remote-mcp-server) instead of this local server. It requires no installation and gets new features first.
+> [!WARNING]
+> We recently completed a full tool consolidation that includes renaming of existing tools. Please see the [Toolset documentation](docs/TOOLSET.md) for the complete list of new tool names.
 >
-> [Learn more](#-remote-mcp-server-recommended)
-
-This project provides Azure DevOps MCP tooling for AI agents, with a **remote-first** onboarding experience and a local server option when you need it.
+> If this is a breaking change for your agents or skills, you can temporarily pin the version to `@azure-devops/mcp@2.8.1`
 
-## 📄 Table of Contents
+This project gives AI agents access to Azure DevOps through the Model Context Protocol (MCP). Use the hosted remote server for the simplest setup, or run the local server when you need a `stdio` connection.
 
-1. [📺 Overview](#-overview)
-2. [🏆 Expectations](#-expectations)
-3. [🚀 Remote MCP Server (Recommended)](#-remote-mcp-server-recommended)
-4. [⚙️ Supported Tools](#️-supported-tools)
-5. [🔌 Local MCP Server Installation (Optional)](#-local-mcp-server-installation-optional)
-6. [🌏 Using Domains (local)](#-using-domains-local)
-7. [🐥 Project and Team Defaults (local)](#-project-and-team-defaults-local)
-8. [📝 Troubleshooting](#-troubleshooting)
-9. [🎩 Examples & Best Practices](#-examples--best-practices)
-10. [🙋‍♀️ Frequently Asked Questions](#️-frequently-asked-questions)
-11. [📌 Contributing](#-contributing)
+## Table of Contents
 
-## 📺 Overview
+> [!IMPORTANT]
+> We recommend using the [Remote MCP Server](https://learn.microsoft.com/en-us/azure/devops/mcp-server/remote-mcp-server) instead of this local server. It requires no installation and gets new features first.
+>
+> [Learn more](#remote-mcp-server-recommended)
+
+1. [Overview](#overview)
+2. [Design](#design)
+3. [Remote MCP Server (Recommended)](#remote-mcp-server-recommended)
+4. [Supported Tools](#supported-tools)
+5. [Local MCP Server Installation (Optional)](#local-mcp-server-installation-optional)
+6. [Using Domains (Local Server)](#using-domains-local-server)
+7. [Project and Team Defaults (Local Server)](#project-and-team-defaults-local-server)
+8. [Troubleshooting](#troubleshooting)
+9. [Examples and Best Practices](#examples-and-best-practices)
+10. [Frequently Asked Questions](#frequently-asked-questions)
+11. [Contributing](#contributing)
+
+## Overview
 
 The Azure DevOps MCP Server brings Azure DevOps context to your agents. Try prompts like:
 
@@ -38,23 +43,21 @@ The Azure DevOps MCP Server brings Azure DevOps context to your agents. Try prom
 - "Update the wiki page '/Getting Started' with new onboarding instructions"
 - "Get the content of the wiki page '/API/Authentication' from the Documentation wiki"
 
-## 🏆 Expectations
+## Design
 
-The Azure DevOps MCP Server is built around tools that are concise, simple, focused, and easy to use, with each one designed for a specific scenario. We intentionally avoid creating complex tools that try to do too much. The goal is to provide a thin abstraction layer over the REST APIs that makes data access straightforward while allowing the language model to handle the more complex reasoning.
+Each tool handles a focused Azure DevOps task. The server provides a thin layer over the REST APIs, while the AI agent handles higher-level reasoning.
 
-## 🚀 Remote MCP Server (Recommended)
+## Remote MCP Server (Recommended)
 
 For complete instructions, see the [Remote MCP Server onboarding documentation](https://learn.microsoft.com/en-us/azure/devops/mcp-server/remote-mcp-server?view=azure-devops).
 
-Over time, the Remote MCP Server will replace this local MCP Server. We will continue to support the local server for now, but future investments will primarily focus on the remote experience.
-
-We encourage all users of the local MCP Server to begin migrating to the Remote MCP Server.
+The remote server will eventually replace the local server. The local server remains supported, but new development will focus on the remote server. Existing local server users should begin planning their migration.
 
 If you encounter issues with tools, need support, or have a feature request, you can report an issue using the [Remote MCP Server issue template](https://github.com/microsoft/azure-devops-mcp/issues/new?template=remote-mcp-server-issue.md). During the preview period, we will track Remote MCP Server issues through this repository.
 
-### Quick start with `.vscode/mcp.json`
+### Quick Start
 
-Use this configuration to connect directly to the Azure DevOps-hosted endpoint using streamable HTTP transport:
+Create `.vscode/mcp.json` in your project and add this configuration. Replace `{organization}` with your Azure DevOps organization name.
 
 ```json
 {
@@ -68,42 +71,35 @@ Use this configuration to connect directly to the Azure DevOps-hosted endpoint u
 }
 ```
 
-See [documentation](https://learn.microsoft.com/en-us/azure/devops/mcp-server/remote-mcp-server?view=azure-devops#mcpjson-configuration) for additional configuration options.
+See the [remote server configuration documentation](https://learn.microsoft.com/en-us/azure/devops/mcp-server/remote-mcp-server?view=azure-devops#mcpjson-configuration) for more options.
 
 After saving `.vscode/mcp.json`, start the server from the MCP view in VS Code, then run a prompt like `List ADO projects`.
 
-## ⚙️ Supported Tools
+## Supported Tools
 
 See the [Available Tools](https://learn.microsoft.com/en-us/azure/devops/mcp-server/remote-mcp-server?view=azure-devops#available-tools) documentation for the complete list of available remote tools.
 
-For a comprehensive list of local tools, see [TOOLSET.md](./docs/TOOLSET.md).
+For the complete list of local tools, see [TOOLSET.md](./docs/TOOLSET.md).
 
-## 🔌 Local MCP Server Installation (Optional)
+## Local MCP Server Installation (Optional)
 
 > [!IMPORTANT]
 > Start with the Remote MCP Server first. Use the local MCP Server only if your scenario specifically requires a local `stdio` setup.
 
-Use this section if you specifically need the local `stdio` server experience. For most users, start with the [Remote MCP Server](#-remote-mcp-server-recommended) section above.
-
-For the best experience, use Visual Studio Code and GitHub Copilot. See the [getting started documentation](./docs/GETTINGSTARTED.md) to use our MCP Server with other tools such as Visual Studio 2022, Codex, Claude Code, Cursor, Opencode, and Kilocode.
+These steps use Visual Studio Code and GitHub Copilot. For other supported clients, including Visual Studio 2022, Codex, Claude Code, Cursor, OpenCode, and Kilo Code, see the [getting started guide](./docs/GETTINGSTARTED.md).
 
 ### Prerequisites
 
-1. Install [VS Code](https://code.visualstudio.com/download) or [VS Code Insiders](https://code.visualstudio.com/insiders)
-2. Install [Node.js](https://nodejs.org/en/download) 20+
-3. Open VS Code in an empty folder
+1. Install [VS Code](https://code.visualstudio.com/download) or [VS Code Insiders](https://code.visualstudio.com/insiders).
+2. Install [Node.js 20 or later](https://nodejs.org/en/download).
+3. Open your project in VS Code.
 
 ### Installation
 
-#### 🧨 Install from Public Feed
-
-This installation method is the easiest for all users of Visual Studio Code.
-
-🎥 [Watch this quick start video to get up and running in under two minutes!](https://youtu.be/EUmFM6qXoYk)
+#### Install from npm
 
-##### Steps
-
-In your project, add a `.vscode\mcp.json` file with the following content:
+1. Create `.vscode/mcp.json` in your project.
+2. Add this configuration:
 
 ```json
 {
@@ -124,49 +120,24 @@ In your project, add a `.vscode\mcp.json` file with the following content:
 }
 ```
 
-🔥 To stay up to date with the latest features, you can use our nightly builds. Simply update your `mcp.json` configuration to use `@azure-devops/mcp@next`. Here is an updated example:
+3. Save the file, then start the `ado` server from the MCP view in VS Code.
+4. Open GitHub Copilot Chat and switch to [Agent mode](https://code.visualstudio.com/blogs/2025/02/24/introducing-copilot-agent-mode).
+5. Select the Azure DevOps tools, then try a prompt such as `List ADO projects`.
+6. When prompted, sign in with a Microsoft account that has access to the selected Azure DevOps organization.
 
-```json
-{
-  "inputs": [
-    {
-      "id": "ado_org",
-      "type": "promptString",
-      "description": "Azure DevOps organization name  (e.g. 'contoso')"
-    }
-  ],
-  "servers": {
-    "ado": {
-      "type": "stdio",
-      "command": "npx",
-      "args": ["-y", "@azure-devops/mcp@next", "${input:ado_org}"]
-    }
-  }
-}
-```
-
-Save the file, then click 'Start'.
-
-![start mcp server](./docs/media/start-mcp-server.gif)
+To use nightly builds, replace `@azure-devops/mcp` with `@azure-devops/mcp@next` in the configuration.
 
-In chat, switch to [Agent Mode](https://code.visualstudio.com/blogs/2025/02/24/introducing-copilot-agent-mode).
+For better tool selection, add `.github/copilot-instructions.md` to your project with this instruction:
 
-Click "Select Tools" and choose the available tools.
-
-![configure mcp server tools](./docs/media/configure-mcp-server-tools.gif)
-
-Open GitHub Copilot Chat and try a prompt like `List ADO projects`. The first time an ADO tool is executed browser will open prompting to login with your Microsoft account. Please ensure you are using credentials matching selected Azure DevOps organization.
-
-> 💥 We strongly recommend creating a `.github\copilot-instructions.md` in your project. This will enhance your experience using the Azure DevOps MCP Server with GitHub Copilot Chat.
-> To start, just include "`This project uses Azure DevOps. Always check to see if the Azure DevOps MCP server has a tool relevant to the user's request`" in your copilot instructions file.
-
-See the [getting started documentation](./docs/GETTINGSTARTED.md) to use our MCP Server with other tools such as Visual Studio 2022, Codex, Claude Code, and Cursor.
+```text
+This project uses Azure DevOps. Always check whether the Azure DevOps MCP server has a tool relevant to the user's request.
+```
 
-## 🌏 Using Domains (local)
+## Using Domains (Local Server)
 
-Azure DevOps exposes a large surface area. As a result, our Azure DevOps MCP Server includes many tools. To keep the toolset manageable, avoid confusing the model, and respect client limits on loaded tools, use Domains to load only the areas you need. Domains are named groups of related tools (for example: core, work, work-items, repositories, wiki). Add the `-d` argument and the domain names to the server args in your `mcp.json` to list the domains to enable.
+The local server includes many tools. Domains let you load only the tool groups you need, which keeps the tool list manageable and helps clients with tool limits. Available domains are `core`, `work`, `work-items`, `search`, `test-plans`, `repositories`, `wiki`, `pipelines`, and `advanced-security`.
 
-For example, use `"-d", "core", "work", "work-items"` to load only Work Item related tools (see the example below).
+Add `-d` followed by the domains to the server arguments. For example, this configuration loads only work item-related tools:
 
 ```json
 {
@@ -187,15 +158,13 @@ For example, use `"-d", "core", "work", "work-items"` to load only Work Item rel
 }
 ```
 
-Domains that are available are: `core`, `work`, `work-items`, `search`, `test-plans`, `repositories`, `wiki`, `pipelines`, `advanced-security`
+Always include `core` so the agent can retrieve project information.
 
-We recommend that you always enable `core` tools so that you can fetch project level information.
+> If you omit `-d`, the server loads all domains.
 
-> By default all domains are loaded
+## Project and Team Defaults (Local Server)
 
-## 🐥 Project and Team Defaults (local)
-
-You can also configure default Azure DevOps project and team values from `.vscode/mcp.json` using `project` and `team`, so tools can skip selection prompts.
+Set default Azure DevOps project and team values in `.vscode/mcp.json` so tools can skip selection prompts.
 
 ### Example `.vscode/mcp.json`
 
@@ -215,43 +184,37 @@ You can also configure default Azure DevOps project and team values from `.vscod
 }
 ```
 
-## 📝 Troubleshooting
+## Troubleshooting
 
 See the [Troubleshooting guide](./docs/TROUBLESHOOTING.md) for help with common issues and logging.
 
-## 🎩 Examples & Best Practices
-
-Explore example prompts in our [Examples documentation](./docs/EXAMPLES.md).
+## Examples
 
-For best practices and tips to enhance your experience with the MCP Server, refer to the [How-To guide](./docs/HOWTO.md).
+See the [examples](./docs/EXAMPLES.md) for sample prompts.
 
-## 🙋‍♀️ Frequently Asked Questions
+## Frequently Asked Questions
 
 For answers to common questions about the Azure DevOps MCP Server, see the [Frequently Asked Questions](./docs/FAQ.md).
 
-## 📌 Contributing
+## Contributing
 
-We welcome contributions! During preview, please file issues for bugs, enhancements, or documentation improvements.
+We welcome contributions. During preview, file issues for bugs, enhancements, or documentation improvements.
 
 See our [Contributions Guide](./CONTRIBUTING.md) for:
 
-- 🛠️ Development setup
-- ✨ Adding new tools
-- 📝 Code style & testing
-- 🔄 Pull request process
+- Development setup
+- Adding new tools
+- Code style and testing
+- Pull request process
 
-> ⚠️ Please read the [Contributions Guide](./CONTRIBUTING.md) before creating a pull request.
+Read the [Contributions Guide](./CONTRIBUTING.md) before creating a pull request.
 
-## 🤝 Code of Conduct
+## Code of Conduct
 
 This project follows the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
 For questions, see the [FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [open@microsoft.com](mailto:open@microsoft.com).
 
-## 📈 Project Stats
-
-[![Star History Chart](https://api.star-history.com/svg?repos=microsoft/azure-devops-mcp&type=Date)](https://star-history.com/#microsoft/azure-devops-mcp)
-
-## 🏆 Hall of Fame
+## Hall of Fame
 
 Thanks to all contributors who make this project awesome! ❤️
 

package/dist/auth.js

@@ -2,15 +2,41 @@
 // Licensed under the MIT License.
 import { AzureCliCredential, ChainedTokenCredential, DefaultAzureCredential } from "@azure/identity";
 import { PublicClientApplication } from "@azure/msal-node";
+import { NativeBrokerPlugin } from "@azure/msal-node-extensions";
 import open from "open";
 import { logger } from "./logger.js";
 const scopes = ["499b84ac-1321-427f-aa17-267ca6975798/.default"];
+const patAllowedHosts = new Set(["dev.azure.com", "vssps.dev.azure.com", "almsearch.dev.azure.com"]);
+function isPatAllowedHost(hostname) {
+    const normalizedHostname = hostname.toLowerCase();
+    return patAllowedHosts.has(normalizedHostname) || normalizedHostname.endsWith(".visualstudio.com");
+}
+function installPatFetchInterceptor(basicValue) {
+    const originalFetch = globalThis.fetch;
+    const patBearerValue = `Bearer ${basicValue}`;
+    globalThis.fetch = async (input, init) => {
+        const headers = new Headers(init?.headers ?? (input instanceof Request ? input.headers : undefined));
+        if (headers.get("Authorization") !== patBearerValue) {
+            return originalFetch(input, init);
+        }
+        const requestUrl = new URL(input instanceof Request ? input.url : input.toString());
+        if (requestUrl.protocol !== "https:" || !isPatAllowedHost(requestUrl.hostname)) {
+            throw new Error(`Refusing to send a Personal Access Token to untrusted destination '${requestUrl.origin}'`);
+        }
+        headers.set("Authorization", `Basic ${basicValue}`);
+        if (input instanceof Request) {
+            return originalFetch(new Request(input, { ...init, headers }));
+        }
+        return originalFetch(input, { ...init, headers });
+    };
+}
 class OAuthAuthenticator {
     static clientId = "0d50963b-7bb9-4fe7-94c7-a99af00b5136";
     static defaultAuthority = "https://login.microsoftonline.com/common";
     static zeroTenantId = "00000000-0000-0000-0000-000000000000";
     accountId;
     publicClientApp;
+    publicClientAppFallback;
     constructor(tenantId) {
         this.accountId = null;
         let authority = OAuthAuthenticator.defaultAuthority;
@@ -26,6 +52,22 @@ class OAuthAuthenticator {
                 clientId: OAuthAuthenticator.clientId,
                 authority,
             },
+            broker: {
+                nativeBrokerPlugin: new NativeBrokerPlugin(),
+            },
+            system: {
+                loggerOptions: {
+                    loggerCallback: (level, message) => {
+                        logger.debug(`MSALClient[${level}]: ${message}`);
+                    },
+                },
+            },
+        });
+        this.publicClientAppFallback = new PublicClientApplication({
+            auth: {
+                clientId: OAuthAuthenticator.clientId,
+                authority,
+            },
         });
         logger.debug(`OAuthAuthenticator: Initialized with clientId='${OAuthAuthenticator.clientId}'`);
     }
@@ -50,17 +92,35 @@ class OAuthAuthenticator {
         }
         if (!authResult) {
             logger.debug(`OAuthAuthenticator: Starting interactive token acquisition`);
-            authResult = await this.publicClientApp.acquireTokenInteractive({
+            try {
+                authResult = await this.publicClientApp.acquireTokenInteractive({
+                    scopes,
+                    openBrowser: async (url) => {
+                        logger.debug(`OAuthAuthenticator: Opening browser for authentication with target URL: ${url}`);
+                        open(url);
+                    },
+                });
+                this.accountId = authResult.account;
+                logger.debug(`OAuthAuthenticator: Successfully acquired token interactively, account cached`);
+            }
+            catch (error) {
+                const msalErrorMessage = error.platformBrokerError ? JSON.stringify(error.platformBrokerError) : "";
+                logger.debug(`OAuthAuthenticator: Interactive token acquisition failed: ${error instanceof Error ? error.message + msalErrorMessage : String(error)}`);
+                authResult = null;
+            }
+        }
+        if (!authResult) {
+            logger.debug(`OAuthAuthenticator: Starting interactive token acquisition without broker`);
+            authResult = await this.publicClientAppFallback.acquireTokenInteractive({
                 scopes,
                 openBrowser: async (url) => {
-                    logger.debug(`OAuthAuthenticator: Opening browser for authentication`);
+                    logger.debug(`OAuthAuthenticator: Opening browser for authentication with target URL: ${url}`);
                     open(url);
                 },
             });
-            this.accountId = authResult.account;
-            logger.debug(`OAuthAuthenticator: Successfully acquired token interactively, account cached`);
+            logger.debug(`OAuthAuthenticator: Successfully acquired token interactively without broker`);
         }
-        if (!authResult.accessToken) {
+        if (!authResult?.accessToken) {
             logger.error(`OAuthAuthenticator: Authentication result contains no access token`);
             throw new Error("Failed to obtain Azure DevOps OAuth token.");
         }
@@ -126,4 +186,4 @@ function createAuthenticator(type, tenantId) {
             };
     }
 }
-export { createAuthenticator };
+export { createAuthenticator, installPatFetchInterceptor };

package/dist/index.js

@@ -5,13 +5,13 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { getBearerHandler, getPersonalAccessTokenHandler, WebApi } from "azure-devops-node-api";
 import yargs from "yargs";
-import { hideBin } from "yargs/helpers";
-import { createAuthenticator } from "./auth.js";
+import { createAuthenticator, installPatFetchInterceptor } from "./auth.js";
 import { logger } from "./logger.js";
 import { getOrgTenant } from "./org-tenants.js";
 //import { configurePrompts } from "./prompts.js";
 import { configureAllTools } from "./tools.js";
 import { UserAgentComposer } from "./useragent.js";
+import { getCliArgs } from "./utils.js";
 import { packageVersion } from "./version.js";
 import { DomainsManager } from "./shared/domains.js";
 function isGitHubCodespaceEnv() {
@@ -19,7 +19,7 @@ function isGitHubCodespaceEnv() {
 }
 const defaultAuthenticationType = isGitHubCodespaceEnv() ? "azcli" : "interactive";
 // Parse command line arguments using yargs
-const argv = yargs(hideBin(process.argv))
+const argv = yargs(getCliArgs())
     .scriptName("mcp-server-azuredevops")
     .usage("Usage: $0 <organization> [options]")
     .version(packageVersion)
@@ -93,22 +93,11 @@ async function main() {
     server.server.oninitialized = () => {
         userAgentComposer.appendMcpClientInfo(server.server.getClientVersion());
     };
-    const tenantId = (await getOrgTenant(orgName)) ?? argv.tenant;
+    const tenantId = argv.tenant ?? (await getOrgTenant(orgName));
     const authenticator = createAuthenticator(argv.authentication, tenantId);
     if (argv.authentication === "pat") {
         const basicValue = await authenticator();
-        // basicValue is already base64("{email}:{token}") — use it directly in the Authorization header
-        const _originalFetch = globalThis.fetch;
-        globalThis.fetch = async (input, init) => {
-            if (init?.headers) {
-                const headers = new Headers(init.headers);
-                if (headers.get("Authorization")?.startsWith("Bearer ")) {
-                    headers.set("Authorization", `Basic ${basicValue}`);
-                    init = { ...init, headers };
-                }
-            }
-            return _originalFetch(input, init);
-        };
+        installPatFetchInterceptor(basicValue);
         logger.debug("PAT mode: global fetch interceptor installed to rewrite Bearer -> Basic auth headers");
     }
     // removing prompts until further notice

package/dist/shared/content-safety.js

@@ -1,6 +1,7 @@
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT License.
 import { randomBytes } from "crypto";
+const spotlightedResponse = Symbol("spotlightedResponse");
 /**
  * Applies Spotlighting (delimiting mode) to untrusted external content.
  * See: https://arxiv.org/pdf/2403.14720
@@ -20,5 +21,31 @@ export function spotlightContent(content, source) {
 export function createExternalContentResponse(content, source) {
     const serialized = typeof content === "string" ? content : JSON.stringify(content, null, 2);
     const spotlighted = spotlightContent(serialized, source);
-    return { content: [{ type: "text", text: spotlighted }] };
+    const response = { content: [{ type: "text", text: spotlighted }] };
+    response[spotlightedResponse] = true;
+    return response;
+}
+/**
+ * Applies Spotlighting to every textual content block in a tool response while
+ * preserving MCP metadata such as `isError` and `_meta`.
+ *
+ * The private symbol prevents responses created by createExternalContentResponse
+ * from being wrapped twice without trusting attacker-controlled marker text.
+ */
+export function wrapExternalToolResponse(response, source) {
+    const markedResponse = response;
+    if (markedResponse[spotlightedResponse])
+        return response;
+    const content = response.content.map((block) => {
+        if (block.type === "text") {
+            return { ...block, text: spotlightContent(block.text, source) };
+        }
+        if (block.type === "resource" && "text" in block.resource) {
+            return { ...block, resource: { ...block.resource, text: spotlightContent(block.resource.text, source) } };
+        }
+        return block;
+    });
+    const wrapped = { ...response, content };
+    wrapped[spotlightedResponse] = true;
+    return wrapped;
 }

package/dist/tools/auth.js

@@ -45,10 +45,7 @@ async function searchIdentities(identity, tokenProvider, connectionProvider, use
     }
     return await response.json();
 }
-/**
- * Gets the user ID from email or unique name using Azure DevOps Identity API
- */
-async function getUserIdFromEmail(userEmail, tokenProvider, connectionProvider, userAgentProvider) {
+async function getUserIdentityFromEmail(userEmail, tokenProvider, connectionProvider, userAgentProvider) {
     const identities = await searchIdentities(userEmail, tokenProvider, connectionProvider, userAgentProvider);
     if (!identities || identities.value?.length === 0) {
         throw new Error(`No user found with email/unique name: ${userEmail}`);
@@ -57,6 +54,13 @@ async function getUserIdFromEmail(userEmail, tokenProvider, connectionProvider,
     if (!firstIdentity.id) {
         throw new Error(`No ID found for user with email/unique name: ${userEmail}`);
     }
-    return firstIdentity.id;
+    return { id: firstIdentity.id, displayName: firstIdentity.providerDisplayName ?? userEmail };
+}
+/**
+ * Gets the user ID from email or unique name using Azure DevOps Identity API
+ */
+async function getUserIdFromEmail(userEmail, tokenProvider, connectionProvider, userAgentProvider) {
+    const identity = await getUserIdentityFromEmail(userEmail, tokenProvider, connectionProvider, userAgentProvider);
+    return identity.id;
 }
-export { getCurrentUserDetails, getUserIdFromEmail, searchIdentities };
+export { getCurrentUserDetails, getUserIdFromEmail, getUserIdentityFromEmail, searchIdentities };

package/dist/tools/pipelines.dto.js

@@ -56,7 +56,7 @@ export const runPipelineShape = {
 /** create_pipeline inputs. */
 export const createPipelineShape = {
     ...projectShape,
-    name: z.string().optional().describe("Name of the new pipeline. Required for: create_pipeline."),
+    name: z.string().optional().describe("Pipeline name. Required for: create_pipeline, rename_pipeline."),
     folder: z.string().optional().describe("Folder path for the new pipeline. Used for: create_pipeline."),
     yamlPath: z.string().optional().describe("Path to the YAML file in the repository. Required for: create_pipeline."),
     repositoryType: z
@@ -67,6 +67,12 @@ export const createPipelineShape = {
     repositoryId: z.string().optional().describe("ID of the repository. Used for: create_pipeline."),
     repositoryConnectionId: z.string().optional().describe("Service connection ID for GitHub repositories. Used for: create_pipeline."),
 };
+/** rename_pipeline inputs. */
+export const renamePipelineShape = {
+    ...projectShape,
+    pipelineId: z.coerce.number().min(1).optional().describe("ID of the pipeline. Required for: run_pipeline, rename_pipeline."),
+    name: z.string().optional().describe("Pipeline name. Required for: create_pipeline, rename_pipeline."),
+};
 /** update_build_stage inputs. */
 export const updateBuildStageShape = {
     ...projectShape,
@@ -81,15 +87,17 @@ export const updateBuildStageShape = {
 /** The composed input shape for the grouped `pipelines_write` tool. */
 export const pipelinesWriteShape = {
     action: z
-        .enum(["run_pipeline", "create_pipeline", "update_build_stage"])
-        .describe("The action to perform. Options: run_pipeline (queue a new pipeline run), create_pipeline (create a new YAML pipeline definition), update_build_stage (cancel, retry, or run a stage on an in-flight build)."),
+        .enum(["run_pipeline", "create_pipeline", "rename_pipeline", "update_build_stage"])
+        .describe("The action to perform. Options: run_pipeline (queue a new pipeline run), create_pipeline (create a new YAML pipeline definition), rename_pipeline (rename an existing pipeline definition), update_build_stage (cancel, retry, or run a stage on an in-flight build)."),
     ...runPipelineShape,
     ...createPipelineShape,
+    ...renamePipelineShape,
     ...updateBuildStageShape,
 };
 // Per-action schemas + inferred argument DTOs. `z.infer` keeps these types in
 // lockstep with the schemas above.
 export const runPipelineSchema = z.object(runPipelineShape);
 export const createPipelineSchema = z.object(createPipelineShape);
+export const renamePipelineSchema = z.object(renamePipelineShape);
 export const updateBuildStageSchema = z.object(updateBuildStageShape);
 export const pipelinesWriteSchema = z.object(pipelinesWriteShape);