@azure-devops/mcp 2.7.0 → 2.8.0-nightly.20260624

package/dist/tools/test-plans.js

@@ -341,8 +341,9 @@ function configureTestPlanTools(server, tokenProvider, connectionProvider, userA
         try {
             const connection = await connectionProvider();
             const testResultsApi = await connection.getTestResultsApi();
-            // Build filter expression for outcomes if specified
-            const outcomeFilter = outcomes?.map((o) => `Outcome eq '${o}'`).join(" or ");
+            // Build filter expression for outcomes if specified.
+            // The API accepts: Outcome eq Failed,Passed (unquoted, comma-separated)
+            const outcomeFilter = outcomes?.length ? `Outcome eq ${outcomes.join(",")}` : undefined;
             // Fetch test result details for the build in a single API call
             // This is more efficient than getTestRuns + getTestResults per run,
             // especially for builds with many test runs (e.g., cloud testing with one run per test case)
@@ -357,7 +358,9 @@ function configureTestPlanTools(server, tokenProvider, connectionProvider, userA
             if (testResultDetails.resultsForGroup) {
                 for (const group of testResultDetails.resultsForGroup) {
                     if (group.results) {
-                        allResults.push(...group.results);
+                        for (const result of group.results) {
+                            allResults.push(result);
+                        }
                     }
                 }
             }

package/dist/tools/wiki.js

@@ -1,7 +1,7 @@
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT License.
 import { z } from "zod";
-import { apiVersion } from "../utils.js";
+import { apiVersion, extractAdoStreamError, getOrgFromUrl } from "../utils.js";
 import { createExternalContentResponse } from "../shared/content-safety.js";
 const WIKI_TOOLS = {
     list_wikis: "wiki_list_wikis",
@@ -88,7 +88,7 @@ function configureWikiTools(server, tokenProvider, connectionProvider, userAgent
             };
         }
     });
-    server.tool(WIKI_TOOLS.get_wiki_page, "Retrieve wiki page metadata by path. This tool does not return page content.", {
+    server.tool(WIKI_TOOLS.get_wiki_page, "Retrieve wiki page metadata by path. This tool does not return page content. Returns isError: true if the page is not found.", {
         wikiIdentifier: z.string().describe("The unique identifier of the wiki."),
         project: z.string().describe("The project name or ID where the wiki is located."),
         path: z.string().describe("The path of the wiki page (e.g., '/Home' or '/Documentation/Setup')."),
@@ -136,7 +136,7 @@ function configureWikiTools(server, tokenProvider, connectionProvider, userAgent
             };
         }
     });
-    server.tool(WIKI_TOOLS.get_wiki_page_content, "Retrieve wiki page content. Provide either a 'url' parameter OR the combination of 'wikiIdentifier' and 'project' parameters.", {
+    server.tool(WIKI_TOOLS.get_wiki_page_content, "Retrieve wiki page content. Provide either a 'url' parameter OR the combination of 'wikiIdentifier' and 'project' parameters. " + "Returns isError: true if the wiki page is not found.", {
         url: z
             .string()
             .optional()
@@ -165,6 +165,22 @@ function configureWikiTools(server, tokenProvider, connectionProvider, userAgent
                 if ("error" in parsed) {
                     return { content: [{ type: "text", text: `Error fetching wiki page content: ${parsed.error}` }], isError: true };
                 }
+                // Guard against cross-organization requests: a user-supplied URL must target the
+                // same organization the server is connected to. Otherwise the org segment in the
+                // URL would be silently ignored and content fetched from the configured org instead.
+                const configuredOrg = getOrgFromUrl(connection.serverUrl);
+                const urlOrg = getOrgFromUrl(url);
+                if (configuredOrg && urlOrg !== configuredOrg) {
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `Error fetching wiki page content: The provided URL targets organization '${urlOrg ?? "unknown"}', which does not match the configured organization '${configuredOrg}'. Cross-organization requests are not allowed.`,
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
                 resolvedProject = parsed.project;
                 resolvedWiki = parsed.wikiIdentifier;
                 if (parsed.pagePath) {
@@ -201,14 +217,22 @@ function configureWikiTools(server, tokenProvider, connectionProvider, userAgent
                 if (!resolvedPath) {
                     resolvedPath = "/";
                 }
-                if (!resolvedProject || !resolvedWiki) {
-                    return { content: [{ type: "text", text: "Project and wikiIdentifier must be defined to fetch wiki page content." }], isError: true };
-                }
+                // resolvedProject and resolvedWiki are guaranteed to be defined here:
+                // - the url branch errors out in parseWikiUrl when project/wikiIdentifier are missing
+                // - the pair branch enforces both via the hasPair check above
+                // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
                 const stream = await wikiApi.getPageText(resolvedProject, resolvedWiki, resolvedPath, undefined, undefined, true);
                 if (!stream) {
                     return { content: [{ type: "text", text: "No wiki page content found" }], isError: true };
                 }
                 pageContent = await streamToString(stream);
+                const streamError = extractAdoStreamError(pageContent);
+                if (streamError) {
+                    return {
+                        content: [{ type: "text", text: `Error fetching wiki page content: ${streamError}` }],
+                        isError: true,
+                    };
+                }
             }
             return createExternalContentResponse(pageContent, "wiki page");
         }

package/dist/tools/work-items.js

@@ -1,5 +1,7 @@
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT License.
+import * as fs from "fs";
+import * as path from "path";
 import { WorkItemExpand } from "azure-devops-node-api/interfaces/WorkItemTrackingInterfaces.js";
 import { QueryExpand } from "azure-devops-node-api/interfaces/WorkItemTrackingInterfaces.js";
 import { z } from "zod";
@@ -133,7 +135,7 @@ function configureWorkItemTools(server, tokenProvider, connectionProvider, userA
             };
         }
     });
-    server.tool(WORKITEM_TOOLS.my_work_items, "Retrieve a list of work items relevent to the authenticated user. If a project is not specified, you will be prompted to select one.", {
+    server.tool(WORKITEM_TOOLS.my_work_items, "Retrieve a list of work items relevant to the authenticated user. If a project is not specified, you will be prompted to select one.", {
         project: z.string().optional().describe("The name or ID of the Azure DevOps project. Reuse from prior context if already known. If not provided, a project selection prompt will be shown."),
         type: z.enum(["assignedtome", "myactivity"]).default("assignedtome").describe("The type of work items to retrieve. Defaults to 'assignedtome'."),
         top: z.coerce.number().default(50).describe("The maximum number of work items to return. Defaults to 50."),
@@ -407,8 +409,9 @@ function configureWorkItemTools(server, tokenProvider, connectionProvider, userA
             if (revisions && Array.isArray(revisions)) {
                 revisions.forEach((revision) => {
                     if (revision.fields) {
-                        Object.keys(revision.fields).forEach((fieldName) => {
-                            const fieldValue = revision.fields ? revision.fields[fieldName] : undefined;
+                        const fields = revision.fields;
+                        Object.keys(fields).forEach((fieldName) => {
+                            const fieldValue = fields[fieldName];
                             // Check if this is an identity object by looking for common identity properties
                             if (fieldValue &&
                                 typeof fieldValue === "object" &&
@@ -734,7 +737,7 @@ function configureWorkItemTools(server, tokenProvider, connectionProvider, userA
                 value: encodeFormattedValue(value, format),
             }));
             // Check if any field has format === "Markdown" and add the multilineFieldsFormat operation
-            // this should only happen for large text fields, but since we dont't know by field name, lets assume if the users
+            // this should only happen for large text fields, but since we don't know by field name, lets assume if the users
             // passes a value longer than 100 characters, then we can set the format to Markdown
             fields.forEach(({ name, value, format }) => {
                 if (value.length > 100 && format === "Markdown") {
@@ -1210,11 +1213,23 @@ function configureWorkItemTools(server, tokenProvider, connectionProvider, userA
             };
         }
     });
-    server.tool(WORKITEM_TOOLS.get_work_item_attachment, "Download a work item attachment by its ID and return the content as a base64-encoded resource. Useful for viewing images (e.g. screenshots) attached to work items such as bugs. If a project is not specified, you will be prompted to select one.", {
+    server.tool(WORKITEM_TOOLS.get_work_item_attachment, "Download a work item attachment by its ID. By default returns the content as a base64-encoded resource. If savePath is provided, saves the file locally to that directory and returns the file path instead. Useful for viewing images (e.g. screenshots) or other files attached to work items such as bugs. If a project is not specified, you will be prompted to select one.", {
         project: z.string().optional().describe("The name or ID of the Azure DevOps project. Reuse from prior context if already known. If not provided, a project selection prompt will be shown."),
         attachmentId: z.string().describe("The GUID of the attachment. Found in the attachment URL: https://dev.azure.com/{org}/{project}/_apis/wit/attachments/{attachmentId}"),
-        fileName: z.string().optional().describe("The file name of the attachment, e.g. 'screenshot.png'. Used to determine the MIME type for the returned resource."),
-    }, async ({ project, attachmentId, fileName }) => {
+        fileName: z.string().optional().describe("The file name of the attachment, e.g. 'screenshot.png'. Used to determine the MIME type or the saved file's name."),
+        savePath: z
+            .string()
+            .optional()
+            .describe("Optional local directory path where the file should be saved. Must be a relative path (e.g. 'temp' or 'downloads/attachments'); absolute paths and path traversals are not allowed. If provided, saves the attachment to this directory and returns the file path. If omitted, returns the content as a base64-encoded resource."),
+    }, async ({ project, attachmentId, fileName, savePath }) => {
+        const isAbsolutePath = (value) => path.posix.isAbsolute(value) || path.win32.isAbsolute(value);
+        const hasDriveLetter = (value) => /^[a-zA-Z]:/.test(value);
+        if (savePath !== undefined && (savePath.includes("..") || isAbsolutePath(savePath) || hasDriveLetter(savePath))) {
+            throw new Error("Invalid savePath: absolute paths and path traversals are not allowed.");
+        }
+        if (fileName !== undefined && fileName.includes("..")) {
+            throw new Error("Invalid fileName: path traversal is not allowed.");
+        }
         try {
             const connection = await connectionProvider();
             let resolvedProject = project;
@@ -1233,8 +1248,24 @@ function configureWorkItemTools(server, tokenProvider, connectionProvider, userA
                 stream.on("error", reject);
             });
             const buffer = Buffer.concat(chunks);
-            const base64Data = buffer.toString("base64");
+            if (savePath) {
+                const resolvedFileName = fileName ?? attachmentId;
+                const localFilePath = path.join(savePath, resolvedFileName);
+                if (fs.existsSync(localFilePath)) {
+                    throw new Error(`File already exists: ${localFilePath}`);
+                }
+                fs.writeFileSync(localFilePath, buffer);
+                return {
+                    content: [{ type: "text", text: `Attachment saved to: ${localFilePath}` }],
+                };
+            }
             const mimeType = getMimeType(fileName);
+            if (mimeType.startsWith("text/")) {
+                return {
+                    content: [{ type: "text", text: buffer.toString("utf-8") }],
+                };
+            }
+            const base64Data = buffer.toString("base64");
             return {
                 content: [
                     {
@@ -1269,6 +1300,15 @@ function getMimeType(fileName) {
         webp: "image/webp",
         pdf: "application/pdf",
         txt: "text/plain",
+        md: "text/markdown",
+        markdown: "text/markdown",
+        csv: "text/csv",
+        html: "text/html",
+        htm: "text/html",
+        xml: "text/xml",
+        json: "application/json",
+        yaml: "text/yaml",
+        yml: "text/yaml",
         zip: "application/zip",
     };
     return (ext && mimeTypes[ext]) ?? "application/octet-stream";

package/dist/tools/work.js

@@ -100,7 +100,7 @@ function configureWorkTools(server, _, connectionProvider) {
     server.tool(WORK_TOOLS.list_iterations, "List all iterations in a specified Azure DevOps project. If a project is not specified, you will be prompted to select one.", {
         project: z.string().optional().describe("The name or ID of the Azure DevOps project. Reuse from prior context if already known. If not provided, a project selection prompt will be shown."),
         depth: z.coerce.number().default(2).describe("Depth of children to fetch."),
-        excludedIds: z.array(z.coerce.number().min(1)).optional().describe("An optional array of iteration IDs, and thier children, that should not be returned."),
+        excludedIds: z.array(z.coerce.number().min(1)).optional().describe("An optional array of iteration IDs, and their children, that should not be returned."),
     }, async ({ project, depth, excludedIds: ids }) => {
         try {
             const connection = await connectionProvider();

package/dist/utils.js

@@ -67,6 +67,60 @@ export function encodeFormattedValue(value, format) {
     const result = value.replace(/</g, "&lt;").replace(/>/g, "&gt;");
     return result;
 }
+/**
+ * Detects whether a string returned from an ADO API stream is actually an error
+ * response serialized as JSON (e.g. a 404 GitItemNotFoundException or
+ * WikiPageNotFoundException) rather than real content.
+ *
+ * The ADO Node API client swallows non-2xx HTTP responses and delivers the
+ * error body as a stream, so callers must check explicitly after reading.
+ *
+ * @returns The human-readable error message extracted from the JSON, or null if
+ *          the content is not an ADO error response.
+ */
+export function extractAdoStreamError(content) {
+    try {
+        const json = JSON.parse(content.trim());
+        if (json && typeof json.typeName === "string" && typeof json.message === "string") {
+            return json.message;
+        }
+    }
+    catch {
+        // Not JSON — not an ADO error response.
+    }
+    return null;
+}
+/**
+ * Extracts the Azure DevOps organization identifier from a URL.
+ *
+ * Only recognized Azure DevOps hosts are accepted; any other host returns null
+ * so that callers can treat unrecognized URLs as a boundary violation.
+ *
+ * Supports both modern and legacy organization URL forms:
+ *  - https://dev.azure.com/{org}/...            -> org is the first path segment
+ *  - https://{org}.visualstudio.com/...         -> org is the host subdomain
+ *
+ * @param url Any Azure DevOps URL (e.g. a wiki page link or a connection serverUrl).
+ * @returns The lowercased organization name, or null if it cannot be determined.
+ */
+export function getOrgFromUrl(url) {
+    try {
+        const u = new URL(url);
+        const host = u.hostname.toLowerCase();
+        if (host === "visualstudio.com" || host.endsWith(".visualstudio.com")) {
+            const subdomain = host.split(".")[0];
+            return subdomain && subdomain !== "visualstudio" ? subdomain : null;
+        }
+        if (host === "dev.azure.com" || host.endsWith(".dev.azure.com")) {
+            const firstSegment = u.pathname.split("/").filter(Boolean)[0];
+            return firstSegment ? firstSegment.toLowerCase() : null;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
 /**
  * Convert a Node.js ReadableStream to a string.
  * Shared utility for consistent stream handling across tools.

package/dist/version.js

@@ -1 +1 @@
-export const packageVersion = "2.7.0";
+export const packageVersion = "2.8.0-nightly.20260624";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@azure-devops/mcp",
-  "version": "2.7.0",
+  "version": "2.8.0-nightly.20260624",
   "mcpName": "microsoft.com/azure-devops",
   "description": "MCP server for interacting with Azure DevOps",
   "license": "MIT",
@@ -41,7 +41,7 @@
     "@azure/identity": "^4.10.0",
     "@azure/msal-node": "^5.0.6",
     "@modelcontextprotocol/sdk": "1.29.0",
-    "azure-devops-extension-api": "^4.264.0",
+    "azure-devops-extension-api": "^5.272.3",
     "azure-devops-extension-sdk": "^4.0.2",
     "azure-devops-node-api": "^15.1.2",
     "winston": "^3.18.3",
@@ -58,8 +58,8 @@
     "husky": "^9.1.7",
     "jest": "^30.0.2",
     "jest-extended": "^7.0.0",
-    "lint-staged": "^16.2.7",
-    "prettier": "3.8.3",
+    "lint-staged": "^17.0.0",
+    "prettier": "3.8.4",
     "shx": "^0.4.0",
     "ts-jest": "^29.4.6",
     "tsconfig-paths": "^4.2.0",

package/dist/tools/builds.js

@@ -1,271 +0,0 @@
-// Copyright (c) Microsoft Corporation.
-// Licensed under the MIT License.
-import { apiVersion, getEnumKeys, safeEnumConvert } from "../utils.js";
-import { BuildQueryOrder, DefinitionQueryOrder } from "azure-devops-node-api/interfaces/BuildInterfaces.js";
-import { z } from "zod";
-import { StageUpdateType } from "azure-devops-node-api/interfaces/BuildInterfaces.js";
-const BUILD_TOOLS = {
-    get_builds: "build_get_builds",
-    get_changes: "build_get_changes",
-    get_definitions: "build_get_definitions",
-    get_definition_revisions: "build_get_definition_revisions",
-    get_log: "build_get_log",
-    get_log_by_id: "build_get_log_by_id",
-    get_status: "build_get_status",
-    pipelines_get_run: "pipelines_get_run",
-    pipelines_list_runs: "pipelines_list_runs",
-    pipelines_run_pipeline: "pipelines_run_pipeline",
-    update_build_stage: "build_update_build_stage",
-};
-function configureBuildTools(server, tokenProvider, connectionProvider, userAgentProvider) {
-    server.tool(BUILD_TOOLS.get_definitions, "Retrieves a list of build definitions for a given project.", {
-        project: z.string().describe("Project ID or name to get build definitions for"),
-        repositoryId: z.string().optional().describe("Repository ID to filter build definitions"),
-        repositoryType: z.enum(["TfsGit", "GitHub", "BitbucketCloud"]).optional().describe("Type of repository to filter build definitions"),
-        name: z.string().optional().describe("Name of the build definition to filter"),
-        path: z.string().optional().describe("Path of the build definition to filter"),
-        queryOrder: z
-            .enum(getEnumKeys(DefinitionQueryOrder))
-            .optional()
-            .describe("Order in which build definitions are returned"),
-        top: z.number().optional().describe("Maximum number of build definitions to return"),
-        continuationToken: z.string().optional().describe("Token for continuing paged results"),
-        minMetricsTime: z.coerce.date().optional().describe("Minimum metrics time to filter build definitions"),
-        definitionIds: z.array(z.number()).optional().describe("Array of build definition IDs to filter"),
-        builtAfter: z.coerce.date().optional().describe("Return definitions that have builds after this date"),
-        notBuiltAfter: z.coerce.date().optional().describe("Return definitions that do not have builds after this date"),
-        includeAllProperties: z.boolean().optional().describe("Whether to include all properties in the results"),
-        includeLatestBuilds: z.boolean().optional().describe("Whether to include the latest builds for each definition"),
-        taskIdFilter: z.string().optional().describe("Task ID to filter build definitions"),
-        processType: z.number().optional().describe("Process type to filter build definitions"),
-        yamlFilename: z.string().optional().describe("YAML filename to filter build definitions"),
-    }, async ({ project, repositoryId, repositoryType, name, path, queryOrder, top, continuationToken, minMetricsTime, definitionIds, builtAfter, notBuiltAfter, includeAllProperties, includeLatestBuilds, taskIdFilter, processType, yamlFilename, }) => {
-        const connection = await connectionProvider();
-        const buildApi = await connection.getBuildApi();
-        const buildDefinitions = await buildApi.getDefinitions(project, name, repositoryId, repositoryType, safeEnumConvert(DefinitionQueryOrder, queryOrder), top, continuationToken, minMetricsTime, definitionIds, path, builtAfter, notBuiltAfter, includeAllProperties, includeLatestBuilds, taskIdFilter, processType, yamlFilename);
-        return {
-            content: [{ type: "text", text: JSON.stringify(buildDefinitions, null, 2) }],
-        };
-    });
-    server.tool(BUILD_TOOLS.get_definition_revisions, "Retrieves a list of revisions for a specific build definition.", {
-        project: z.string().describe("Project ID or name to get the build definition revisions for"),
-        definitionId: z.number().describe("ID of the build definition to get revisions for"),
-    }, async ({ project, definitionId }) => {
-        const connection = await connectionProvider();
-        const buildApi = await connection.getBuildApi();
-        const revisions = await buildApi.getDefinitionRevisions(project, definitionId);
-        return {
-            content: [{ type: "text", text: JSON.stringify(revisions, null, 2) }],
-        };
-    });
-    server.tool(BUILD_TOOLS.get_builds, "Retrieves a list of builds for a given project.", {
-        project: z.string().describe("Project ID or name to get builds for"),
-        definitions: z.array(z.number()).optional().describe("Array of build definition IDs to filter builds"),
-        queues: z.array(z.number()).optional().describe("Array of queue IDs to filter builds"),
-        buildNumber: z.string().optional().describe("Build number to filter builds"),
-        minTime: z.coerce.date().optional().describe("Minimum finish time to filter builds"),
-        maxTime: z.coerce.date().optional().describe("Maximum finish time to filter builds"),
-        requestedFor: z.string().optional().describe("User ID or name who requested the build"),
-        reasonFilter: z.number().optional().describe("Reason filter for the build (see BuildReason enum)"),
-        statusFilter: z.number().optional().describe("Status filter for the build (see BuildStatus enum)"),
-        resultFilter: z.number().optional().describe("Result filter for the build (see BuildResult enum)"),
-        tagFilters: z.array(z.string()).optional().describe("Array of tags to filter builds"),
-        properties: z.array(z.string()).optional().describe("Array of property names to include in the results"),
-        top: z.number().optional().describe("Maximum number of builds to return"),
-        continuationToken: z.string().optional().describe("Token for continuing paged results"),
-        maxBuildsPerDefinition: z.number().optional().describe("Maximum number of builds per definition"),
-        deletedFilter: z.number().optional().describe("Filter for deleted builds (see QueryDeletedOption enum)"),
-        queryOrder: z
-            .enum(getEnumKeys(BuildQueryOrder))
-            .default("QueueTimeDescending")
-            .optional()
-            .describe("Order in which builds are returned"),
-        branchName: z.string().optional().describe("Branch name to filter builds"),
-        buildIds: z.array(z.number()).optional().describe("Array of build IDs to retrieve"),
-        repositoryId: z.string().optional().describe("Repository ID to filter builds"),
-        repositoryType: z.enum(["TfsGit", "GitHub", "BitbucketCloud"]).optional().describe("Type of repository to filter builds"),
-    }, async ({ project, definitions, queues, buildNumber, minTime, maxTime, requestedFor, reasonFilter, statusFilter, resultFilter, tagFilters, properties, top, continuationToken, maxBuildsPerDefinition, deletedFilter, queryOrder, branchName, buildIds, repositoryId, repositoryType, }) => {
-        const connection = await connectionProvider();
-        const buildApi = await connection.getBuildApi();
-        const builds = await buildApi.getBuilds(project, definitions, queues, buildNumber, minTime, maxTime, requestedFor, reasonFilter, statusFilter, resultFilter, tagFilters, properties, top, continuationToken, maxBuildsPerDefinition, deletedFilter, safeEnumConvert(BuildQueryOrder, queryOrder), branchName, buildIds, repositoryId, repositoryType);
-        return {
-            content: [{ type: "text", text: JSON.stringify(builds, null, 2) }],
-        };
-    });
-    server.tool(BUILD_TOOLS.get_log, "Retrieves the logs for a specific build.", {
-        project: z.string().describe("Project ID or name to get the build log for"),
-        buildId: z.number().describe("ID of the build to get the log for"),
-    }, async ({ project, buildId }) => {
-        const connection = await connectionProvider();
-        const buildApi = await connection.getBuildApi();
-        const logs = await buildApi.getBuildLogs(project, buildId);
-        return {
-            content: [{ type: "text", text: JSON.stringify(logs, null, 2) }],
-        };
-    });
-    server.tool(BUILD_TOOLS.get_log_by_id, "Get a specific build log by log ID.", {
-        project: z.string().describe("Project ID or name to get the build log for"),
-        buildId: z.number().describe("ID of the build to get the log for"),
-        logId: z.number().describe("ID of the log to retrieve"),
-        startLine: z.number().optional().describe("Starting line number for the log content, defaults to 0"),
-        endLine: z.number().optional().describe("Ending line number for the log content, defaults to the end of the log"),
-    }, async ({ project, buildId, logId, startLine, endLine }) => {
-        const connection = await connectionProvider();
-        const buildApi = await connection.getBuildApi();
-        const logLines = await buildApi.getBuildLogLines(project, buildId, logId, startLine, endLine);
-        return {
-            content: [{ type: "text", text: JSON.stringify(logLines, null, 2) }],
-        };
-    });
-    server.tool(BUILD_TOOLS.get_changes, "Get the changes associated with a specific build.", {
-        project: z.string().describe("Project ID or name to get the build changes for"),
-        buildId: z.number().describe("ID of the build to get changes for"),
-        continuationToken: z.string().optional().describe("Continuation token for pagination"),
-        top: z.number().default(100).describe("Number of changes to retrieve, defaults to 100"),
-        includeSourceChange: z.boolean().optional().describe("Whether to include source changes in the results, defaults to false"),
-    }, async ({ project, buildId, continuationToken, top, includeSourceChange }) => {
-        const connection = await connectionProvider();
-        const buildApi = await connection.getBuildApi();
-        const changes = await buildApi.getBuildChanges(project, buildId, continuationToken, top, includeSourceChange);
-        return {
-            content: [{ type: "text", text: JSON.stringify(changes, null, 2) }],
-        };
-    });
-    server.tool(BUILD_TOOLS.pipelines_get_run, "Gets a run for a particular pipeline.", {
-        project: z.string().describe("Project ID or name to run the build in"),
-        pipelineId: z.number().describe("ID of the pipeline to run"),
-        runId: z.number().describe("ID of the run to get"),
-    }, async ({ project, pipelineId, runId }) => {
-        const connection = await connectionProvider();
-        const pipelinesApi = await connection.getPipelinesApi();
-        const pipelineRun = await pipelinesApi.getRun(project, pipelineId, runId);
-        return {
-            content: [{ type: "text", text: JSON.stringify(pipelineRun, null, 2) }],
-        };
-    });
-    server.tool(BUILD_TOOLS.pipelines_list_runs, "Gets top 10000 runs for a particular pipeline.", {
-        project: z.string().describe("Project ID or name to run the build in"),
-        pipelineId: z.number().describe("ID of the pipeline to run"),
-    }, async ({ project, pipelineId }) => {
-        const connection = await connectionProvider();
-        const pipelinesApi = await connection.getPipelinesApi();
-        const pipelineRuns = await pipelinesApi.listRuns(project, pipelineId);
-        return {
-            content: [{ type: "text", text: JSON.stringify(pipelineRuns, null, 2) }],
-        };
-    });
-    const variableSchema = z.object({
-        value: z.string().optional(),
-        isSecret: z.boolean().optional(),
-    });
-    const resourcesSchema = z.object({
-        builds: z
-            .record(z.string().describe("Name of the build resource."), z.object({
-            version: z.string().optional().describe("Version of the build resource."),
-        }))
-            .optional(),
-        containers: z
-            .record(z.string().describe("Name of the container resource."), z.object({
-            version: z.string().optional().describe("Version of the container resource."),
-        }))
-            .optional(),
-        packages: z
-            .record(z.string().describe("Name of the package resource."), z.object({
-            version: z.string().optional().describe("Version of the package resource."),
-        }))
-            .optional(),
-        pipelines: z.record(z.string().describe("Name of the pipeline resource."), z.object({
-            runId: z.number().describe("Id of the source pipeline run that triggered or is referenced by this pipeline run."),
-            version: z.string().optional().describe("Version of the source pipeline run."),
-        })),
-        repositories: z
-            .record(z.string().describe("Name of the repository resource."), z.object({
-            refName: z.string().describe("Reference name, e.g., refs/heads/main."),
-            token: z.string().optional(),
-            tokenType: z.string().optional(),
-            version: z.string().optional().describe("Version of the repository resource, git commit sha."),
-        }))
-            .optional(),
-    });
-    server.tool(BUILD_TOOLS.pipelines_run_pipeline, "Starts a new run of a pipeline.", {
-        project: z.string().describe("Project ID or name to run the build in"),
-        pipelineId: z.number().describe("ID of the pipeline to run"),
-        pipelineVersion: z.number().optional().describe("Version of the pipeline to run. If not provided, the latest version will be used."),
-        previewRun: z.boolean().optional().describe("If true, returns the final YAML document after parsing templates without creating a new run."),
-        resources: resourcesSchema.optional().describe("A dictionary of resources to pass to the pipeline."),
-        stagesToSkip: z.array(z.string()).optional().describe("A list of stages to skip."),
-        templateParameters: z.record(z.string(), z.string()).optional().describe("Custom build parameters as key-value pairs"),
-        variables: z.record(z.string(), variableSchema).optional().describe("A dictionary of variables to pass to the pipeline."),
-        yamlOverride: z.string().optional().describe("YAML override for the pipeline run."),
-    }, async ({ project, pipelineId, pipelineVersion, previewRun, resources, stagesToSkip, templateParameters, variables, yamlOverride }) => {
-        if (!previewRun && yamlOverride) {
-            throw new Error("Parameter 'yamlOverride' can only be specified together with parameter 'previewRun'.");
-        }
-        const connection = await connectionProvider();
-        const pipelinesApi = await connection.getPipelinesApi();
-        const runRequest = {
-            previewRun: previewRun,
-            resources: {
-                ...resources,
-            },
-            stagesToSkip: stagesToSkip,
-            templateParameters: templateParameters,
-            variables: variables,
-            yamlOverride: yamlOverride,
-        };
-        const pipelineRun = await pipelinesApi.runPipeline(runRequest, project, pipelineId, pipelineVersion);
-        const queuedBuild = { id: pipelineRun.id };
-        const buildId = queuedBuild.id;
-        if (buildId === undefined) {
-            throw new Error("Failed to get build ID from pipeline run");
-        }
-        return {
-            content: [{ type: "text", text: JSON.stringify(pipelineRun, null, 2) }],
-        };
-    });
-    server.tool(BUILD_TOOLS.get_status, "Fetches the status of a specific build.", {
-        project: z.string().describe("Project ID or name to get the build status for"),
-        buildId: z.number().describe("ID of the build to get the status for"),
-    }, async ({ project, buildId }) => {
-        const connection = await connectionProvider();
-        const buildApi = await connection.getBuildApi();
-        const build = await buildApi.getBuildReport(project, buildId);
-        return {
-            content: [{ type: "text", text: JSON.stringify(build, null, 2) }],
-        };
-    });
-    server.tool(BUILD_TOOLS.update_build_stage, "Updates the stage of a specific build.", {
-        project: z.string().describe("Project ID or name to update the build stage for"),
-        buildId: z.number().describe("ID of the build to update"),
-        stageName: z.string().describe("Name of the stage to update"),
-        status: z.enum(getEnumKeys(StageUpdateType)).describe("New status for the stage"),
-        forceRetryAllJobs: z.boolean().default(false).describe("Whether to force retry all jobs in the stage."),
-    }, async ({ project, buildId, stageName, status, forceRetryAllJobs }) => {
-        const connection = await connectionProvider();
-        const orgUrl = connection.serverUrl;
-        const endpoint = `${orgUrl}/${project}/_apis/build/builds/${buildId}/stages/${stageName}?api-version=${apiVersion}`;
-        const token = await tokenProvider();
-        const body = {
-            forceRetryAllJobs: forceRetryAllJobs,
-            state: safeEnumConvert(StageUpdateType, status),
-        };
-        const response = await fetch(endpoint, {
-            method: "PATCH",
-            headers: {
-                "Content-Type": "application/json",
-                "Authorization": `Bearer ${token.token}`,
-                "User-Agent": userAgentProvider(),
-            },
-            body: JSON.stringify(body),
-        });
-        if (!response.ok) {
-            const errorText = await response.text();
-            throw new Error(`Failed to update build stage: ${response.status} ${errorText}`);
-        }
-        const updatedBuild = await response.text();
-        return {
-            content: [{ type: "text", text: JSON.stringify(updatedBuild, null, 2) }],
-        };
-    });
-}
-export { BUILD_TOOLS, configureBuildTools };