@browserstack/mcp-server 2.2.5-beta.1 → 2.2.5

package/dist/tools/accessibility.js

@@ -162,12 +162,18 @@ const PROCESSING_STATUSES = new Set([
     "processing",
     "finalizing",
 ]);
+/**
+ * Of those, the one worth waiting on: the advanced-issue processing after the run, which
+ * ends within minutes. A report whose scan or tests are still running is read as it is,
+ * with a note, since that can last as long as the suite does.
+ */
+const WAIT_STATUSES = new Set(["finalizing"]);
 /**
  * Where a report is in its processing before its issues are read. Issues keep being added
- * until it completes (an advanced scan adds its advanced-rule issues while "finalizing", for
- * minutes after the tests end), so a first read waits for it, reporting progress, for up to
- * REPORT_STATUS_WAIT_MS. A later page does not wait again, and a status that cannot be read
- * is not waited on.
+ * until it completes; an advanced scan adds its advanced-rule issues while "finalizing", for
+ * minutes after the tests end, so a first read waits for that, reporting progress, for up to
+ * REPORT_STATUS_WAIT_MS. A run still in progress is not waited on (it can take as long as
+ * the suite), nor is a later page, nor a status that cannot be read.
  */
 async function waitForProcessing(reportFetcher, source, wait, context) {
     const started = Date.now();
@@ -175,7 +181,7 @@ async function waitForProcessing(reportFetcher, source, wait, context) {
     let status = firstStatus;
     while (wait &&
         status &&
-        PROCESSING_STATUSES.has(status) &&
+        WAIT_STATUSES.has(status) &&
         Date.now() - started < REPORT_STATUS_WAIT_MS) {
         const waited = Date.now() - started;
         if (context) {
@@ -466,28 +472,29 @@ export default function addAccessibilityTools(server, config) {
     }, async (args) => {
         return await executeGetAuthConfig(args, server, config);
     });
-    tools.fetchAccessibilityIssues = server.tool("fetchAccessibilityIssues", "Fetch accessibility issues with pagination support, from exactly one source: a completed Website Scanner run (scanId with scanRunId), an Automated Tests build from a BrowserStack SDK test run (buildId), a Workflow Analyzer report (workflowReportId), or a Website Scanner or Automated Tests report's dashboard link (reportUrl). Also returns a link to download the full report as a CSV. Use cursor parameter to get subsequent pages of results." +
+    tools.fetchAccessibilityIssues = server.tool("fetchAccessibilityIssues", "Fetch accessibility issues (paged by cursor) from one source: scanId+scanRunId, buildId, workflowReportId or reportUrl." +
         NEEDS_A11Y_SCAN_ID, {
         scanId: z
             .string()
             .optional()
-            .describe("Website Scanner: the scan ID from a completed accessibility scan"),
+            .describe("Website Scanner: the scan id from startAccessibilityScan."),
         scanRunId: z
             .string()
             .optional()
-            .describe("Website Scanner: the scan run ID from a completed accessibility scan"),
+            .describe("Website Scanner: the scan run id from startAccessibilityScan."),
         buildId: z
             .string()
+            .regex(/^[a-z0-9]{40}$/, "40 lowercase letters and digits")
             .optional()
-            .describe("Automated Tests: the Accessibility build id, shown as thBuildId in the build's accessibility report link (40 lowercase letters and digits). Not the Automate build id or the build name."),
+            .describe("Automated Tests: the thBuildId in the build's accessibility report link (not the Automate build id)."),
         workflowReportId: z
             .string()
             .optional()
-            .describe("Workflow Analyzer: the report's numeric id, e.g. 123456"),
+            .describe("Workflow Analyzer: the report's numeric id."),
         reportUrl: z
             .string()
             .optional()
-            .describe("A report's Accessibility dashboard link, as the user pasted it: a Website Scanner or Automated Tests report link carrying thBuildId. A Website Scanner link resolves only to its scan's latest run. Workflow Analyzer links are not supported; use workflowReportId."),
+            .describe("A Website Scanner or Automated Tests report link from the Accessibility dashboard (carries thBuildId)."),
         cursor: z
             .number()
             .optional()

package/dist/tools/accessiblity-utils/report-fetcher.js

@@ -109,10 +109,14 @@ export class AccessibilityReportFetcher {
             const data = resp.data?.data;
             for (const scan of data?.scans ?? []) {
                 if (thBuildIdOf(scan.scanUrl) === thBuildId) {
+                    const scanRunId = scan.lastScanDetails?.scanRunId;
+                    if (scanRunId === undefined) {
+                        throw new Error(`Website Scanner scan ${scan.id} has no completed run to read yet; wait for it to finish, or pass scanId and scanRunId`);
+                    }
                     return {
                         kind: "scan",
                         scanId: String(scan.id),
-                        scanRunId: String(scan.lastScanDetails?.scanRunId),
+                        scanRunId: String(scanRunId),
                     };
                 }
                 if (sameName === undefined && scan.name === scanName) {

package/dist/tools/failurelogs-utils/app-automate.js

@@ -4,7 +4,7 @@ import { apiClient } from "../../lib/apiClient.js";
 import { wrapUntrusted } from "../../lib/untrusted-content.js";
 // DEVICE LOGS
 export async function retrieveDeviceLogs(sessionId, buildId, config) {
-    const url = `https://api.browserstack.com/app-automate/builds/${buildId}/sessions/${sessionId}/deviceLogs`;
+    const url = `https://api.browserstack.com/app-automate/builds/${buildId}/sessions/${sessionId}/devicelogs`;
     const authString = getBrowserStackAuth(config);
     const auth = Buffer.from(authString).toString("base64");
     const response = await apiClient.get({

package/dist/tools/tool-handoff.d.ts

@@ -65,8 +65,8 @@ export declare const NEEDS_SESSION_ID: string;
  * A scan run's ids come from startAccessibilityScan. Nothing here lists builds or reports,
  * but the tool takes a report's dashboard link and looks the ids up itself.
  */
-export declare const NEEDS_A11Y_SCAN_ID: string;
+export declare const NEEDS_A11Y_SCAN_ID = " Ids: startAccessibilityScan or a dashboard link; nothing here lists reports.";
 /** Auth-config ids are not listable by any tool here. */
-export declare const NEEDS_A11Y_CONFIG_ID: string;
+export declare const NEEDS_A11Y_CONFIG_ID = " Requires the id returned by createAccessibilityAuthConfig; nothing here lists configs.";
 /** Test ids come from listTestIds, which itself needs a build id. */
 export declare const NEEDS_TEST_IDS: string;

package/dist/tools/tool-handoff.js

@@ -74,14 +74,8 @@ export const NEEDS_SESSION_ID = " Requires a session id. listSessions lists them
  * A scan run's ids come from startAccessibilityScan. Nothing here lists builds or reports,
  * but the tool takes a report's dashboard link and looks the ids up itself.
  */
-export const NEEDS_A11Y_SCAN_ID = " Requires a completed source: a Website Scanner run's ids, returned by " +
-    "startAccessibilityScan; an Automated Tests build's id, the thBuildId in its accessibility " +
-    "report link; a Workflow Analyzer report's numeric id; or a Website Scanner or Automated " +
-    "Tests report's dashboard link, passed as reportUrl. No tool here lists past scans, builds " +
-    "or reports, so if you have none of these, ask the user for the report link, or start a " +
-    "new scan, rather than guessing.";
+export const NEEDS_A11Y_SCAN_ID = " Ids: startAccessibilityScan or a dashboard link; nothing here lists reports.";
 /** Auth-config ids are not listable by any tool here. */
-export const NEEDS_A11Y_CONFIG_ID = " Requires the numeric id returned by createAccessibilityAuthConfig. No tool here lists " +
-    "existing configurations, so if you do not have the id, create one rather than guessing.";
+export const NEEDS_A11Y_CONFIG_ID = " Requires the id returned by createAccessibilityAuthConfig; nothing here lists configs.";
 /** Test ids come from listTestIds, which itself needs a build id. */
 export const NEEDS_TEST_IDS = needsIdFrom("test ids", "listTestIds");

package/package.json

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