@wdio/mcp 3.5.2 → 3.6.0

package/lib/server.js

@@ -91,6 +91,7 @@ var package_default = {
     test: "vitest run"
   },
   dependencies: {
+    "@lambdatest/node-tunnel": "^4.0.11",
     "@modelcontextprotocol/sdk": "^1.27.1",
     "@toon-format/toon": "^2.1.0",
     "@wdio/protocols": "^9.27.0",
@@ -2493,6 +2494,69 @@ var saucelabsLocalBinaryResource = {
   }
 };
 
+// src/resources/testmu-local.resource.ts
+function getLocalBinaryInfo3() {
+  const platform2 = process.platform;
+  const arch = process.arch;
+  if (platform2 === "darwin") {
+    return {
+      downloadUrl: "https://downloads.lambdatest.com/tunnel/v4/darwin/64bit/LT_Darwin.zip",
+      platform: "macOS",
+      arch: arch === "arm64" ? "Apple Silicon (via Rosetta 2)" : "Intel x64",
+      binaryName: "LT"
+    };
+  }
+  if (platform2 === "win32") {
+    return {
+      downloadUrl: "https://downloads.lambdatest.com/tunnel/v4/win/64bit/LT_Windows.zip",
+      platform: "Windows",
+      arch: "x86/x64",
+      binaryName: "LT.exe"
+    };
+  }
+  return {
+    downloadUrl: "https://downloads.lambdatest.com/tunnel/v4/linux/64bit/LT_Linux.zip",
+    platform: "Linux",
+    arch: arch === "arm64" ? "ARM64" : "x64",
+    binaryName: "LT"
+  };
+}
+var testmuLocalBinaryResource = {
+  name: "testmu-local-binary",
+  uri: "wdio://testmu/local-binary",
+  description: "TestMu Tunnel binary download URL and daemon setup instructions for the current platform. MUST be read and followed before using tunnel: true in start_session with provider: testmu.",
+  handler: async () => {
+    const info = getLocalBinaryInfo3();
+    const username = process.env.TESTMU_USERNAME ?? "<TESTMU_USERNAME>";
+    const accessKey = process.env.TESTMU_ACCESS_KEY ?? "<TESTMU_ACCESS_KEY>";
+    const content = {
+      requirement: "MUST start the TestMu Tunnel daemon BEFORE calling start_session with tunnel: true. Without it, all navigation to local/internal URLs will fail.",
+      platform: info.platform,
+      arch: info.arch,
+      downloadUrl: info.downloadUrl,
+      setup: [
+        `1. Download: curl -O ${info.downloadUrl}`,
+        `2. Unzip: unzip ${info.downloadUrl.split("/").pop()}`,
+        `3. Make executable (macOS/Linux): chmod +x ${info.binaryName}`,
+        `4. Start daemon: ./${info.binaryName} --user ${username} --key ${accessKey}`
+      ],
+      commands: {
+        start: `./${info.binaryName} --user ${username} --key ${accessKey}`,
+        stop: `./${info.binaryName} --user ${username} --key ${accessKey} --stop`,
+        status: `./${info.binaryName} --status`
+      },
+      afterDaemonIsRunning: "Call start_session with tunnel: true and provider: testmu to route TestMu traffic through the tunnel."
+    };
+    return {
+      contents: [{
+        uri: "wdio://testmu/local-binary",
+        mimeType: "application/json",
+        text: JSON.stringify(content, null, 2)
+      }]
+    };
+  }
+};
+
 // src/resources/sessions.resource.ts
 import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
 
@@ -2520,6 +2584,7 @@ function generateStep(step, history) {
       const platform2 = p.platform;
       const isBrowserStack = "bstack:options" in history.capabilities;
       const isSauceLabs = "sauce:options" in history.capabilities;
+      const isLambdaTest = "lt:options" in history.capabilities;
       const capJson = indentJson(history.capabilities).split("\n").map((line, i) => i > 0 ? `  ${line}` : line).join("\n");
       if (isBrowserStack) {
         const nav = platform2 === "browser" && p.navigationUrl ? `
@@ -2552,6 +2617,23 @@ await browser.url('${escapeStr(p.navigationUrl)}');` : "";
           `});${nav}`
         ].join("\n");
       }
