@azure-devops/mcp 2.2.2 → 2.3.0-nightly.20251203

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}`,
-                "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 };

package/dist/tools/releases.js

@@ -1,97 +0,0 @@
-// Copyright (c) Microsoft Corporation.
-// Licensed under the MIT License.
-import { ReleaseDefinitionExpands, ReleaseDefinitionQueryOrder, ReleaseExpands, ReleaseStatus, ReleaseQueryOrder } from "azure-devops-node-api/interfaces/ReleaseInterfaces.js";
-import { z } from "zod";
-import { getEnumKeys, safeEnumConvert } from "../utils.js";
-const RELEASE_TOOLS = {
-    get_release_definitions: "release_get_definitions",
-    get_releases: "release_get_releases",
-};
-function configureReleaseTools(server, _, connectionProvider) {
-    server.tool(RELEASE_TOOLS.get_release_definitions, "Retrieves list of release definitions for a given project.", {
-        project: z.string().describe("Project ID or name to get release definitions for"),
-        searchText: z.string().optional().describe("Search text to filter release definitions"),
-        expand: z
-            .enum(getEnumKeys(ReleaseDefinitionExpands))
-            .default("None")
-            .describe("Expand options for release definitions"),
-        artifactType: z.string().optional().describe("Filter by artifact type"),
-        artifactSourceId: z.string().optional().describe("Filter by artifact source ID"),
-        top: z.number().optional().describe("Number of results to return (for pagination)"),
-        continuationToken: z.string().optional().describe("Continuation token for pagination"),
-        queryOrder: z
-            .enum(getEnumKeys(ReleaseDefinitionQueryOrder))
-            .default("NameAscending")
-            .describe("Order of the results"),
-        path: z.string().optional().describe("Path to filter release definitions"),
-        isExactNameMatch: z.boolean().optional().default(false).describe("Whether to match the exact name of the release definition. Default is false."),
-        tagFilter: z.array(z.string()).optional().describe("Filter by tags associated with the release definitions"),
-        propertyFilters: z.array(z.string()).optional().describe("Filter by properties associated with the release definitions"),
-        definitionIdFilter: z.array(z.string()).optional().describe("Filter by specific release definition IDs"),
-        isDeleted: z.boolean().default(false).describe("Whether to include deleted release definitions. Default is false."),
-        searchTextContainsFolderName: z.boolean().optional().describe("Whether to include folder names in the search text"),
-    }, async ({ project, searchText, expand, artifactType, artifactSourceId, top, continuationToken, queryOrder, path, isExactNameMatch, tagFilter, propertyFilters, definitionIdFilter, isDeleted, searchTextContainsFolderName, }) => {
-        const connection = await connectionProvider();
-        const releaseApi = await connection.getReleaseApi();
-        const releaseDefinitions = await releaseApi.getReleaseDefinitions(project, searchText, safeEnumConvert(ReleaseDefinitionExpands, expand), artifactType, artifactSourceId, top, continuationToken, safeEnumConvert(ReleaseDefinitionQueryOrder, queryOrder), path, isExactNameMatch, tagFilter, propertyFilters, definitionIdFilter, isDeleted, searchTextContainsFolderName);
-        return {
-            content: [{ type: "text", text: JSON.stringify(releaseDefinitions, null, 2) }],
-        };
-    });
-    server.tool(RELEASE_TOOLS.get_releases, "Retrieves a list of releases for a given project.", {
-        project: z.string().optional().describe("Project ID or name to get releases for"),
-        definitionId: z.number().optional().describe("ID of the release definition to filter releases"),
-        definitionEnvironmentId: z.number().optional().describe("ID of the definition environment to filter releases"),
-        searchText: z.string().optional().describe("Search text to filter releases"),
-        createdBy: z.string().optional().describe("User ID or name who created the release"),
-        statusFilter: z
-            .enum(getEnumKeys(ReleaseStatus))
-            .optional()
-            .default("Active")
-            .describe("Status of the releases to filter (default: Active)"),
-        environmentStatusFilter: z.number().optional().describe("Environment status to filter releases"),
-        minCreatedTime: z.coerce
-            .date()
-            .optional()
-            .default(() => {
-            const sevenDaysAgo = new Date();
-            sevenDaysAgo.setDate(sevenDaysAgo.getDate() - 7);
-            return sevenDaysAgo;
-        })
-            .describe("Minimum created time for releases (default: 7 days ago)"),
-        maxCreatedTime: z.coerce
-            .date()
-            .optional()
-            .default(() => new Date())
-            .describe("Maximum created time for releases (default: now)"),
-        queryOrder: z
-            .enum(getEnumKeys(ReleaseQueryOrder))
-            .optional()
-            .default("Ascending")
-            .describe("Order in which to return releases (default: Ascending)"),
-        top: z.number().optional().describe("Number of releases to return"),
-        continuationToken: z.number().optional().describe("Continuation token for pagination"),
-        expand: z
-            .enum(getEnumKeys(ReleaseExpands))
-            .optional()
-            .default("None")
-            .describe("Expand options for releases"),
-        artifactTypeId: z.string().optional().describe("Filter releases by artifact type ID"),
-        sourceId: z.string().optional().describe("Filter releases by artifact source ID"),
-        artifactVersionId: z.string().optional().describe("Filter releases by artifact version ID"),
-        sourceBranchFilter: z.string().optional().describe("Filter releases by source branch"),
-        isDeleted: z.boolean().optional().default(false).describe("Whether to include deleted releases (default: false)"),
-        tagFilter: z.array(z.string()).optional().describe("Filter releases by tags"),
-        propertyFilters: z.array(z.string()).optional().describe("Filter releases by properties"),
-        releaseIdFilter: z.array(z.number()).optional().describe("Filter by specific release IDs"),
-        path: z.string().optional().describe("Path to filter releases"),
-    }, async ({ project, definitionId, definitionEnvironmentId, searchText, createdBy, statusFilter, environmentStatusFilter, minCreatedTime, maxCreatedTime, queryOrder, top, continuationToken, expand, artifactTypeId, sourceId, artifactVersionId, sourceBranchFilter, isDeleted, tagFilter, propertyFilters, releaseIdFilter, path, }) => {
-        const connection = await connectionProvider();
-        const releaseApi = await connection.getReleaseApi();
-        const releases = await releaseApi.getReleases(project, definitionId, definitionEnvironmentId, searchText, createdBy, safeEnumConvert(ReleaseStatus, statusFilter), environmentStatusFilter, minCreatedTime, maxCreatedTime, safeEnumConvert(ReleaseQueryOrder, queryOrder), top, continuationToken, safeEnumConvert(ReleaseExpands, expand), artifactTypeId, sourceId, artifactVersionId, sourceBranchFilter, isDeleted, tagFilter, propertyFilters, releaseIdFilter, path);
-        return {
-            content: [{ type: "text", text: JSON.stringify(releases, null, 2) }],
-        };
-    });
-}
-export { RELEASE_TOOLS, configureReleaseTools };