@daghis/teamcity-mcp 2.4.2 → 2.5.0

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # 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)
+
+
+### Bug Fixes
+
+* use individual property PUTs in update_vcs_root_properties to prevent wiping existing properties ([#431](https://github.com/Daghis/teamcity-mcp/issues/431)) ([85bac24](https://github.com/Daghis/teamcity-mcp/commit/85bac244cb55f458bc2d22844c993d7f0446ea57)), closes [#428](https://github.com/Daghis/teamcity-mcp/issues/428)
+* use z.coerce.number() to accept string-encoded numeric params ([#432](https://github.com/Daghis/teamcity-mcp/issues/432)) ([6de9aa4](https://github.com/Daghis/teamcity-mcp/commit/6de9aa4c9b11e9c78a261c57381fc44e5f3ffd7b)), closes [#429](https://github.com/Daghis/teamcity-mcp/issues/429)
+
 ## [2.4.2](https://github.com/Daghis/teamcity-mcp/compare/teamcity-mcp-v2.4.1...teamcity-mcp-v2.4.2) (2026-03-17)
 
 

package/dist/index.js

@@ -1205,7 +1205,7 @@ function debug2(message, meta) {
 // package.json
 var package_default = {
   name: "@daghis/teamcity-mcp",
-  version: "2.4.2",
+  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",
@@ -38770,7 +38775,7 @@ var isReadableStream = (value) => typeof value === "object" && value !== null &&
 var isAxios4042 = (error3) => (0, import_axios36.isAxiosError)(error3) && error3.response?.status === 404;
 var buildIdentifierSchema = import_zod4.z.object({
   buildId: import_zod4.z.string().min(1).optional(),
-  buildNumber: import_zod4.z.union([import_zod4.z.string().min(1), import_zod4.z.number().int()]).optional(),
+  buildNumber: import_zod4.z.union([import_zod4.z.string().min(1), import_zod4.z.coerce.number().int()]).optional(),
   buildTypeId: import_zod4.z.string().min(1).optional()
 }).superRefine((value, ctx) => {
   if (!value.buildId && value.buildNumber === void 0) {
@@ -39142,8 +39147,8 @@ var DEV_TOOLS = [
       const schema = import_zod4.z.object({
         locator: import_zod4.z.string().min(1).optional(),
         parentProjectId: import_zod4.z.string().min(1).optional(),
-        pageSize: import_zod4.z.number().int().min(1).max(1e3).optional(),
-        maxPages: import_zod4.z.number().int().min(1).max(1e3).optional(),
+        pageSize: import_zod4.z.coerce.number().int().min(1).max(1e3).optional(),
+        maxPages: import_zod4.z.coerce.number().int().min(1).max(1e3).optional(),
         all: import_zod4.z.boolean().optional(),
         fields: import_zod4.z.string().min(1).optional()
       });
@@ -39245,9 +39250,9 @@ var DEV_TOOLS = [
         buildTypeId: import_zod4.z.string().min(1).optional(),
         branch: import_zod4.z.string().min(1).optional(),
         status: import_zod4.z.enum(["SUCCESS", "FAILURE", "ERROR"]).optional(),
-        count: import_zod4.z.number().int().min(1).max(1e3).default(10).optional(),
-        pageSize: import_zod4.z.number().int().min(1).max(1e3).optional(),
-        maxPages: import_zod4.z.number().int().min(1).max(1e3).optional(),
+        count: import_zod4.z.coerce.number().int().min(1).max(1e3).default(10).optional(),
+        pageSize: import_zod4.z.coerce.number().int().min(1).max(1e3).optional(),
+        maxPages: import_zod4.z.coerce.number().int().min(1).max(1e3).optional(),
         all: import_zod4.z.boolean().optional(),
         fields: import_zod4.z.string().min(1).optional()
       });
@@ -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)",
@@ -39658,12 +39752,12 @@ var DEV_TOOLS = [
     handler: async (args) => {
       const schema = import_zod4.z.object({
         buildId: import_zod4.z.string().min(1).optional(),
-        buildNumber: import_zod4.z.union([import_zod4.z.string().min(1), import_zod4.z.number().int().min(0)]).optional(),
+        buildNumber: import_zod4.z.union([import_zod4.z.string().min(1), import_zod4.z.coerce.number().int().min(0)]).optional(),
         buildTypeId: import_zod4.z.string().min(1).optional(),
-        page: import_zod4.z.number().int().min(1).optional(),
-        pageSize: import_zod4.z.number().int().min(1).max(5e3).optional(),
-        startLine: import_zod4.z.number().int().min(0).optional(),
-        lineCount: import_zod4.z.number().int().min(1).max(5e3).optional(),
+        page: import_zod4.z.coerce.number().int().min(1).optional(),
+        pageSize: import_zod4.z.coerce.number().int().min(1).max(5e3).optional(),
+        startLine: import_zod4.z.coerce.number().int().min(0).optional(),
+        lineCount: import_zod4.z.coerce.number().int().min(1).max(5e3).optional(),
         tail: import_zod4.z.boolean().optional(),
         encoding: import_zod4.z.enum(["text", "stream"]).default("text"),
         outputPath: import_zod4.z.string().min(1).optional()
@@ -39897,8 +39991,8 @@ var DEV_TOOLS = [
       const schema = import_zod4.z.object({
         locator: import_zod4.z.string().min(1).optional(),
         projectId: import_zod4.z.string().min(1).optional(),
-        pageSize: import_zod4.z.number().int().min(1).max(1e3).optional(),
-        maxPages: import_zod4.z.number().int().min(1).max(1e3).optional(),
+        pageSize: import_zod4.z.coerce.number().int().min(1).max(1e3).optional(),
+        maxPages: import_zod4.z.coerce.number().int().min(1).max(1e3).optional(),
         all: import_zod4.z.boolean().optional(),
         fields: import_zod4.z.string().min(1).optional()
       });
@@ -39987,8 +40081,8 @@ var DEV_TOOLS = [
     handler: async (args) => {
       const schema = buildIdentifierSchema.and(
         import_zod4.z.object({
-          pageSize: import_zod4.z.number().int().min(1).max(1e3).optional(),
-          maxPages: import_zod4.z.number().int().min(1).max(1e3).optional(),
+          pageSize: import_zod4.z.coerce.number().int().min(1).max(1e3).optional(),
+          maxPages: import_zod4.z.coerce.number().int().min(1).max(1e3).optional(),
           all: import_zod4.z.boolean().optional(),
           fields: import_zod4.z.string().min(1).optional()
         })
@@ -40049,8 +40143,8 @@ var DEV_TOOLS = [
     handler: async (args) => {
       const schema = import_zod4.z.object({
         projectId: import_zod4.z.string().min(1).optional(),
-        pageSize: import_zod4.z.number().int().min(1).max(1e3).optional(),
-        maxPages: import_zod4.z.number().int().min(1).max(1e3).optional(),
+        pageSize: import_zod4.z.coerce.number().int().min(1).max(1e3).optional(),
+        maxPages: import_zod4.z.coerce.number().int().min(1).max(1e3).optional(),
         all: import_zod4.z.boolean().optional(),
         fields: import_zod4.z.string().min(1).optional()
       });
@@ -40246,11 +40340,12 @@ var DEV_TOOLS = [
               updated: 0
             });
           }
-          await adapter.modules.vcsRoots.setVcsRootProperties(
-            typed.id,
-            void 0,
-            { property: properties },
-            { headers: { "Content-Type": "application/json", Accept: "application/json" } }
+          await Promise.all(
+            properties.map(
+              (p) => adapter.modules.vcsRoots.setVcsRootProperty(typed.id, p.name, p.value, {
+                headers: { "Content-Type": "text/plain", Accept: "text/plain" }
+              })
+            )
           );
           return json({
             success: true,
@@ -40287,8 +40382,8 @@ var DEV_TOOLS = [
     handler: async (args) => {
       const schema = import_zod4.z.object({
         locator: import_zod4.z.string().min(1).optional(),
-        pageSize: import_zod4.z.number().int().min(1).max(1e3).optional(),
-        maxPages: import_zod4.z.number().int().min(1).max(1e3).optional(),
+        pageSize: import_zod4.z.coerce.number().int().min(1).max(1e3).optional(),
+        maxPages: import_zod4.z.coerce.number().int().min(1).max(1e3).optional(),
         all: import_zod4.z.boolean().optional(),
         fields: import_zod4.z.string().min(1).optional()
       });
@@ -40698,8 +40793,8 @@ var DEV_TOOLS = [
     handler: async (args) => {
       const schema = import_zod4.z.object({
         locator: import_zod4.z.string().min(1).optional(),
-        pageSize: import_zod4.z.number().int().min(1).max(1e3).optional(),
-        maxPages: import_zod4.z.number().int().min(1).max(1e3).optional(),
+        pageSize: import_zod4.z.coerce.number().int().min(1).max(1e3).optional(),
+        maxPages: import_zod4.z.coerce.number().int().min(1).max(1e3).optional(),
         all: import_zod4.z.boolean().optional(),
         fields: import_zod4.z.string().min(1).optional()
       });
@@ -40757,8 +40852,8 @@ var DEV_TOOLS = [
     },
     handler: async (args) => {
       const schema = import_zod4.z.object({
-        pageSize: import_zod4.z.number().int().min(1).max(1e3).optional(),
-        maxPages: import_zod4.z.number().int().min(1).max(1e3).optional(),
+        pageSize: import_zod4.z.coerce.number().int().min(1).max(1e3).optional(),
+        maxPages: import_zod4.z.coerce.number().int().min(1).max(1e3).optional(),
         all: import_zod4.z.boolean().optional(),
         fields: import_zod4.z.string().min(1).optional()
       });
@@ -40845,13 +40940,13 @@ var DEV_TOOLS = [
       const schema = import_zod4.z.object({
         buildId: import_zod4.z.string().min(1).optional(),
         buildTypeId: import_zod4.z.string().min(1).optional(),
-        buildNumber: import_zod4.z.union([import_zod4.z.string().min(1), import_zod4.z.number().int()]).optional(),
+        buildNumber: import_zod4.z.union([import_zod4.z.string().min(1), import_zod4.z.coerce.number().int()]).optional(),
         includeArtifacts: import_zod4.z.boolean().optional(),
         includeStatistics: import_zod4.z.boolean().optional(),
         includeChanges: import_zod4.z.boolean().optional(),
         includeDependencies: import_zod4.z.boolean().optional(),
         artifactFilter: import_zod4.z.string().min(1).optional(),
-        maxArtifactSize: import_zod4.z.number().int().min(1).optional(),
+        maxArtifactSize: import_zod4.z.coerce.number().int().min(1).optional(),
         artifactEncoding: import_zod4.z.enum(["base64", "stream"]).default("base64")
       }).superRefine((value, ctx) => {
         const hasBuildId = typeof value.buildId === "string" && value.buildId.trim().length > 0;
@@ -40949,7 +41044,7 @@ var DEV_TOOLS = [
         import_zod4.z.object({
           artifactPath: import_zod4.z.string().min(1),
           encoding: import_zod4.z.enum(["base64", "text", "stream"]).default("base64"),
-          maxSize: import_zod4.z.number().int().positive().optional(),
+          maxSize: import_zod4.z.coerce.number().int().positive().optional(),
           outputPath: import_zod4.z.string().min(1).optional()
         })
       );
@@ -41036,7 +41131,7 @@ var DEV_TOOLS = [
         import_zod4.z.object({
           artifactPaths: import_zod4.z.array(artifactInputSchema).min(1),
           encoding: import_zod4.z.enum(["base64", "text", "stream"]).default("base64"),
-          maxSize: import_zod4.z.number().int().positive().optional(),
+          maxSize: import_zod4.z.coerce.number().int().positive().optional(),
           outputDir: import_zod4.z.string().min(1).optional().refine((value) => value == null || (0, import_node_path.isAbsolute)(value), {
             message: "outputDir must be an absolute path"
           })
@@ -41227,8 +41322,8 @@ var DEV_TOOLS = [
         locator: import_zod4.z.string().min(1).optional(),
         projectId: import_zod4.z.string().min(1).optional(),
         buildId: import_zod4.z.string().min(1).optional(),
-        pageSize: import_zod4.z.number().int().min(1).max(1e3).optional(),
-        maxPages: import_zod4.z.number().int().min(1).max(1e3).optional(),
+        pageSize: import_zod4.z.coerce.number().int().min(1).max(1e3).optional(),
+        maxPages: import_zod4.z.coerce.number().int().min(1).max(1e3).optional(),
         all: import_zod4.z.boolean().optional(),
         fields: import_zod4.z.string().min(1).optional()
       });
@@ -41297,8 +41392,8 @@ var DEV_TOOLS = [
         locator: import_zod4.z.string().min(1).optional(),
         projectId: import_zod4.z.string().min(1).optional(),
         buildId: import_zod4.z.string().min(1).optional(),
-        pageSize: import_zod4.z.number().int().min(1).max(1e3).optional(),
-        maxPages: import_zod4.z.number().int().min(1).max(1e3).optional(),
+        pageSize: import_zod4.z.coerce.number().int().min(1).max(1e3).optional(),
+        maxPages: import_zod4.z.coerce.number().int().min(1).max(1e3).optional(),
         all: import_zod4.z.boolean().optional(),
         fields: import_zod4.z.string().min(1).optional()
       });
@@ -41373,8 +41468,8 @@ var DEV_TOOLS = [
         locator: import_zod4.z.string().min(1).optional(),
         buildId: import_zod4.z.string().min(1).optional(),
         problemId: import_zod4.z.string().min(1).optional(),
-        pageSize: import_zod4.z.number().int().min(1).max(1e3).optional(),
-        maxPages: import_zod4.z.number().int().min(1).max(1e3).optional(),
+        pageSize: import_zod4.z.coerce.number().int().min(1).max(1e3).optional(),
+        maxPages: import_zod4.z.coerce.number().int().min(1).max(1e3).optional(),
         all: import_zod4.z.boolean().optional(),
         fields: import_zod4.z.string().min(1).optional()
       });
@@ -41454,8 +41549,8 @@ var DEV_TOOLS = [
         projectId: import_zod4.z.string().min(1).optional(),
         buildTypeId: import_zod4.z.string().min(1).optional(),
         assigneeUsername: import_zod4.z.string().min(1).optional(),
-        pageSize: import_zod4.z.number().int().min(1).max(1e3).optional(),
-        maxPages: import_zod4.z.number().int().min(1).max(1e3).optional(),
+        pageSize: import_zod4.z.coerce.number().int().min(1).max(1e3).optional(),
+        maxPages: import_zod4.z.coerce.number().int().min(1).max(1e3).optional(),
         all: import_zod4.z.boolean().optional(),
         fields: import_zod4.z.string().min(1).optional()
       });
@@ -41531,8 +41626,8 @@ var DEV_TOOLS = [
         projectId: import_zod4.z.string().min(1).optional(),
         buildTypeId: import_zod4.z.string().min(1).optional(),
         testNameId: import_zod4.z.string().min(1).optional(),
-        pageSize: import_zod4.z.number().int().min(1).max(1e3).optional(),
-        maxPages: import_zod4.z.number().int().min(1).max(1e3).optional(),
+        pageSize: import_zod4.z.coerce.number().int().min(1).max(1e3).optional(),
+        maxPages: import_zod4.z.coerce.number().int().min(1).max(1e3).optional(),
         all: import_zod4.z.boolean().optional(),
         fields: import_zod4.z.string().min(1).optional()
       });
@@ -41638,8 +41733,8 @@ var DEV_TOOLS = [
       const schema = import_zod4.z.object({
         locator: import_zod4.z.string().min(1).optional(),
         groupId: import_zod4.z.string().min(1).optional(),
-        pageSize: import_zod4.z.number().int().min(1).max(1e3).optional(),
-        maxPages: import_zod4.z.number().int().min(1).max(1e3).optional(),
+        pageSize: import_zod4.z.coerce.number().int().min(1).max(1e3).optional(),
+        maxPages: import_zod4.z.coerce.number().int().min(1).max(1e3).optional(),
         all: import_zod4.z.boolean().optional(),
         fields: import_zod4.z.string().min(1).optional()
       });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@daghis/teamcity-mcp",
-  "version": "2.4.2",
+  "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.2",
+  "version": "2.5.0",
   "packages": [
     {
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@daghis/teamcity-mcp",
-      "version": "2.4.2",
+      "version": "2.5.0",
       "runtimeHint": "npx",
       "runtimeArguments": [
         {