@achieveai/azuredevops-mcp 1.3.12 → 1.3.14

package/dist/index.js

@@ -291,7 +291,7 @@ async function main() {
             fields: zod_1.z.preprocess(coerceArray, zod_1.z.array(zod_1.z.string()).optional()).describe("Specific fields to return (e.g., ['System.Title', 'System.State'])"),
         }, async (params) => {
             const result = await workItemTools.getWorkItemsBatch(params);
-            return { content: result.content, rawData: result.rawData, structuredContent: result.structuredContent };
+            return { content: result.content, rawData: result.rawData, isError: result.isError, structuredContent: result.structuredContent };
         });
         allowedTools.has("getWorkItemRevisions") && server.tool("getWorkItemRevisions", "Get revision/change history for a work item showing all field changes over time", {
             id: zId().describe("Work item ID"),
@@ -299,13 +299,13 @@ async function main() {
             skip: zod_1.z.coerce.number().optional().describe("Number of revisions to skip"),
         }, async (params) => {
             const result = await workItemTools.getWorkItemRevisions(params);
-            return { content: result.content, rawData: result.rawData, structuredContent: result.structuredContent };
+            return { content: result.content, rawData: result.rawData, isError: result.isError, structuredContent: result.structuredContent };
         });
         allowedTools.has("getQueryResults") && server.tool("getQueryResults", "Execute a saved WIQL query by its query ID and return the resulting work items", {
             queryId: zod_1.z.string().describe("The GUID of the saved query to execute"),
         }, async (params) => {
             const result = await workItemTools.getQueryResults(params);
-            return { content: result.content, rawData: result.rawData, structuredContent: result.structuredContent };
+            return { content: result.content, rawData: result.rawData, isError: result.isError, structuredContent: result.structuredContent };
         });
         allowedTools.has("addChildWorkItem") && server.tool("addChildWorkItem", "Create a new work item and link it as a child of an existing parent work item", {
             parentId: zId().describe("Parent work item ID"),
@@ -319,14 +319,14 @@ async function main() {
             additionalFields: zod_1.z.record(zod_1.z.any()).optional().describe("Additional fields"),
         }, async (params) => {
             const result = await workItemTools.addChildWorkItem(params);
-            return { content: result.content, rawData: result.rawData, structuredContent: result.structuredContent };
+            return { content: result.content, rawData: result.rawData, isError: result.isError, structuredContent: result.structuredContent };
         });
         allowedTools.has("unlinkWorkItem") && server.tool("unlinkWorkItem", "Remove a link/relation from a work item by its relation index. Use getWorkItemById first to see the relations and their indices.", {
             id: zId().describe("Work item ID"),
             relationIndex: zod_1.z.coerce.number().describe("Index of the relation to remove (0-based, from the relations array)"),
         }, async (params) => {
             const result = await workItemTools.unlinkWorkItem(params);
-            return { content: result.content, rawData: result.rawData, structuredContent: result.structuredContent };
+            return { content: result.content, rawData: result.rawData, isError: result.isError, structuredContent: result.structuredContent };
         });
         // Register Boards & Sprints Tools
         allowedTools.has("getBoards") && server.tool("getBoards", "Get all boards for a team", {
@@ -770,7 +770,8 @@ async function main() {
                 endLine: zod_1.z.coerce.number().optional().describe("Optional 1-based end line number for multi-line range comments. If omitted, the comment targets a single line."),
                 endOffset: zod_1.z.coerce.number().optional().describe("Optional character offset within the end line. Required when endLine is provided. Typically use 1 for end of selection.")
             }).describe("The position within the file where the comment will be anchored. Use line/offset for single-line comments, add endLine/endOffset for multi-line range comments."),
-            path: zod_1.z.string().describe("The full path to the file within the repository that the comment relates to. Must be a file changed in the PR (e.g., '/src/Services/UserService.cs').")
+            path: zod_1.z.string().describe("The full path to the file within the repository that the comment relates to. Must be a file changed in the PR (e.g., '/src/Services/UserService.cs')."),
+            format: zod_1.z.enum(['markdown', 'html']).optional().describe("Content format: 'markdown' (default) or 'html'. When markdown, HTML entities are unescaped for correct rendering.")
         }, async (params, extra) => {
             const result = await gitTools.addPullRequestInlineComment(params);
             return {
@@ -783,7 +784,8 @@ async function main() {
             repository: zod_1.z.string().describe("The repository name (e.g., 'MyProject') or ID (GUID) containing the pull request. Repository names are case-insensitive."),
             pullRequestId: zId().describe("The numeric ID of the pull request where the comment will be added. This is the PR number shown in the Azure DevOps UI."),
             path: zod_1.z.string().describe("The full path to the file within the repository that the comment relates to. Must be a file changed in the PR (e.g., '/src/Models/User.cs')."),
-            comment: zod_1.z.string().describe("The text content of the comment about the entire file. Can include markdown formatting. Should address file-level concerns, not specific lines.")
+            comment: zod_1.z.string().describe("The text content of the comment about the entire file. Can include markdown formatting. Should address file-level concerns, not specific lines."),
+            format: zod_1.z.enum(['markdown', 'html']).optional().describe("Content format: 'markdown' (default) or 'html'. When markdown, HTML entities are unescaped for correct rendering.")
         }, async (params, extra) => {
             const result = await gitTools.addPullRequestFileComment(params);
             return {
@@ -795,7 +797,8 @@ async function main() {
         allowedTools.has("addPullRequestComment") && server.tool("addPullRequestComment", "Add a GENERAL comment about the entire pull request (not tied to any file or code). Appears in the Overview/Conversation tab. WHEN TO USE: Provide overall feedback, discuss architecture, approve/reject the PR, ask general questions, or comment on the PR description. EXAMPLES: 'This feature looks great! LGTM after CI passes', 'Can you add integration tests for this feature?', 'What's the performance impact of these changes?', 'Please update the documentation before merging'.", {
             repository: zod_1.z.string().describe("The repository name (e.g., 'MyProject') or ID (GUID) containing the pull request. Repository names are case-insensitive."),
             pullRequestId: zId().describe("The numeric ID of the pull request where the comment will be added. This is the PR number shown in the Azure DevOps UI."),
-            comment: zod_1.z.string().describe("The text content of the general comment about the PR. Can include markdown formatting for rich text, code blocks, links, etc. Should address PR-level concerns, not specific files or lines.")
+            comment: zod_1.z.string().describe("The text content of the general comment about the PR. Can include markdown formatting for rich text, code blocks, links, etc. Should address PR-level concerns, not specific files or lines."),
+            format: zod_1.z.enum(['markdown', 'html']).optional().describe("Content format: 'markdown' (default) or 'html'. When markdown, HTML entities are unescaped for correct rendering.")
         }, async (params, extra) => {
             const result = await gitTools.addPullRequestComment(params);
             return {
@@ -855,7 +858,7 @@ async function main() {
             targetRefName: zod_1.z.string().optional().describe("Change target branch (e.g., 'refs/heads/main')"),
         }, async (params) => {
             const result = await gitTools.updatePullRequest(params);
-            return { content: result.content, rawData: result.rawData, structuredContent: result.structuredContent };
+            return { content: result.content, rawData: result.rawData, isError: result.isError, structuredContent: result.structuredContent };
         });
         allowedTools.has("updatePullRequestReviewers") && server.tool("updatePullRequestReviewers", "Add or remove reviewers on an existing pull request", {
             repository: zod_1.z.string().describe("Repository name or ID"),
@@ -865,16 +868,17 @@ async function main() {
             makeRequired: zod_1.z.boolean().optional().describe("Make added reviewers required (default false)"),
         }, async (params) => {
             const result = await gitTools.updatePullRequestReviewers(params);
-            return { content: result.content, rawData: result.rawData, structuredContent: result.structuredContent };
+            return { content: result.content, rawData: result.rawData, isError: result.isError, structuredContent: result.structuredContent };
         });
         allowedTools.has("replyToComment") && server.tool("replyToComment", "Reply to an existing comment thread on a pull request", {
             repository: zod_1.z.string().describe("Repository name or ID"),
             pullRequestId: zId().describe("Pull request ID"),
             threadId: zId().describe("Thread ID to reply to"),
             comment: zod_1.z.string().describe("Reply text content (supports markdown)"),
+            format: zod_1.z.enum(['markdown', 'html']).optional().describe("Content format: 'markdown' (default) or 'html'. When markdown, HTML entities are unescaped for correct rendering."),
         }, async (params) => {
             const result = await gitTools.replyToComment(params);
-            return { content: result.content, rawData: result.rawData, structuredContent: result.structuredContent };
+            return { content: result.content, rawData: result.rawData, isError: result.isError, structuredContent: result.structuredContent };
         });
         allowedTools.has("updatePullRequestThread") && server.tool("updatePullRequestThread", "Update a comment thread's status (resolve, reactivate, close, etc.)", {
             repository: zod_1.z.string().describe("Repository name or ID"),
@@ -883,7 +887,7 @@ async function main() {
             status: zod_1.z.enum(['active', 'byDesign', 'closed', 'fixed', 'pending', 'unknown', 'wontFix']).describe("New thread status"),
         }, async (params) => {
             const result = await gitTools.updatePullRequestThread(params);
-            return { content: result.content, rawData: result.rawData, structuredContent: result.structuredContent };
+            return { content: result.content, rawData: result.rawData, isError: result.isError, structuredContent: result.structuredContent };
         });
         allowedTools.has("createBranch") && server.tool("createBranch", "Create a new branch from a source branch name or commit SHA", {
             repository: zod_1.z.string().describe("Repository name or ID"),
@@ -891,7 +895,7 @@ async function main() {
             sourceRef: zod_1.z.string().describe("Source branch name (e.g., 'main') or commit SHA to branch from"),
         }, async (params) => {
             const result = await gitTools.createBranch(params);
-            return { content: result.content, rawData: result.rawData, structuredContent: result.structuredContent };
+            return { content: result.content, rawData: result.rawData, isError: result.isError, structuredContent: result.structuredContent };
         });
         // Register Testing Capabilities Tools
         allowedTools.has("runAutomatedTests") && server.tool("runAutomatedTests", "Execute automated test suites", {
@@ -1519,14 +1523,14 @@ async function main() {
             project: zod_1.z.string().optional().describe("Project name or ID (defaults to configured project)"),
         }, async (params) => {
             const result = await wikiTools.listWikis(params);
-            return { content: result.content, rawData: result.rawData, structuredContent: result.structuredContent };
+            return { content: result.content, rawData: result.rawData, isError: result.isError, structuredContent: result.structuredContent };
         });
         allowedTools.has("getWiki") && server.tool("getWiki", "Get details about a specific wiki", {
             wikiIdentifier: zod_1.z.string().describe("Wiki name or ID"),
             project: zod_1.z.string().optional().describe("Project name or ID"),
         }, async (params) => {
             const result = await wikiTools.getWiki(params);
-            return { content: result.content, rawData: result.rawData, structuredContent: result.structuredContent };
+            return { content: result.content, rawData: result.rawData, isError: result.isError, structuredContent: result.structuredContent };
         });
         allowedTools.has("listWikiPages") && server.tool("listWikiPages", "List wiki pages under a path", {
             wikiIdentifier: zod_1.z.string().describe("Wiki name or ID"),
@@ -1535,7 +1539,7 @@ async function main() {
             project: zod_1.z.string().optional().describe("Project name or ID"),
         }, async (params) => {
             const result = await wikiTools.listWikiPages(params);
-            return { content: result.content, rawData: result.rawData, structuredContent: result.structuredContent };
+            return { content: result.content, rawData: result.rawData, isError: result.isError, structuredContent: result.structuredContent };
         });
         allowedTools.has("getWikiPageContent") && server.tool("getWikiPageContent", "Get the content of a wiki page", {
             wikiIdentifier: zod_1.z.string().describe("Wiki name or ID"),
@@ -1543,7 +1547,7 @@ async function main() {
             project: zod_1.z.string().optional().describe("Project name or ID"),
         }, async (params) => {
             const result = await wikiTools.getWikiPageContent(params);
-            return { content: result.content, rawData: result.rawData, structuredContent: result.structuredContent };
+            return { content: result.content, rawData: result.rawData, isError: result.isError, structuredContent: result.structuredContent };
         });
         allowedTools.has("createOrUpdateWikiPage") && server.tool("createOrUpdateWikiPage", "Create or update a wiki page with the given content", {
             wikiIdentifier: zod_1.z.string().describe("Wiki name or ID"),
@@ -1553,10 +1557,11 @@ async function main() {
             project: zod_1.z.string().optional().describe("Project name or ID"),
         }, async (params) => {
             const result = await wikiTools.createOrUpdateWikiPage(params);
-            return { content: result.content, rawData: result.rawData, structuredContent: result.structuredContent };
+            return { content: result.content, rawData: result.rawData, isError: result.isError, structuredContent: result.structuredContent };
         });
         // Register Build/Pipeline Tools
         allowedTools.has("getBuilds") && server.tool("getBuilds", "List builds with optional filters (status, result, branch, definition, tags)", {
+            project: zod_1.z.string().optional().describe("Azure DevOps project name or ID. Defaults to the configured project."),
             definitions: zIdArray().optional().describe("Filter by definition IDs"),
             statusFilter: zod_1.z.string().optional().describe("Filter by status: inProgress, completed, cancelling, postponed, notStarted, all"),
             resultFilter: zod_1.z.string().optional().describe("Filter by result: succeeded, partiallySucceeded, failed, canceled"),
@@ -1569,31 +1574,35 @@ async function main() {
             queryOrder: zod_1.z.string().optional().describe("Order: startTimeDescending (default) or startTimeAscending"),
         }, async (params) => {
             const result = await buildTools.getBuilds(params);
-            return { content: result.content, rawData: result.rawData, structuredContent: result.structuredContent };
+            return { content: result.content, rawData: result.rawData, isError: result.isError, structuredContent: result.structuredContent };
         });
         allowedTools.has("getBuild") && server.tool("getBuild", "Get detailed information about a specific build by ID", {
+            project: zod_1.z.string().optional().describe("Azure DevOps project name or ID. Defaults to the configured project."),
             buildId: zId().describe("Build ID"),
         }, async (params) => {
             const result = await buildTools.getBuild(params);
-            return { content: result.content, rawData: result.rawData, structuredContent: result.structuredContent };
+            return { content: result.content, rawData: result.rawData, isError: result.isError, structuredContent: result.structuredContent };
         });
         allowedTools.has("getBuildLog") && server.tool("getBuildLog", "Get build logs. Without logId returns log metadata list; with logId returns specific log content", {
+            project: zod_1.z.string().optional().describe("Azure DevOps project name or ID. Defaults to the configured project."),
             buildId: zId().describe("Build ID"),
             logId: zIdOptional().describe("Specific log ID to retrieve content for"),
             startLine: zod_1.z.coerce.number().optional().describe("Start line for log content"),
             endLine: zod_1.z.coerce.number().optional().describe("End line for log content"),
         }, async (params) => {
             const result = await buildTools.getBuildLog(params);
-            return { content: result.content, rawData: result.rawData, structuredContent: result.structuredContent };
+            return { content: result.content, rawData: result.rawData, isError: result.isError, structuredContent: result.structuredContent };
         });
         allowedTools.has("getBuildChanges") && server.tool("getBuildChanges", "Get changes (commits) associated with a build", {
+            project: zod_1.z.string().optional().describe("Azure DevOps project name or ID. Defaults to the configured project."),
             buildId: zId().describe("Build ID"),
             top: zod_1.z.coerce.number().optional().describe("Maximum number of changes to return (default 50)"),
         }, async (params) => {
             const result = await buildTools.getBuildChanges(params);
-            return { content: result.content, rawData: result.rawData, structuredContent: result.structuredContent };
+            return { content: result.content, rawData: result.rawData, isError: result.isError, structuredContent: result.structuredContent };
         });
         allowedTools.has("getDefinitions") && server.tool("getDefinitions", "List pipeline/build definitions with optional filters", {
+            project: zod_1.z.string().optional().describe("Azure DevOps project name or ID. Defaults to the configured project."),
             name: zod_1.z.string().optional().describe("Filter by definition name (wildcard supported)"),
             repositoryId: zod_1.z.string().optional().describe("Filter by repository ID"),
             repositoryType: zod_1.z.string().optional().describe("Repository type (e.g., 'TfsGit')"),
@@ -1602,41 +1611,56 @@ async function main() {
             includeLatestBuilds: zod_1.z.boolean().optional().describe("Include latest build info for each definition"),
         }, async (params) => {
             const result = await buildTools.getDefinitions(params);
-            return { content: result.content, rawData: result.rawData, structuredContent: result.structuredContent };
+            return { content: result.content, rawData: result.rawData, isError: result.isError, structuredContent: result.structuredContent };
         });
         allowedTools.has("getDefinition") && server.tool("getDefinition", "Get detailed information about a specific pipeline/build definition", {
+            project: zod_1.z.string().optional().describe("Azure DevOps project name or ID. Defaults to the configured project."),
             definitionId: zId().describe("Definition ID"),
             includeLatestBuilds: zod_1.z.boolean().optional().describe("Include latest build info"),
         }, async (params) => {
             const result = await buildTools.getDefinition(params);
-            return { content: result.content, rawData: result.rawData, structuredContent: result.structuredContent };
+            return { content: result.content, rawData: result.rawData, isError: result.isError, structuredContent: result.structuredContent };
         });
         allowedTools.has("runPipeline") && server.tool("runPipeline", "Queue/trigger a pipeline run", {
+            project: zod_1.z.string().optional().describe("Azure DevOps project name or ID. Defaults to the configured project."),
             definitionId: zId().describe("Pipeline definition ID to run"),
             sourceBranch: zod_1.z.string().optional().describe("Source branch (e.g., 'refs/heads/main')"),
             parameters: zod_1.z.record(zod_1.z.string()).optional().describe("Pipeline parameters as key-value pairs"),
         }, async (params) => {
             const result = await buildTools.runPipeline(params);
-            return { content: result.content, rawData: result.rawData, structuredContent: result.structuredContent };
+            return { content: result.content, rawData: result.rawData, isError: result.isError, structuredContent: result.structuredContent };
         });
         allowedTools.has("getBuildArtifacts") && server.tool("getBuildArtifacts", "List artifacts produced by a build", {
+            project: zod_1.z.string().optional().describe("Azure DevOps project name or ID. Defaults to the configured project."),
             buildId: zId().describe("Build ID"),
         }, async (params) => {
             const result = await buildTools.getBuildArtifacts(params);
-            return { content: result.content, rawData: result.rawData, structuredContent: result.structuredContent };
+            return { content: result.content, rawData: result.rawData, isError: result.isError, structuredContent: result.structuredContent };
         });
         allowedTools.has("getBuildTimeline") && server.tool("getBuildTimeline", "Get build timeline showing stages, jobs, and tasks with their status", {
+            project: zod_1.z.string().optional().describe("Azure DevOps project name or ID. Defaults to the configured project."),
             buildId: zId().describe("Build ID"),
         }, async (params) => {
             const result = await buildTools.getBuildTimeline(params);
-            return { content: result.content, rawData: result.rawData, structuredContent: result.structuredContent };
+            return { content: result.content, rawData: result.rawData, isError: result.isError, structuredContent: result.structuredContent };
         });
         allowedTools.has("getBuildWorkItems") && server.tool("getBuildWorkItems", "Get work items associated with a build", {
+            project: zod_1.z.string().optional().describe("Azure DevOps project name or ID. Defaults to the configured project."),
             buildId: zId().describe("Build ID"),
             top: zod_1.z.coerce.number().optional().describe("Maximum number of work items to return (default 50)"),
         }, async (params) => {
             const result = await buildTools.getBuildWorkItems(params);
-            return { content: result.content, rawData: result.rawData, structuredContent: result.structuredContent };
+            return { content: result.content, rawData: result.rawData, isError: result.isError, structuredContent: result.structuredContent };
+        });
+        allowedTools.has("getPullRequestBuilds") && server.tool("getPullRequestBuilds", "Get builds associated with a pull request. Extracts build IDs from PR policy evaluations and returns build details with optional timeline and log metadata. Use this to find build IDs for a PR, then use getBuildLog to read specific log content.", {
+            project: zod_1.z.string().optional().describe("Azure DevOps project name or ID. Defaults to the configured project."),
+            repository: zod_1.z.string().describe("Repository name or ID containing the pull request"),
+            pullRequestId: zId().describe("The pull request ID"),
+            includeTimeline: zod_1.z.boolean().optional().describe("Include build timeline (stages, jobs, tasks) for each build. Useful for seeing which stages/tasks failed."),
+            includeLogs: zod_1.z.boolean().optional().describe("Include log metadata (log IDs and line counts) for each build. Use the log IDs with getBuildLog to read actual log content."),
+        }, async (params) => {
+            const result = await buildTools.getPullRequestBuilds(params);
+            return { content: result.content, rawData: result.rawData, isError: result.isError, structuredContent: result.structuredContent };
         });
         // Create a transport (use stdio for simplicity)
         const transport = new stdio_js_1.StdioServerTransport();