fix: handle existing scan name error and improve WebDriver Init

src/tools/accessiblity-utils/scanner.ts

@@ -83,6 +83,11 @@ export class AccessibilityScanner {
       return data;
     } catch (err) {
       if (axios.isAxiosError(err) && err.response?.data) {
+        if (err.response.status === 422) {
+          throw new Error(
+            "A scan with this name already exists. please update the name and run again.",
+          );
+        }
         const msg =
           (err.response.data as any).error ||
           (err.response.data as any).message ||

src/tools/appautomate.ts

@@ -104,13 +104,20 @@ async function takeAppScreenshot(args: {
     };
 
     logger.info("Starting WebDriver session on BrowserStack...");
-    driver = await remote({
-      protocol: "https",
-      hostname: "hub.browserstack.com",
-      port: 443,
-      path: "/wd/hub",
-      capabilities,
-    });
+    try {
+      driver = await remote({
+        protocol: "https",
+        hostname: "hub.browserstack.com",
+        port: 443,
+        path: "/wd/hub",
+        capabilities,
+      });
+    } catch (error) {
+      logger.error("Error initializing WebDriver:", error);
+      throw new Error(
+        "Failed to initialize the WebDriver or a timeout occurred. Please try again.",
+      );
+    }
 
     const screenshotBase64 = await driver.takeScreenshot();
     const compressed = await maybeCompressBase64(screenshotBase64);

src/tools/applive-utils/start-session.ts

@@ -64,6 +64,10 @@ export async function startSession(args: StartSessionArgs): Promise<string> {
   const { app_url } = await uploadApp(appPath);
   logger.info(`App uploaded: ${app_url}`);
 
+  if (!app_url) {
+    throw new Error("Failed to upload app. Please try again.");
+  }
+
   // 7) Build URL & open
   const deviceParam = sanitizeUrlParam(
     selected.display_name.replace(/\s+/g, "+"),