chore(deps): merge main, bump deps to patched versions, release 1.2.26

Author: SavioBS629

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "@browserstack/mcp-server",
-  "version": "1.2.23",
+  "version": "1.2.25",
   "description": "BrowserStack's Official MCP Server",
   "mcpName": "io.github.browserstack/mcp-server",
   "main": "dist/index.js",

package.json

@@ -11,7 +11,7 @@
     {
       "registryType": "npm",
       "identifier": "@browserstack/mcp-server",
-      "version": "1.2.23",
+      "version": "1.2.25",
       "transport": {
         "type": "stdio"
       },

server.json

@@ -65,15 +65,14 @@ export async function getTestIds(
   }
 }
 
-// Recursive function to extract failed test IDs from hierarchy
-function extractFailedTestIds(
+export function extractFailedTestIds(
   hierarchy: TestDetails[],
   status?: TestStatus,
 ): FailedTestInfo[] {
   let failedTests: FailedTestInfo[] = [];
 
   for (const node of hierarchy) {
-    if (node.details?.status === status && node.details?.run_count) {
+    if (node.details?.status === status) {
       if (node.details?.observability_url) {
         const idMatch = node.details.observability_url.match(/details=(\d+)/);
         if (idMatch) {

src/tools/rca-agent-utils/get-failed-test-id.ts

@@ -0,0 +1,34 @@
+import { apiClient } from "../../lib/apiClient.js";
+
+/**
+ * Returns the latest build for a project + build name across all users (not just the caller's).
+ */
+export async function listBuildId(
+  projectName: string,
+  buildName: string,
+  username: string,
+  accessKey: string,
+): Promise<string> {
+  const authHeader =
+    "Basic " + Buffer.from(`${username}:${accessKey}`).toString("base64");
+
+  const response = await apiClient.get({
+    url: "https://api-automation.browserstack.com/ext/v1/builds/latest",
+    headers: {
+      Authorization: authHeader,
+      "Content-Type": "application/json",
+    },
+    params: {
+      project_name: projectName,
+      build_name: buildName,
+    },
+  });
+
+  const buildId = response.data?.build_id;
+  if (!buildId) {
+    throw new Error(
+      `No build found for project "${projectName}" and build "${buildName}"`,
+    );
+  }
+  return buildId;
+}

src/tools/rca-agent-utils/list-build-id.ts

@@ -4,6 +4,7 @@ import logger from "../logger.js";
 import { BrowserStackConfig } from "../lib/types.js";
 import { getBrowserStackAuth } from "../lib/get-auth.js";
 import { getBuildId } from "./rca-agent-utils/get-build-id.js";
+import { listBuildId } from "./rca-agent-utils/list-build-id.js";
 import { getTestIds } from "./rca-agent-utils/get-failed-test-id.js";
 import { getRCAData } from "./rca-agent-utils/rca-data.js";
 import { formatRCAData } from "./rca-agent-utils/format-rca.js";
@@ -59,6 +60,48 @@ export async function getBuildIdTool(
   }
 }
 
+// Tool function to fetch the build ID across all users (no user scoping)
+export async function listBuildIdTool(
+  args: BuildIdArgs,
+  config: BrowserStackConfig,
+): Promise<CallToolResult> {
+  try {
+    const { browserStackProjectName, browserStackBuildName } = args;
+
+    const authString = getBrowserStackAuth(config);
+    const [username, accessKey] = authString.split(":");
+
+    const buildId = await listBuildId(
+      browserStackProjectName,
+      browserStackBuildName,
+      username,
+      accessKey,
+    );
+
+    return {
+      content: [
+        {
+          type: "text",
+          text: buildId,
+        },
+      ],
+    };
+  } catch (error) {
+    logger.error("Error fetching build ID", error);
+    const errorMessage =
+      error instanceof Error ? error.message : "Unknown error";
+    return {
+      content: [
+        {
+          type: "text",
+          text: `Error fetching build ID: ${errorMessage}`,
+        },
+      ],
+      isError: true,
+    };
+  }
+}
+
 // Tool function that fetches RCA data
 export async function fetchRCADataTool(
   args: { testId: number[] },
@@ -144,7 +187,7 @@ export default function addRCATools(
 
   tools.fetchRCA = server.tool(
     "fetchRCA",
-    "Fetch AI Root Cause Analysis for failed BrowserStack Automate/App-Automate tests. Suggests fixes only; never auto-apply, require explicit user approval.",
+    "Fetch AI Root Cause Analysis for the current user's failed BrowserStack Automate/App-Automate tests. Suggests fixes only; never auto-apply, require explicit user approval.",
     FETCH_RCA_PARAMS,
     async (args) => {
       try {
@@ -163,7 +206,7 @@ export default function addRCATools(
 
   tools.getBuildId = server.tool(
     "getBuildId",
-    "Get the BrowserStack build ID for a given project and build name.",
+    "Get the BrowserStack build ID for a given project and build name, scoped to the current user's builds.",
     GET_BUILD_ID_PARAMS,
     async (args) => {
       try {
@@ -180,6 +223,25 @@ export default function addRCATools(
     },
   );
 
+  tools.listBuildId = server.tool(
+    "listBuildId",
+    "Get the latest build ID for a project and build name, across all users (no user filter).",
+    GET_BUILD_ID_PARAMS,
+    async (args) => {
+      try {
+        trackMCP(
+          "listBuildId",
+          server.server.getClientVersion()!,
+          undefined,
+          config,
+        );
+        return await listBuildIdTool(args, config);
+      } catch (error) {
+        return handleMCPError("listBuildId", server, config, error);
+      }
+    },
+  );
+
   tools.listTestIds = server.tool(
     "listTestIds",
     "List test IDs from a BrowserStack Automate build, optionally filtered by status",

src/tools/rca-agent.ts

@@ -5,6 +5,7 @@ import {
   FETCH_DETAILS_URL,
   FORM_FIELDS_URL,
   BULK_CREATE_URL,
+  TC_DETAILS_MAX_BATCH,
 } from "./config.js";
 import {
   DefaultFieldMaps,
@@ -228,11 +229,13 @@ export async function pollScenariosTestDetails(
           if (msg.type === "testcase") {
             const sc = msg.data.scenario;
             if (sc) {
-              const array = Array.isArray(msg.data.testcases)
-                ? msg.data.testcases
-                : msg.data.testcases
-                  ? [msg.data.testcases]
-                  : [];
+              const array = (
+                Array.isArray(msg.data.testcases)
+                  ? msg.data.testcases
+                  : msg.data.testcases
+                    ? [msg.data.testcases]
+                    : []
+              ).slice(0, TC_DETAILS_MAX_BATCH);
               const ids = array.map((tc: any) => tc.id || tc.test_case_id);
 
               const reqId = await fetchTestCaseDetails(
@@ -315,11 +318,12 @@ export async function bulkCreateTestCases(
   const BULK_CREATE_URL_VALUE = BULK_CREATE_URL(tmBaseUrl, projectId, folderId);
 
   for (const { id, testcases } of Object.values(scenariosMap)) {
-    const testCaseLength = testcases.length;
+    const cappedTestcases = testcases.slice(0, TC_DETAILS_MAX_BATCH);
+    const testCaseLength = cappedTestcases.length;
     testCaseCount += testCaseLength;
     if (testCaseLength === 0) continue;
     const payload = {
-      test_cases: testcases.map((tc) =>
+      test_cases: cappedTestcases.map((tc) =>
         createTestCasePayload(
           tc,
           id,

src/tools/testmanagement-utils/TCG-utils/api.ts

@@ -1,3 +1,5 @@
+export const TC_DETAILS_MAX_BATCH = 10;
+
 export const TCG_TRIGGER_URL = (baseUrl: string) =>
   `${baseUrl}/api/v1/integration/tcg/test-generation/suggest-test-cases`;