+      if (isLambdaTest) {
+        const isBrowser = platform2 === "browser";
+        const hostname = isBrowser ? "hub.lambdatest.com" : "mobile-hub.lambdatest.com";
+        const nav = platform2 === "browser" && p.navigationUrl ? `
+await browser.url('${escapeStr(p.navigationUrl)}');` : "";
+        return [
+          "const browser = await remote({",
+          "  protocol: 'https',",
+          `  hostname: '${hostname}',`,
+          "  port: 443,",
+          "  path: '/wd/hub',",
+          "  user: process.env.TESTMU_USERNAME,",
+          "  key: process.env.TESTMU_ACCESS_KEY,",
+          `  capabilities: ${capJson}`,
+          `});${nav}`
+        ].join("\n");
+      }
       if (platform2 === "browser") {
         const nav = p.navigationUrl ? `
 await browser.url('${escapeStr(p.navigationUrl)}');` : "";
@@ -2615,9 +2697,11 @@ function bsStatusUpdateLines(sessionType) {
 function generateCode(history) {
   const bstackOptions = history.capabilities["bstack:options"];
   const sauceOptions = history.capabilities["sauce:options"];
+  const ltOptions = history.capabilities["lt:options"];
   const isBrowserStack = bstackOptions !== void 0;
   const isSauceLabs = sauceOptions !== void 0;
-  const usesLocalTunnel = isBrowserStack ? bstackOptions?.local === true : sauceOptions?.tunnelName !== void 0;
+  const isLambdaTest = ltOptions !== void 0;
+  const usesLocalTunnel = isBrowserStack ? bstackOptions?.local === true : isSauceLabs ? sauceOptions?.tunnelName !== void 0 : ltOptions?.tunnel === true;
   const steps = history.steps.map((step) => generateStep(step, history)).join("\n").split("\n").map((line) => `  ${line}`).join("\n");
   if (isBrowserStack) {
     const bsSteps = steps.replace(/const browser = await remote\(/g, "browser = await remote(");
@@ -2722,6 +2806,61 @@ ${statusUpdate}
       "}"
     ].join("\n");
   }
+  if (isLambdaTest) {
+    const ltSteps = steps.replace(/const browser = await remote\(/g, "browser = await remote(");
+    const preamble = "let browser;\nlet ltStatus = 'passed';";
+    const catchBlock = "} catch (e) {\n  ltStatus = 'failed';\n  throw e;";
+    const isMobile = history.type !== "browser";
+    const statusUpdate = isMobile ? "    await browser.execute('lambda-status=' + ltStatus);" : [
+      "    const ltAuth = Buffer.from(`${process.env.TESTMU_USERNAME}:${process.env.TESTMU_ACCESS_KEY}`).toString('base64');",
+      "    await fetch('https://api.lambdatest.com/automation/api/v1/sessions/' + browser.sessionId, {",
+      "      method: 'PATCH',",
+      "      headers: { Authorization: 'Basic ' + ltAuth, 'Content-Type': 'application/json' },",
+      "      body: JSON.stringify({ status_ind: ltStatus })",
+      "    });"
+    ].join("\n");
+    const finallyLines = [
+      "  if (browser) {",
+      statusUpdate,
+      "    await browser.deleteSession();",
+      "  }"
+    ];
+    if (usesLocalTunnel) {
+      const tunnelName = ltOptions?.tunnelName ?? "wdio-mcp-tunnel";
+      const tunnelSetup = [
+        "",
+        "import LambdaTunnel from '@lambdatest/node-tunnel';",
+        "",
+        "const tunnel = new LambdaTunnel();",
+        `await tunnel.start({ user: process.env.TESTMU_USERNAME, key: process.env.TESTMU_ACCESS_KEY, tunnelName: '${escapeStr(tunnelName)}' });`,
+        "const stopTunnel = () => tunnel.stop();",
+        ""
+      ].join("\n");
+      return [
+        "import { remote } from 'webdriverio';",
+        tunnelSetup,
+        preamble,
+        "try {",
+        ltSteps,
+        catchBlock,
+        "} finally {",
+        ...finallyLines,
+        "  await stopTunnel();",
+        "}"
+      ].join("\n");
+    }
+    return [
+      "import { remote } from 'webdriverio';",
+      "",
+      preamble,
+      "try {",
+      ltSteps,
+      catchBlock,
+      "} finally {",
+      ...finallyLines,
+      "}"
+    ].join("\n");
+  }
   return `import { remote } from 'webdriverio';
 
 try {
@@ -3419,7 +3558,7 @@ import { z as z14 } from "zod";
 // src/session/lifecycle.ts
 init_state();
 import { mkdirSync as mkdirSync2, writeFileSync as writeFileSync2 } from "fs";
-import { join as join4 } from "path";
+import { join as join5 } from "path";
 
 // src/providers/local-browser.provider.ts
 var LocalBrowserProvider = class {
@@ -3711,9 +3850,9 @@ var BrowserStackProvider = class {
       if (reporting2?.build) bstackOptions2.buildName = reporting2.build;
       if (reporting2?.session) bstackOptions2.sessionName = reporting2.session;
       return {
+        ...userCapabilities,
         browserName: options.browser ?? "chrome",
-        "bstack:options": bstackOptions2,
-        ...userCapabilities
+        "bstack:options": bstackOptions2
       };
     }
     const bstackOptions = {
@@ -3731,14 +3870,14 @@ var BrowserStackProvider = class {
     const autoAcceptAlerts = options.autoAcceptAlerts;
     const autoDismissAlerts = options.autoDismissAlerts;
     return {
+      ...userCapabilities,
       platformName: platform2,
       "appium:app": options.app,
       "appium:autoGrantPermissions": options.autoGrantPermissions ?? true,
       "appium:autoAcceptAlerts": autoDismissAlerts ? void 0 : autoAcceptAlerts ?? true,
       "appium:autoDismissAlerts": autoDismissAlerts,
       "appium:newCommandTimeout": options.newCommandTimeout ?? 300,
-      "bstack:options": bstackOptions,
-      ...userCapabilities
+      "bstack:options": bstackOptions
     };
   }
   getSessionType(options) {
@@ -3788,6 +3927,7 @@ var BrowserStackProvider = class {
 var browserStackProvider = new BrowserStackProvider();
 
 // src/providers/cloud/saucelabs.provider.ts
+import SauceLabs from "saucelabs";
 import { tmpdir as tmpdir3 } from "os";
 import { join as join3 } from "path";
 var SauceLabsProvider = class {
@@ -3821,16 +3961,15 @@ var SauceLabsProvider = class {
     }
     if (platform2 === "browser") {
       return {
+        ...userCapabilities,
         browserName: options.browser ?? "chrome",
         browserVersion: options.browserVersion ?? "latest",
-        platformName: options.os ?? "Linux",
-        "sauce:options": sauceOptions,
-        ...userCapabilities
+        platformName: options.os ? [options.os, options.osVersion].filter(Boolean).join(" ") : "Linux",
+        "sauce:options": sauceOptions
       };
     }
     const mobileBrowser = options.browser;
     if (mobileBrowser) {
-      sauceOptions.appiumVersion = "2.11.0";
       if (options.deviceOrientation) sauceOptions.deviceOrientation = options.deviceOrientation;
       const caps = {
         platformName: platform2,
@@ -3841,12 +3980,13 @@ var SauceLabsProvider = class {
         "appium:newCommandTimeout": options.newCommandTimeout ?? 300,
         "sauce:options": sauceOptions
       };
-      return { ...caps, ...userCapabilities };
+      return { ...userCapabilities, ...caps };
     }
     sauceOptions.appiumVersion = "latest";
     const autoAcceptAlerts = options.autoAcceptAlerts;
     const autoDismissAlerts = options.autoDismissAlerts;
     return {
+      ...userCapabilities,
       platformName: platform2,
       "appium:app": options.app,
       "appium:deviceName": options.deviceName,
@@ -3856,8 +3996,7 @@ var SauceLabsProvider = class {
       "appium:autoAcceptAlerts": autoDismissAlerts ? void 0 : autoAcceptAlerts ?? true,
       "appium:autoDismissAlerts": autoDismissAlerts,
       "appium:newCommandTimeout": options.newCommandTimeout ?? 300,
-      "sauce:options": sauceOptions,
-      ...userCapabilities
+      "sauce:options": sauceOptions
     };
   }
   getSessionType(options) {
@@ -3874,7 +4013,6 @@ var SauceLabsProvider = class {
     const logFile = join3(tmpdir3(), "sauce-connect.log");
     console.error(`[SauceLabs] Starting tunnel "${tunnelName}" (region: ${region})`);
     try {
-      const { default: SauceLabs } = await import("saucelabs");
       const api = new SauceLabs({ user: process.env.SAUCE_USERNAME ?? "", key: process.env.SAUCE_ACCESS_KEY ?? "", region });
       return api.startSauceConnect({
         tunnelName,
@@ -3923,10 +4061,163 @@ var SauceLabsProvider = class {
 };
 var sauceLabsProvider = new SauceLabsProvider();
 
+// src/providers/cloud/testmu.provider.ts
+import LambdaTunnel from "@lambdatest/node-tunnel";
+import { tmpdir as tmpdir4 } from "os";
+import { join as join4 } from "path";
+var TestMuProvider = class {
+  name = "testmu";
+  getConnectionConfig(options) {
+    const platform2 = options.platform;
+    const isBrowser = platform2 === "browser";
+    return {
+      protocol: "https",
+      hostname: isBrowser ? "hub.lambdatest.com" : "mobile-hub.lambdatest.com",
+      port: 443,
+      path: "/wd/hub",
+      user: process.env.TESTMU_USERNAME,
+      key: process.env.TESTMU_ACCESS_KEY
+    };
+  }
+  buildCapabilities(options) {
+    const platform2 = options.platform;
+    const userCapabilities = options.capabilities ?? {};
+    const tunnel = options.tunnel ?? options.testmuLocal;
+    const reporting = options.reporting;
+    const ltOptions = { w3c: true };
+    if (reporting?.project) ltOptions.project = reporting.project;
+    if (reporting?.build) ltOptions.build = reporting.build;
+    if (reporting?.session) ltOptions.name = reporting.session;
+    else if (reporting?.project) ltOptions.name = reporting.project;
+    if (tunnel) {
+      ltOptions.tunnel = true;
+      if (options.tunnelName) ltOptions.tunnelName = options.tunnelName;
+    }
+    if (platform2 === "browser") {
+      return {
+        ...userCapabilities,
+        browserName: options.browser ?? "chrome",
+        browserVersion: options.browserVersion ?? "latest",
+        platformName: options.os ? [options.os, options.osVersion].filter(Boolean).join(" ") : "Linux",
+        "lt:options": ltOptions
+      };
+    }
+    const mobileBrowser = options.browser;
+    if (mobileBrowser) {
+      ltOptions.isRealMobile = false;
+      if (options.deviceOrientation) ltOptions.deviceOrientation = options.deviceOrientation;
+      const caps2 = {
+        platformName: platform2,
+        browserName: mobileBrowser,
+        "appium:deviceName": options.deviceName,
+        "appium:platformVersion": options.platformVersion,
+        "appium:automationName": options.automationName ?? (platform2 === "ios" ? "XCUITest" : "UiAutomator2"),
+        "appium:newCommandTimeout": options.newCommandTimeout ?? 300,
+        "lt:options": ltOptions
+      };
+      return { ...userCapabilities, ...caps2 };
+    }
+    ltOptions.appiumVersion = "latest";
+    ltOptions.isRealMobile = true;
+    const autoAcceptAlerts = options.autoAcceptAlerts;
+    const autoDismissAlerts = options.autoDismissAlerts;
+    const caps = {
+      platformName: platform2,
+      "appium:app": options.app,
+      "appium:deviceName": options.deviceName,
+      "appium:platformVersion": options.platformVersion,
+      "appium:automationName": options.automationName ?? (platform2 === "ios" ? "XCUITest" : "UiAutomator2"),
+      "appium:autoGrantPermissions": options.autoGrantPermissions ?? true,
+      "appium:autoAcceptAlerts": autoDismissAlerts ? void 0 : autoAcceptAlerts ?? true,
+      "appium:autoDismissAlerts": autoDismissAlerts,
+      "appium:newCommandTimeout": options.newCommandTimeout ?? 300,
+      "lt:options": ltOptions
+    };
+    return { ...userCapabilities, ...caps };
+  }
+  getSessionType(options) {
+    const platform2 = options.platform;
+    if (platform2 === "browser") return "browser";
+    return platform2;
+  }
+  shouldAutoDetach(_options) {
+    return false;
+  }
+  async startTunnel(options) {
+    const tunnelName = options.tunnelName ?? `wdio-mcp-testmu-${Date.now()}`;
+    const logFile = join4(tmpdir4(), "testmu-tunnel.log");
+    console.error(`[TestMu] Starting tunnel "${tunnelName}"`);
+    try {
+      const tunnel = new LambdaTunnel();
+      await tunnel.start({
+        user: process.env.TESTMU_USERNAME ?? "",
+        key: process.env.TESTMU_ACCESS_KEY ?? "",
+        tunnelName,
+        logFile
+      });
+      console.error(`[TestMu] Tunnel started: "${tunnelName}"`);
+      return tunnel;
+    } catch (e) {
+      const msg = (e !== null && typeof e === "object" ? e.message : void 0) ?? String(e);
+      if (msg.includes("already running") || msg.includes("another tunnel") || msg.includes("already in use")) {
+        console.error("[TestMu] Tunnel already running \u2014 reusing existing tunnel");
+        return null;
+      }
+      throw e;
+    }
+  }
+  async onSessionClose(sessionId, sessionType, result, _tunnelHandle, browser, _region) {
+    const user = process.env.TESTMU_USERNAME;
+    const key = process.env.TESTMU_ACCESS_KEY;
+    if (!user || !key) return;
+    const status = result.status === "passed" ? "passed" : "failed";
+    if (sessionType !== "browser") {
+      try {
+        console.error(`[TestMu] Setting mobile session status for ${sessionId}: ${status}`);
+        await browser?.execute("lambda-status=" + status);
+        console.error("[TestMu] Mobile session status set successfully via execute");
+      } catch (e) {
+        console.error("[TestMu] Failed to set mobile session status via execute:", e);
+      }
+      return;
+    }
+    try {
+      const auth = basicAuth(user, key);
+      const body = { status_ind: status };
+      const apiUrl = `https://api.lambdatest.com/automation/api/v1/sessions/${sessionId}`;
+      console.error(`[TestMu] Setting session status for ${sessionId}: ${body.status_ind}`);
+      const res = await fetch(apiUrl, {
+        method: "PATCH",
+        headers: {
+          Authorization: `Basic ${auth}`,
+          "Content-Type": "application/json"
+        },
+        body: JSON.stringify(body)
+      });
+      if (res.ok) {
+        console.error("[TestMu] Session status set successfully via REST API");
+      } else {
+        const resBody = await res.text();
+        console.error(`[TestMu] Failed to set session status: HTTP ${res.status} \u2014 ${resBody}`);
+      }
+    } catch (e) {
+      console.error("[TestMu] Failed to set session status via REST API:", e);
+    }
+  }
+  async stopTunnel(tunnelHandle) {
+    if (tunnelHandle) {
+      const tunnel = tunnelHandle;
+      await tunnel.stop();
+    }
+  }
+};
+var testMuProvider = new TestMuProvider();
+
 // src/providers/registry.ts
 var providers = /* @__PURE__ */ new Map([
   ["browserstack", browserStackProvider],
-  ["saucelabs", sauceLabsProvider]
+  ["saucelabs", sauceLabsProvider],
+  ["testmu", testMuProvider]
 ]);
 function getDefaultProvider(platform2) {
   return platform2 === "browser" ? localBrowserProvider : localAppiumProvider;
@@ -3963,10 +4254,10 @@ async function finalizeTrace(sessionId, browser) {
   if (!traceSession) return;
   try {
     await traceSession.screenshotChain;
-    const traceDir = join4(process.cwd(), ".trace");
+    const traceDir = join5(process.cwd(), ".trace");
     mkdirSync2(traceDir, { recursive: true });
     const timestamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
-    const outPath = join4(traceDir, `${timestamp}-${sessionId.slice(0, 8)}.zip`);
+    const outPath = join5(traceDir, `${timestamp}-${sessionId.slice(0, 8)}.zip`);
     const zipBuffer = await buildTraceZip(traceSession);
     writeFileSync2(outPath, zipBuffer);
     console.error(`[TRACE] Saved to ${outPath}`);
@@ -4081,13 +4372,13 @@ var startSessionToolDefinition = {
   description: 'Starts a browser or mobile automation session. Only one active session at a time \u2014 starting a new one closes the existing session first. Use platform "browser" with a browser name, or "ios"/"android" with deviceName. Set attach: true to connect to a running Chrome via CDP instead of launching a new browser.',
   annotations: { title: "Start Session", destructiveHint: false },
   inputSchema: {
-    provider: z14.enum(["local", "browserstack", "saucelabs"]).optional().default("local").describe("Session provider (default: local)"),
+    provider: z14.enum(["local", "browserstack", "saucelabs", "testmu"]).optional().default("local").describe("Session provider (default: local)"),
     platform: platformEnum.describe("Session platform type"),
     browser: browserEnum.optional().describe("Browser to launch (required for browser platform)"),
     browserVersion: z14.string().optional().describe("Browser version (cloud providers only, default: latest)"),
-    os: z14.string().optional().describe('Operating system (cloud providers only, e.g. "Windows", "OS X")'),
-    osVersion: z14.string().optional().describe('OS version (cloud providers only, e.g. "11", "Sequoia")'),
-    app: z14.string().optional().describe("App URL (bs://...) for BrowserStack or storage:filename= for Sauce Labs mobile sessions"),
+    os: z14.string().optional().describe('Operating system for cloud provider browser sessions (e.g. "Windows", "Mac", "macOS", "Linux"). BrowserStack: sets bstack:options.os separately. TestMu/Sauce Labs: combined with osVersion into W3C platformName. Browser platform only.'),
+    osVersion: z14.string().optional().describe('OS version for cloud provider browser sessions (e.g. "11", "15", "Monterey"). BrowserStack: sets bstack:options.osVersion separately. TestMu/Sauce Labs: combined with os into W3C platformName. Browser platform only.'),
+    app: z14.string().optional().describe("App URL (bs://... for BrowserStack, storage:filename= for Sauce Labs, lt://... for TestMu mobile sessions)"),
     reporting: z14.object({
       project: z14.string().optional(),
       build: z14.string().optional(),
@@ -4097,7 +4388,7 @@ var startSessionToolDefinition = {
     windowWidth: z14.number().min(400).max(3840).optional().default(1920).describe("Browser window width"),
     windowHeight: z14.number().min(400).max(2160).optional().default(1080).describe("Browser window height"),
     deviceName: z14.string().optional().describe("Mobile device/emulator/simulator name (required for ios/android)"),
-    platformVersion: z14.string().optional().describe('OS version (e.g., "17.0", "14")'),
+    platformVersion: z14.string().optional().describe('OS version for mobile sessions (e.g., "17.0", "14"). Mobile (ios/android) only.'),
     appPath: z14.string().optional().describe("Path to app file (.app/.apk/.ipa)"),
     automationName: automationEnum.optional().describe("Automation driver"),
     autoGrantPermissions: coerceBoolean.optional().describe("Auto-grant app permissions (default: true)"),
@@ -4125,6 +4416,7 @@ var startSessionToolDefinition = {
     tunnelName: z14.string().optional().describe('Tunnel identifier name. With tunnel: "external" this must match the running tunnel. With tunnel: true a unique name is auto-generated if not provided.'),
     browserstackLocal: z14.union([z14.literal("external"), coerceBoolean]).optional().describe('Deprecated: use "tunnel" instead. Enable BrowserStack Local tunnel routing.'),
     saucelabsLocal: z14.union([z14.literal("external"), coerceBoolean]).optional().describe('Deprecated: use "tunnel" instead. Enable Sauce Connect tunnel routing.'),
+    testmuLocal: z14.union([z14.literal("external"), coerceBoolean]).optional().describe('Deprecated: use "tunnel" instead. Enable TestMu Tunnel routing.'),
     navigationUrl: z14.string().optional().describe("URL to navigate to after starting"),
     capabilities: z14.record(z14.string(), z14.unknown()).optional().describe("Additional capabilities to merge")
   }
@@ -4203,7 +4495,7 @@ async function startBrowserSession(args) {
   const effectiveHeadless = headless && headlessSupported;
   const provider = getProvider(args.provider ?? "local", "browser");
   const connectionConfig = provider.getConnectionConfig(args);
-  const effectiveTunnel = args.tunnel ?? args.browserstackLocal ?? args.saucelabsLocal ?? false;
+  const effectiveTunnel = args.tunnel ?? args.browserstackLocal ?? args.saucelabsLocal ?? args.testmuLocal ?? false;
   const tunnelEnabled = effectiveTunnel === true;
   const tunnelName = tunnelEnabled && !args.tunnelName ? `wdio-mcp-${Date.now()}` : args.tunnelName;
   const mergedCapabilities = provider.buildCapabilities({
@@ -4263,7 +4555,8 @@ Note: Unable to set window size (${windowWidth}x${windowHeight}). ${e}`;
 }
 async function startMobileSession(args) {
   const { platform: platform2, appPath, app, deviceName, noReset } = args;
-  if (!appPath && !app && noReset !== true) {
+  const isMobileBrowser = args.browser !== void 0;
+  if (!isMobileBrowser && !appPath && !app && noReset !== true) {
     return {
       content: [{
         type: "text",
@@ -4273,7 +4566,7 @@ async function startMobileSession(args) {
   }
   const provider = getProvider(args.provider ?? "local", args.platform);
   const serverConfig = provider.getConnectionConfig(args);
-  const effectiveTunnel = args.tunnel ?? args.browserstackLocal ?? args.saucelabsLocal ?? false;
+  const effectiveTunnel = args.tunnel ?? args.browserstackLocal ?? args.saucelabsLocal ?? args.testmuLocal ?? false;
   const tunnelEnabled = effectiveTunnel === true;
   const tunnelName = tunnelEnabled && !args.tunnelName ? `wdio-mcp-${Date.now()}` : args.tunnelName;
   const mergedCapabilities = provider.buildCapabilities({ ...args, tunnelName });
@@ -4303,14 +4596,16 @@ async function startMobileSession(args) {
   if (args.trace) {
     startTrace(sessionId, mergedCapabilities, sessionType);
   }
-  const appInfo = appPath ? `
+  const sessionKind = isMobileBrowser ? "mobile browser" : "app";
+  const appInfo = isMobileBrowser ? `
+Browser: ${args.browser}` : appPath ? `
 App: ${appPath}` : "\nApp: (connected to running app)";
   const detachNote = shouldAutoDetach ? "\n\n(Auto-detach enabled: session will be preserved on close. Use close_session({ detach: false }) to force terminate.)" : "";
   return {
     content: [
       {
         type: "text",
-        text: `${platform2} app session started with sessionId: ${sessionId}
+        text: `${platform2} ${sessionKind} session started with sessionId: ${sessionId}
 Device: ${deviceName}${appInfo}
 Appium Server: ${serverConfig.hostname}:${serverConfig.port}${serverConfig.path}${detachNote}`
       }
@@ -4529,6 +4824,31 @@ var PROVIDER_CONFIGS = {
       const name = data.item?.name ?? fileName;
       return { appRef: `storage:filename=${name}`, appName: name };
     }
+  },
+  testmu: {
+    name: "TestMu",
+    apiBase: "https://manual-api.lambdatest.com",
+    credsEnvNames: ["TESTMU_USERNAME", "TESTMU_ACCESS_KEY"],
+    listPath: "/app/data",
+    supportsOrgWide: false,
+    parseListResponse: (raw) => {
+      if (raw === null || raw === void 0 || typeof raw !== "object") return [];
+      const data = raw;
+      const apps = data.data ?? (Array.isArray(raw) ? raw : []);
+      return apps.map((a) => ({
+        name: a.name ?? a.app_name ?? "unknown",
+        ref: a.app_id ? `lt://${a.app_id}` : `lt://${a.custom_id ?? "unknown"}`,
+        uploadedAt: a.updated_at,
+        customId: a.custom_id
+      }));
+    },
+    uploadPath: "/app/upload/realDevice",
+    uploadField: "appFile",
+    parseUploadResponse: (raw, fileName) => {
+      const data = raw;
+      const ref = data.app_id ? `lt://${data.app_id}` : data.app_url ?? "unknown";
+      return { appRef: ref, appName: data.name ?? fileName };
+    }
   }
 };
 function getProviderConfig(provider, region) {
@@ -4546,10 +4866,10 @@ function getProviderConfig(provider, region) {
 }
 var listAppsToolDefinition = {
   name: "list_apps",
-  description: "List apps uploaded to a cloud provider (BrowserStack App Automate or Sauce Labs App Storage). Reads provider-specific credentials from environment.",
+  description: "List apps uploaded to a cloud provider (BrowserStack App Automate, Sauce Labs App Storage, or TestMu Real Device Cloud). Reads provider-specific credentials from environment.",
   annotations: { title: "List Cloud Provider Apps", readOnlyHint: true, idempotentHint: true },
   inputSchema: {
-    provider: z17.enum(["browserstack", "saucelabs"]).describe("Cloud provider"),
+    provider: z17.enum(["browserstack", "saucelabs", "testmu"]).describe("Cloud provider"),
     sortBy: z17.enum(["app_name", "uploaded_at"]).optional().default("uploaded_at").describe("Sort order for results"),
     organizationWide: coerceBoolean.optional().default(false).describe("(BrowserStack only) List apps uploaded by all users in the organization. Defaults to false (own uploads only)."),
     limit: z17.number().int().min(1).optional().default(20).describe("Maximum number of apps to return (only applies when organizationWide is true, default 20)"),
@@ -4568,15 +4888,41 @@ var listAppsTool = async (args) => {
     if (config.supportsOrgWide && organizationWide) {
       url = `${config.apiBase}/app-automate/recent_group_apps?limit=${limit}`;
     }
-    const res = await fetch(url, {
-      headers: { Authorization: `Basic ${auth}` }
-    });
-    if (!res.ok) {
-      const body = await res.text();
-      return { isError: true, content: [{ type: "text", text: `${config.name} API error ${res.status}: ${body}` }] };
+    let apps = [];
+    if (provider === "testmu") {
+      const errors = [];
+      for (const platform2 of ["android", "ios"]) {
+        try {
+          const res = await fetch(`${url}?type=${platform2}`, {
+            headers: { Authorization: `Basic ${auth}` }
+          });
+          if (res.ok) {
+            const raw = await res.json();
+            apps.push(...config.parseListResponse(raw));
+          } else {
+            const body = await res.text();
+            errors.push(`${config.name} API error ${res.status} (${platform2}): ${body}`);
+          }
+        } catch (e) {
+          errors.push(String(e));
+        }
+      }
+      if (apps.length === 0 && errors.length > 0) {
+        const message = errors.length === 1 ? errors[0] : `All platform fetches failed:
+${errors.map((e) => `  - ${e}`).join("\n")}`;
+        return { isError: true, content: [{ type: "text", text: `Error listing apps: ${message}` }] };
+      }
+    } else {
+      const res = await fetch(url, {
+        headers: { Authorization: `Basic ${auth}` }
+      });
+      if (!res.ok) {
+        const body = await res.text();
+        return { isError: true, content: [{ type: "text", text: `${config.name} API error ${res.status}: ${body}` }] };
+      }
+      const raw = await res.json();
+      apps = config.parseListResponse(raw);
     }
-    const raw = await res.json();
-    let apps = config.parseListResponse(raw);
     apps = sortBy === "app_name" ? apps.sort((a, b) => a.name.localeCompare(b.name)) : apps.sort((a, b) => (b.uploadedAt ?? "").localeCompare(a.uploadedAt ?? ""));
     return { content: [{ type: "text", text: formatAppList(apps) }] };
   } catch (e) {
@@ -4585,10 +4931,10 @@ var listAppsTool = async (args) => {
 };
 var uploadAppToolDefinition = {
   name: "upload_app",
-  description: "Upload a local .apk or .ipa to a cloud provider (BrowserStack App Automate or Sauce Labs App Storage). Returns the app URL for use in start_session.",
+  description: "Upload a local .apk or .ipa to a cloud provider (BrowserStack, Sauce Labs, or TestMu). Returns the app URL for use in start_session.",
   annotations: { title: "Upload App to Cloud Provider", destructiveHint: false },
   inputSchema: {
-    provider: z17.enum(["browserstack", "saucelabs"]).describe("Cloud provider"),
+    provider: z17.enum(["browserstack", "saucelabs", "testmu"]).describe("Cloud provider"),
     path: z17.string().describe("Absolute path to the .apk or .ipa file"),
     customId: z17.string().optional().describe("Optional custom ID for the app (used to reference it later)"),
     region: z17.enum(["us-west-1", "eu-central-1", "apac-southeast-1"]).optional().default("eu-central-1").describe("Sauce Labs region (default: eu-central-1)")
@@ -4819,6 +5165,7 @@ function createServer() {
   registerResource(sessionCodeResource);
   registerResource(browserstackLocalBinaryResource);
   registerResource(saucelabsLocalBinaryResource);
+  registerResource(testmuLocalBinaryResource);
   registerResource(capabilitiesResource);
   registerResource(elementsResource);
   registerResource(accessibilityResource);