@daghis/teamcity-mcp 2.4.3 → 2.5.0

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [2.5.0](https://github.com/Daghis/teamcity-mcp/compare/teamcity-mcp-v2.4.3...teamcity-mcp-v2.5.0) (2026-03-18)
+
+
+### Features
+
+* add wait_for_build tool to poll until build completes ([#430](https://github.com/Daghis/teamcity-mcp/issues/430)) ([#433](https://github.com/Daghis/teamcity-mcp/issues/433)) ([a83e6cf](https://github.com/Daghis/teamcity-mcp/commit/a83e6cf99e4c523103bf894ee3d58c91734853f6))
+
 ## [2.4.3](https://github.com/Daghis/teamcity-mcp/compare/teamcity-mcp-v2.4.2...teamcity-mcp-v2.4.3) (2026-03-18)
 
 

package/dist/index.js

@@ -1205,7 +1205,7 @@ function debug2(message, meta) {
 // package.json
 var package_default = {
   name: "@daghis/teamcity-mcp",
-  version: "2.4.3",
+  version: "2.5.0",
   description: "Model Control Protocol server for TeamCity CI/CD integration with AI coding assistants",
   mcpName: "io.github.Daghis/teamcity",
   main: "dist/index.js",
@@ -4140,6 +4140,11 @@ async function fetchAllPages(fetchFn, options = {}) {
   return allItems;
 }
 
+// src/utils/async/index.ts
+function sleep(ms) {
+  return new Promise((resolve2) => setTimeout(resolve2, ms));
+}
+
 // src/utils/list-builds-locator.ts
 var SIMPLE_BRANCH_VALUES = /* @__PURE__ */ new Set([
   "default:true",
@@ -39622,6 +39627,95 @@ var DEV_TOOLS = [
       );
     }
   },
+  {
+    name: "wait_for_build",
+    description: "Wait for a build to complete by polling until it reaches a terminal state (finished, canceled, failed) or timeout",
+    inputSchema: {
+      type: "object",
+      properties: {
+        buildId: { type: "string", description: "Build ID to wait for" },
+        buildNumber: {
+          type: "string",
+          description: "Human build number (requires buildTypeId)"
+        },
+        buildTypeId: {
+          type: "string",
+          description: "Build configuration ID (required with buildNumber)"
+        },
+        timeout: {
+          type: "number",
+          description: "Max seconds to wait (default 600, max 3600)"
+        },
+        pollInterval: {
+          type: "number",
+          description: "Seconds between polls (default 15, min 5)"
+        },
+        includeTests: { type: "boolean", description: "Include test summary in result" },
+        includeProblems: { type: "boolean", description: "Include build problems in result" }
+      }
+    },
+    handler: async (args) => {
+      const schema = import_zod4.z.object({
+        buildId: import_zod4.z.string().min(1).optional(),
+        buildNumber: import_zod4.z.string().min(1).optional(),
+        buildTypeId: import_zod4.z.string().min(1).optional(),
+        timeout: import_zod4.z.coerce.number().int().min(1).max(3600).default(600),
+        pollInterval: import_zod4.z.coerce.number().int().min(5).max(300).default(15),
+        includeTests: import_zod4.z.boolean().optional(),
+        includeProblems: import_zod4.z.boolean().optional()
+      }).superRefine((value, ctx) => {
+        if (!value.buildId && !value.buildNumber) {
+          ctx.addIssue({
+            code: import_zod4.z.ZodIssueCode.custom,
+            path: ["buildId"],
+            message: "Either buildId or buildNumber must be provided"
+          });
+        }
+        if (value.buildNumber && !value.buildTypeId) {
+          ctx.addIssue({
+            code: import_zod4.z.ZodIssueCode.custom,
+            path: ["buildTypeId"],
+            message: "buildTypeId is required when querying by buildNumber"
+          });
+        }
+      });
+      return runTool(
+        "wait_for_build",
+        schema,
+        async (typed) => {
+          const adapter = createAdapterFromTeamCityAPI(TeamCityAPI.getInstance());
+          const statusManager = new (await Promise.resolve().then(() => (init_build_status_manager(), build_status_manager_exports))).BuildStatusManager(adapter);
+          const deadline = Date.now() + typed.timeout * 1e3;
+          const terminalStates = /* @__PURE__ */ new Set(["finished", "canceled", "failed"]);
+          let pollCount = 0;
+          const startTime = Date.now();
+          while (true) {
+            pollCount++;
+            const result = await statusManager.getBuildStatus({
+              buildId: typed.buildId,
+              buildNumber: typed.buildNumber,
+              buildTypeId: typed.buildTypeId,
+              includeTests: typed.includeTests,
+              includeProblems: typed.includeProblems,
+              forceRefresh: true
+            });
+            const waitSeconds = Math.round((Date.now() - startTime) / 1e3);
+            debug2(
+              `wait_for_build poll #${pollCount}: state=${result.state} (${waitSeconds}s elapsed)`
+            );
+            if (terminalStates.has(result.state)) {
+              return json({ ...result, pollCount, waitSeconds });
+            }
+            if (Date.now() >= deadline) {
+              return json({ ...result, timedOut: true, pollCount, waitSeconds });
+            }
+            await sleep(typed.pollInterval * 1e3);
+          }
+        },
+        args
+      );
+    }
+  },
   {
     name: "fetch_build_log",
     description: "Fetch build log with pagination (by lines)",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@daghis/teamcity-mcp",
-  "version": "2.4.3",
+  "version": "2.5.0",
   "description": "Model Control Protocol server for TeamCity CI/CD integration with AI coding assistants",
   "mcpName": "io.github.Daghis/teamcity",
   "main": "dist/index.js",

package/server.json

@@ -7,13 +7,13 @@
     "source": "github"
   },
   "websiteUrl": "https://github.com/Daghis/teamcity-mcp",
-  "version": "2.4.3",
+  "version": "2.5.0",
   "packages": [
     {
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@daghis/teamcity-mcp",
-      "version": "2.4.3",
+      "version": "2.5.0",
       "runtimeHint": "npx",
       "runtimeArguments": [
         {