@azure-devops/mcp 2.9.0-nightly.20260818 → 2.9.0-nightly.20260819

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);

package/dist/tools/pipelines.js

@@ -8,111 +8,102 @@ import { ConfigurationType, RepositoryType } from "azure-devops-node-api/interfa
 import { mkdirSync, createWriteStream } from "fs";
 import { createExternalContentResponse } from "../shared/content-safety.js";
 import { join, posix, resolve, win32 } from "path";
-import { dispatchAction, errorResult } from "../shared/command.js";
 import { pipelinesWriteShape } from "./pipelines.dto.js";
-// ─── pipelines_write commands ────────────────────────────────────────────────
-// Each write action is a self-contained command. Shared infrastructure arrives
-// via `CommandContext`; the action-specific input arrives via a single typed
-// args object (see pipelines.dto.ts). This keeps the dispatcher agnostic of
-// individual argument lists.
-const runPipelineCommand = {
-    async execute(context, args) {
-        if (!args.pipelineId)
-            return errorResult("pipelineId is required for run_pipeline");
-        if (!args.previewRun && args.yamlOverride)
-            throw new Error("Parameter 'yamlOverride' can only be specified together with parameter 'previewRun'.");
-        const connection = await context.connectionProvider();
-        const pipelinesApi = await connection.getPipelinesApi();
-        const runRequest = {
-            previewRun: args.previewRun,
-            resources: { ...args.resources },
-            stagesToSkip: args.stagesToSkip,
-            templateParameters: args.templateParameters,
-            variables: args.variables,
-            yamlOverride: args.yamlOverride,
-        };
-        const pipelineRun = await pipelinesApi.runPipeline(runRequest, args.project, args.pipelineId, args.pipelineVersion);
-        if (pipelineRun.id === undefined)
-            throw new Error("Failed to get build ID from pipeline run");
-        return { content: [{ type: "text", text: JSON.stringify(pipelineRun, null, 2) }] };
-    },
-};
-const createPipelineCommand = {
-    async execute(context, args) {
-        if (!args.name)
-            return errorResult("name is required for create_pipeline");
-        if (!args.yamlPath)
-            return errorResult("yamlPath is required for create_pipeline");
-        if (!args.repositoryType)
-            return errorResult("repositoryType is required for create_pipeline");
-        if (!args.repositoryName)
-            return errorResult("repositoryName is required for create_pipeline");
-        const connection = await context.connectionProvider();
-        const pipelinesApi = await connection.getPipelinesApi();
-        const repositoryTypeEnumValue = safeEnumConvert(RepositoryType, args.repositoryType);
-        const repositoryPayload = { type: args.repositoryType };
-        if (repositoryTypeEnumValue === RepositoryType.AzureReposGit) {
-            repositoryPayload.id = args.repositoryId;
-            repositoryPayload.name = args.repositoryName;
-        }
-        else if (repositoryTypeEnumValue === RepositoryType.GitHub) {
-            if (!args.repositoryConnectionId)
-                throw new Error("Parameter 'repositoryConnectionId' is required for GitHub repositories.");
-            repositoryPayload.connection = { id: args.repositoryConnectionId };
-            repositoryPayload.fullname = args.repositoryName;
-        }
-        else {
-            throw new Error("Unsupported repository type");
-        }
-        const yamlConfigurationType = getEnumKeys(ConfigurationType).find((k) => ConfigurationType[k] === ConfigurationType.Yaml);
-        const createParams = {
-            name: args.name,
-            folder: args.folder || "\\",
-            configuration: { type: yamlConfigurationType, path: args.yamlPath, repository: repositoryPayload, variables: undefined },
-        };
-        const newPipeline = await pipelinesApi.createPipeline(createParams, args.project);
-        return { content: [{ type: "text", text: JSON.stringify(newPipeline, null, 2) }] };
-    },
-};
-const updateBuildStageCommand = {
-    async execute(context, args) {
-        if (!args.buildId)
-            return errorResult("buildId is required for update_build_stage");
-        if (!args.stageName)
-            return errorResult("stageName is required for update_build_stage");
-        if (!args.status)
-            return errorResult("status is required for update_build_stage");
-        const connection = await context.connectionProvider();
-        const orgUrl = connection.serverUrl;
-        const endpoint = `${orgUrl}/${encodeURIComponent(args.project)}/_apis/build/builds/${args.buildId}/stages/${encodeURIComponent(args.stageName)}?api-version=${apiVersion}`;
-        const token = await context.tokenProvider();
-        const body = { forceRetryAllJobs: args.forceRetryAllJobs, state: safeEnumConvert(StageUpdateType, args.status) };
-        const response = await fetch(endpoint, {
-            method: "PATCH",
-            headers: { "Content-Type": "application/json", "Authorization": `Bearer ${token}`, "User-Agent": context.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) }] };
-    },
-};
-/**
- * The registry is the lookup table that couples each action to its command.
- * Adding a new write action means registering one entry here — the dispatcher
- * (`dispatchAction`) never changes.
- */
-const pipelinesWriteCommands = {
-    run_pipeline: runPipelineCommand,
-    create_pipeline: createPipelineCommand,
-    update_build_stage: updateBuildStageCommand,
-};
+const errorResult = (text) => ({ content: [{ type: "text", text }], isError: true });
+async function runPipeline(args, connectionProvider) {
+    if (!args.pipelineId)
+        return errorResult("pipelineId is required for run_pipeline");
+    if (!args.previewRun && args.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: args.previewRun,
+        resources: { ...args.resources },
+        stagesToSkip: args.stagesToSkip,
+        templateParameters: args.templateParameters,
+        variables: args.variables,
+        yamlOverride: args.yamlOverride,
+    };
+    const pipelineRun = await pipelinesApi.runPipeline(runRequest, args.project, args.pipelineId, args.pipelineVersion);
+    if (pipelineRun.id === undefined)
+        throw new Error("Failed to get build ID from pipeline run");
+    return { content: [{ type: "text", text: JSON.stringify(pipelineRun, null, 2) }] };
+}
+async function createPipeline(args, connectionProvider) {
+    if (!args.name)
+        return errorResult("name is required for create_pipeline");
+    if (!args.yamlPath)
+        return errorResult("yamlPath is required for create_pipeline");
+    if (!args.repositoryType)
+        return errorResult("repositoryType is required for create_pipeline");
+    if (!args.repositoryName)
+        return errorResult("repositoryName is required for create_pipeline");
+    const connection = await connectionProvider();
+    const pipelinesApi = await connection.getPipelinesApi();
+    const repositoryTypeEnumValue = safeEnumConvert(RepositoryType, args.repositoryType);
+    const repositoryPayload = { type: args.repositoryType };
+    if (repositoryTypeEnumValue === RepositoryType.AzureReposGit) {
+        repositoryPayload.id = args.repositoryId;
+        repositoryPayload.name = args.repositoryName;
+    }
+    else if (repositoryTypeEnumValue === RepositoryType.GitHub) {
+        if (!args.repositoryConnectionId)
+            throw new Error("Parameter 'repositoryConnectionId' is required for GitHub repositories.");
+        repositoryPayload.connection = { id: args.repositoryConnectionId };
+        repositoryPayload.fullname = args.repositoryName;
+    }
+    else {
+        throw new Error("Unsupported repository type");
+    }
+    const yamlConfigurationType = getEnumKeys(ConfigurationType).find((k) => ConfigurationType[k] === ConfigurationType.Yaml);
+    const createParams = {
+        name: args.name,
+        folder: args.folder || "\\",
+        configuration: { type: yamlConfigurationType, path: args.yamlPath, repository: repositoryPayload, variables: undefined },
+    };
+    const newPipeline = await pipelinesApi.createPipeline(createParams, args.project);
+    return { content: [{ type: "text", text: JSON.stringify(newPipeline, null, 2) }] };
+}
+async function renamePipeline(args, connectionProvider) {
+    if (!args.pipelineId)
+        return errorResult("pipelineId is required for rename_pipeline");
+    if (!args.name)
+        return errorResult("name is required for rename_pipeline");
+    const connection = await connectionProvider();
+    const buildApi = await connection.getBuildApi();
+    const definition = await buildApi.getDefinition(args.project, args.pipelineId);
+    const updatedDefinition = await buildApi.updateDefinition({ ...definition, name: args.name }, args.project, args.pipelineId);
+    return { content: [{ type: "text", text: JSON.stringify(updatedDefinition, null, 2) }] };
+}
+async function updateBuildStage(args, connectionProvider, tokenProvider, userAgentProvider) {
+    if (!args.buildId)
+        return errorResult("buildId is required for update_build_stage");
+    if (!args.stageName)
+        return errorResult("stageName is required for update_build_stage");
+    if (!args.status)
+        return errorResult("status is required for update_build_stage");
+    const connection = await connectionProvider();
+    const orgUrl = connection.serverUrl;
+    const endpoint = `${orgUrl}/${encodeURIComponent(args.project)}/_apis/build/builds/${args.buildId}/stages/${encodeURIComponent(args.stageName)}?api-version=${apiVersion}`;
+    const token = await tokenProvider();
+    const body = { forceRetryAllJobs: args.forceRetryAllJobs, state: safeEnumConvert(StageUpdateType, args.status) };
+    const response = await fetch(endpoint, {
+        method: "PATCH",
+        headers: { "Content-Type": "application/json", "Authorization": `Bearer ${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) }] };
+}
 const pipelinesWriteErrorPrefixes = {
     run_pipeline: "Error running pipeline: ",
     create_pipeline: "Error creating pipeline: ",
+    rename_pipeline: "Error renaming pipeline: ",
     update_build_stage: "Error updating build stage: ",
 };
 const PIPELINE_TOOLS = {
@@ -385,8 +376,26 @@ function configurePipelineTools(server, tokenProvider, connectionProvider, userA
     });
     // ─── pipelines_write ────────────────────────────────────────────────────────
     server.tool(PIPELINE_TOOLS.pipelines_write, "Write operations for pipelines and builds. Use the action parameter to specify the operation.", pipelinesWriteShape, async (args) => {
-        const context = { connectionProvider, tokenProvider, userAgentProvider };
-        return dispatchAction(pipelinesWriteCommands, context, args, pipelinesWriteErrorPrefixes);
+        try {
+            switch (args.action) {
+                case "run_pipeline":
+                    return await runPipeline(args, connectionProvider);
+                case "create_pipeline":
+                    return await createPipeline(args, connectionProvider);
+                case "rename_pipeline":
+                    return await renamePipeline(args, connectionProvider);
+                case "update_build_stage":
+                    return await updateBuildStage(args, connectionProvider, tokenProvider, userAgentProvider);
+                default: {
+                    const unsupportedAction = args.action;
+                    return errorResult(`Unknown action: ${unsupportedAction}. Supported actions: ${Object.keys(pipelinesWriteErrorPrefixes).sort().join(", ")}`);
+                }
+            }
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : "Unknown error occurred";
+            return errorResult(`${pipelinesWriteErrorPrefixes[args.action]}${message}`);
+        }
     });
 }
-export { PIPELINE_TOOLS, configurePipelineTools, runPipelineCommand, createPipelineCommand, updateBuildStageCommand };
+export { PIPELINE_TOOLS, configurePipelineTools, runPipeline, createPipeline, renamePipeline, updateBuildStage };

package/dist/version.js

@@ -1 +1 @@
-export const packageVersion = "2.9.0-nightly.20260818";
+export const packageVersion = "2.9.0-nightly.20260819";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@azure-devops/mcp",
-  "version": "2.9.0-nightly.20260818",
+  "version": "2.9.0-nightly.20260819",
   "mcpName": "microsoft.com/azure-devops",
   "description": "MCP server for interacting with Azure DevOps",
   "license": "MIT",

package/dist/shared/command.js

@@ -1,34 +0,0 @@
-// Copyright (c) Microsoft Corporation.
-// Licensed under the MIT License.
-/** Builds an error `CallToolResult`. */
-export const errorResult = (text) => ({ content: [{ type: "text", text }], isError: true });
-/**
- * Routes a validated, action-carrying args object to the matching command.
- *
- * This is what removes long positional parameter lists from grouped ("action")
- * tools: instead of destructuring every possible field, the whole typed args
- * object is forwarded to the single command keyed by `args.action`, coupling
- * each action to exactly one command.
- *
- * - Unknown actions short-circuit with an "Unknown action" error and never
- *   touch the context (so no connection is opened).
- * - Errors thrown by a command are caught and formatted using the optional
- *   per-action `errorPrefixes` map (falling back to a generic message).
- * - Errors returned by a command (e.g. validation `errorResult`s) pass through
- *   unchanged.
- */
-export async function dispatchAction(commands, context, args, errorPrefixes) {
-    const command = commands[args.action];
-    if (!command) {
-        const supportedActions = Object.keys(commands).sort().join(", ");
-        return errorResult(`Unknown action: ${args.action}. Supported actions: ${supportedActions}`);
-    }
-    try {
-        return await command.execute(context, args);
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : "Unknown error occurred";
-        const prefix = errorPrefixes?.[args.action];
-        return errorResult(prefix ? `${prefix}${message}` : `Error: ${message}`);
-    }
-}