@daghis/teamcity-mcp 2.2.3 → 2.3.0

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [2.3.0](https://github.com/Daghis/teamcity-mcp/compare/teamcity-mcp-v2.2.3...teamcity-mcp-v2.3.0) (2026-03-10)
+
+
+### Features
+
+* **tools:** accept buildNumber + buildTypeId across all build tools ([#410](https://github.com/Daghis/teamcity-mcp/issues/410)) ([9aa005d](https://github.com/Daghis/teamcity-mcp/commit/9aa005d01bf6db9e7ac53155680876dc36202da7))
+
 ## [2.2.3](https://github.com/Daghis/teamcity-mcp/compare/teamcity-mcp-v2.2.2...teamcity-mcp-v2.2.3) (2026-03-09)
 
 

package/dist/index.js

@@ -1205,7 +1205,7 @@ function debug2(message, meta) {
 // package.json
 var package_default = {
   name: "@daghis/teamcity-mcp",
-  version: "2.2.3",
+  version: "2.3.0",
   description: "Model Control Protocol server for TeamCity CI/CD integration with AI coding assistants",
   mcpName: "io.github.Daghis/teamcity",
   main: "dist/index.js",
@@ -38826,6 +38826,55 @@ var TeamCityAPI = class _TeamCityAPI {
 // src/tools.ts
 var isReadableStream = (value) => typeof value === "object" && value !== null && typeof value.pipe === "function";
 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(),
+  buildTypeId: import_zod4.z.string().min(1).optional()
+}).superRefine((value, ctx) => {
+  if (!value.buildId && value.buildNumber === void 0) {
+    ctx.addIssue({
+      code: import_zod4.z.ZodIssueCode.custom,
+      path: ["buildId"],
+      message: "Either buildId or (buildNumber + buildTypeId) must be provided"
+    });
+  }
+  if (value.buildNumber !== void 0 && !value.buildTypeId) {
+    ctx.addIssue({
+      code: import_zod4.z.ZodIssueCode.custom,
+      path: ["buildTypeId"],
+      message: "buildTypeId is required when querying by buildNumber"
+    });
+  }
+});
+function resolveBuildLocator(input) {
+  const trimmedBuildId = typeof input.buildId === "string" ? input.buildId.trim() : void 0;
+  if (trimmedBuildId && trimmedBuildId.length > 0) {
+    return { locator: `id:${trimmedBuildId}`, friendlyId: `ID '${trimmedBuildId}'` };
+  }
+  const buildNumber = input.buildNumber !== void 0 ? String(input.buildNumber).trim() : void 0;
+  const buildTypeId = input.buildTypeId?.trim();
+  if (buildTypeId && buildNumber) {
+    return {
+      locator: `buildType:(id:${buildTypeId}),number:${buildNumber}`,
+      friendlyId: `build type '${buildTypeId}' #${buildNumber}`
+    };
+  }
+  throw new TeamCityAPIError("Unable to resolve build identifier", "INVALID_BUILD_IDENTIFIER");
+}
+var buildIdentifierInputProperties = {
+  buildId: { type: "string", description: "Build ID (internal TeamCity ID)" },
+  buildNumber: {
+    oneOf: [
+      { type: "string", description: 'Build number as TeamCity displays it (e.g. "886")' },
+      { type: "number", description: "Numeric build number" }
+    ],
+    description: "Human-readable build number (requires buildTypeId)"
+  },
+  buildTypeId: {
+    type: "string",
+    description: "Build configuration ID (required when using buildNumber)"
+  }
+};
 var sanitizeFileName = (artifactName) => {
   const base = (0, import_node_path.basename)(artifactName || "artifact");
   const safeBase = base.replace(/[^a-zA-Z0-9._-]/g, "_") || "artifact";
@@ -39316,31 +39365,34 @@ var DEV_TOOLS = [
     inputSchema: {
       type: "object",
       properties: {
-        buildId: { type: "string", description: "Build ID" }
-      },
-      required: ["buildId"]
+        ...buildIdentifierInputProperties
+      }
     },
     handler: async (args) => {
-      const schema = import_zod4.z.object({ buildId: import_zod4.z.string().min(1) });
+      const schema = buildIdentifierSchema;
       return runTool(
         "get_build",
         schema,
         async (typed) => {
           const adapter = createAdapterFromTeamCityAPI(TeamCityAPI.getInstance());
+          const { locator, friendlyId } = resolveBuildLocator(typed);
           try {
-            const build2 = await adapter.getBuild(typed.buildId);
-            return json(build2);
+            const build = await adapter.getBuild(locator);
+            return json(build);
           } catch (error3) {
             if (!isAxios4042(error3)) throw error3;
           }
-          try {
-            const qb = await adapter.modules.buildQueue.getQueuedBuild(`id:${typed.buildId}`);
-            return json({ ...qb.data, state: "queued" });
-          } catch (queueError) {
-            if (!isAxios4042(queueError)) throw queueError;
+          if (typed.buildId) {
+            try {
+              const qb = await adapter.modules.buildQueue.getQueuedBuild(`id:${typed.buildId}`);
+              return json({ ...qb.data, state: "queued" });
+            } catch (queueError) {
+              if (!isAxios4042(queueError)) throw queueError;
+            }
+            const build = await adapter.getBuild(locator);
+            return json(build);
           }
-          const build = await adapter.getBuild(typed.buildId);
-          return json(build);
+          throw new TeamCityNotFoundError(`Build not found for ${friendlyId}`);
         },
         args
       );
@@ -39980,7 +40032,7 @@ var DEV_TOOLS = [
     inputSchema: {
       type: "object",
       properties: {
-        buildId: { type: "string", description: "Build ID" },
+        ...buildIdentifierInputProperties,
         pageSize: { type: "number", description: "Items per page (default 100)" },
         maxPages: { type: "number", description: "Max pages to fetch (when all=true)" },
         all: { type: "boolean", description: "Fetch all pages up to maxPages" },
@@ -39988,25 +40040,26 @@ var DEV_TOOLS = [
           type: "string",
           description: "Optional fields selector for server-side projection"
         }
-      },
-      required: ["buildId"]
+      }
     },
     handler: async (args) => {
-      const schema = import_zod4.z.object({
-        buildId: import_zod4.z.string().min(1),
-        pageSize: import_zod4.z.number().int().min(1).max(1e3).optional(),
-        maxPages: import_zod4.z.number().int().min(1).max(1e3).optional(),
-        all: import_zod4.z.boolean().optional(),
-        fields: import_zod4.z.string().min(1).optional()
-      });
+      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(),
+          all: import_zod4.z.boolean().optional(),
+          fields: import_zod4.z.string().min(1).optional()
+        })
+      );
       return runTool(
         "list_test_failures",
         schema,
         async (typed) => {
           const adapter = createAdapterFromTeamCityAPI(TeamCityAPI.getInstance());
+          const { locator: buildLocator } = resolveBuildLocator(typed);
           const pageSize = typed.pageSize ?? 100;
           const baseFetch = async ({ count, start }) => {
-            const parts = [`build:(id:${typed.buildId})`, "status:FAILURE"];
+            const parts = [`build:(${buildLocator})`, "status:FAILURE"];
             if (typeof count === "number") parts.push(`count:${count}`);
             if (typeof start === "number") parts.push(`start:${start}`);
             const locator = parts.join(",");
@@ -40930,7 +40983,7 @@ var DEV_TOOLS = [
     inputSchema: {
       type: "object",
       properties: {
-        buildId: { type: "string", description: "Build ID" },
+        ...buildIdentifierInputProperties,
         artifactPath: { type: "string", description: "Artifact path or name" },
         encoding: {
           type: "string",
@@ -40947,31 +41000,33 @@ var DEV_TOOLS = [
           description: "Optional absolute path to write streamed content; defaults to a temp file when streaming"
         }
       },
-      required: ["buildId", "artifactPath"]
+      required: ["artifactPath"]
     },
     handler: async (args) => {
-      const schema = import_zod4.z.object({
-        buildId: import_zod4.z.string().min(1),
-        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(),
-        outputPath: import_zod4.z.string().min(1).optional()
-      });
+      const schema = buildIdentifierSchema.and(
+        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(),
+          outputPath: import_zod4.z.string().min(1).optional()
+        })
+      );
       return runTool(
         "download_build_artifact",
         schema,
         async (typed) => {
           const encoding = typed.encoding ?? "base64";
           const adapter = createAdapterFromTeamCityAPI(TeamCityAPI.getInstance());
+          const { locator: buildLocator } = resolveBuildLocator(typed);
           debug2("tools.download_build_artifact.start", {
-            buildId: typed.buildId,
+            buildLocator,
             encoding,
             artifactPath: typed.artifactPath,
             maxSize: typed.maxSize,
             outputPath: typed.outputPath
           });
           const manager = new ArtifactManager(adapter);
-          const artifact = await manager.downloadArtifact(typed.buildId, typed.artifactPath, {
+          const artifact = await manager.downloadArtifact(buildLocator, typed.artifactPath, {
             encoding,
             maxSize: typed.maxSize
           });
@@ -40990,7 +41045,7 @@ var DEV_TOOLS = [
     inputSchema: {
       type: "object",
       properties: {
-        buildId: { type: "string", description: "Build ID" },
+        ...buildIdentifierInputProperties,
         artifactPaths: {
           type: "array",
           description: "Artifact paths or names to download",
@@ -41024,7 +41079,7 @@ var DEV_TOOLS = [
           description: "Optional absolute directory to write streamed artifacts; defaults to temp files when streaming"
         }
       },
-      required: ["buildId", "artifactPaths"]
+      required: ["artifactPaths"]
     },
     handler: async (args) => {
       const artifactInputSchema = import_zod4.z.union([
@@ -41035,31 +41090,33 @@ var DEV_TOOLS = [
           downloadUrl: import_zod4.z.string().url().optional()
         })
       ]);
-      const schema = import_zod4.z.object({
-        buildId: import_zod4.z.string().min(1),
-        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(),
-        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"
+      const schema = buildIdentifierSchema.and(
+        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(),
+          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"
+          })
+        }).superRefine((value, ctx) => {
+          if (value.encoding !== "stream" && value.outputDir) {
+            ctx.addIssue({
+              code: import_zod4.z.ZodIssueCode.custom,
+              message: 'outputDir can only be provided when encoding is set to "stream"',
+              path: ["outputDir"]
+            });
+          }
         })
-      }).superRefine((value, ctx) => {
-        if (value.encoding !== "stream" && value.outputDir) {
-          ctx.addIssue({
-            code: import_zod4.z.ZodIssueCode.custom,
-            message: 'outputDir can only be provided when encoding is set to "stream"',
-            path: ["outputDir"]
-          });
-        }
-      });
+      );
       return runTool(
         "download_build_artifacts",
         schema,
         async (typed) => {
           const encoding = typed.encoding ?? "base64";
           const adapter = createAdapterFromTeamCityAPI(TeamCityAPI.getInstance());
+          const { locator: buildLocator } = resolveBuildLocator(typed);
           const manager = new ArtifactManager(adapter);
-          const requests = toNormalizedArtifactRequests(typed.artifactPaths, typed.buildId);
+          const requests = toNormalizedArtifactRequests(typed.artifactPaths, buildLocator);
           const results = [];
           for (const request of requests) {
             try {
@@ -41148,22 +41205,23 @@ var DEV_TOOLS = [
     inputSchema: {
       type: "object",
       properties: {
-        buildId: { type: "string", description: "Build ID" },
+        ...buildIdentifierInputProperties,
         testNameId: { type: "string", description: "Test name ID (optional)" }
-      },
-      required: ["buildId"]
+      }
     },
     handler: async (args) => {
-      const schema = import_zod4.z.object({
-        buildId: import_zod4.z.string().min(1),
-        testNameId: import_zod4.z.string().min(1).optional()
-      });
+      const schema = buildIdentifierSchema.and(
+        import_zod4.z.object({
+          testNameId: import_zod4.z.string().min(1).optional()
+        })
+      );
       return runTool(
         "get_test_details",
         schema,
         async (typed) => {
           const adapter = createAdapterFromTeamCityAPI(TeamCityAPI.getInstance());
-          let locator = `build:(id:${typed.buildId})`;
+          const { locator: buildLocator } = resolveBuildLocator(typed);
+          let locator = `build:(${buildLocator})`;
           if (typed.testNameId) locator += `,test:(id:${typed.testNameId})`;
           const response = await adapter.modules.tests.getAllTestOccurrences(locator);
           return json(response.data);
@@ -41178,20 +41236,20 @@ var DEV_TOOLS = [
     inputSchema: {
       type: "object",
       properties: {
-        buildId: { type: "string", description: "Build ID to analyze" }
-      },
-      required: ["buildId"]
+        ...buildIdentifierInputProperties
+      }
     },
     handler: async (args) => {
-      const schema = import_zod4.z.object({ buildId: import_zod4.z.string().min(1) });
+      const schema = buildIdentifierSchema;
       return runTool(
         "analyze_build_problems",
         schema,
         async (typed) => {
           const adapter = createAdapterFromTeamCityAPI(TeamCityAPI.getInstance());
-          const build = await adapter.getBuild(typed.buildId);
-          const problems = await adapter.modules.builds.getBuildProblems(`id:${typed.buildId}`);
-          const failures = await adapter.listTestFailures(typed.buildId);
+          const { locator: buildLocator } = resolveBuildLocator(typed);
+          const build = await adapter.getBuild(buildLocator);
+          const problems = await adapter.modules.builds.getBuildProblems(buildLocator);
+          const failures = await adapter.listTestFailures(buildLocator);
           return json({
             buildStatus: build.status,
             statusText: build.statusText,

package/package.json

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