@wdio/mcp 2.4.0 → 2.5.0

package/lib/server.js

@@ -11,7 +11,7 @@ var supportedBrowsers = ["chrome", "firefox", "edge", "safari"];
 var browserSchema = z.enum(supportedBrowsers).default("chrome");
 var startBrowserToolDefinition = {
   name: "start_browser",
-  description: "starts a browser session (Chrome, Firefox, Edge, Safari) and sets it to the current state",
+  description: "starts a browser session (Chrome, Firefox, Edge, Safari) and sets it to the current state. Prefer headless: true unless the user explicitly asks to see the browser.",
   inputSchema: {
     browser: browserSchema.describe("Browser to launch: chrome, firefox, edge, safari (default: chrome)"),
     headless: z.boolean().optional().default(true),
@@ -31,7 +31,8 @@ var closeSessionToolDefinition = {
 var state = {
   browsers: /* @__PURE__ */ new Map(),
   currentSession: null,
-  sessionMetadata: /* @__PURE__ */ new Map()
+  sessionMetadata: /* @__PURE__ */ new Map(),
+  sessionHistory: /* @__PURE__ */ new Map()
 };
 var getBrowser = () => {
   const browser = state.browsers.get(state.currentSession);
@@ -132,12 +133,33 @@ var startBrowserTool = async ({
   });
   const { sessionId } = wdioBrowser;
   state.browsers.set(sessionId, wdioBrowser);
-  state.currentSession = sessionId;
   state.sessionMetadata.set(sessionId, {
     type: "browser",
     capabilities: wdioBrowser.capabilities,
     isAttached: false
   });
+  if (state.currentSession && state.currentSession !== sessionId) {
+    const outgoing = state.sessionHistory.get(state.currentSession);
+    if (outgoing) {
+      outgoing.steps.push({
+        index: outgoing.steps.length + 1,
+        tool: "__session_transition__",
+        params: { newSessionId: sessionId },
+        status: "ok",
+        durationMs: 0,
+        timestamp: (/* @__PURE__ */ new Date()).toISOString()
+      });
+      outgoing.endedAt = (/* @__PURE__ */ new Date()).toISOString();
+    }
+  }
+  state.sessionHistory.set(sessionId, {
+    sessionId,
+    type: "browser",
+    startedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    capabilities: wdioBrowser.capabilities,
+    steps: []
+  });
+  state.currentSession = sessionId;
   let sizeNote = "";
   try {
     await wdioBrowser.setWindowSize(windowWidth, windowHeight);
@@ -164,6 +186,10 @@ var closeSessionTool = async (args = {}) => {
     const browser = getBrowser();
     const sessionId = state.currentSession;
     const metadata = state.sessionMetadata.get(sessionId);
+    const history = state.sessionHistory.get(sessionId);
+    if (history) {
+      history.endedAt = (/* @__PURE__ */ new Date()).toISOString();
+    }
     const effectiveDetach = args.detach || !!metadata?.isAttached;
     if (!effectiveDetach) {
       await browser.deleteSession();
@@ -178,6 +204,7 @@ var closeSessionTool = async (args = {}) => {
     };
   } catch (e) {
     return {
+      isError: true,
       content: [{ type: "text", text: `Error closing session: ${e}` }]
     };
   }
@@ -201,6 +228,7 @@ var navigateTool = async ({ url }) => {
     };
   } catch (e) {
     return {
+      isError: true,
       content: [{ type: "text", text: `Error navigating: ${e}` }]
     };
   }
@@ -231,6 +259,7 @@ var clickAction = async (selector, timeout, scrollToView = true) => {
     };
   } catch (e) {
     return {
+      isError: true,
       content: [{ type: "text", text: `Error clicking element: ${e}` }]
     };
   }
@@ -264,6 +293,7 @@ var setValueTool = async ({ selector, value, scrollToView = true, timeout = defa
     };
   } catch (e) {
     return {
+      isError: true,
       content: [{ type: "text", text: `Error entering text: ${e}` }]
     };
   }
@@ -310,7 +340,7 @@ function buildIOSCapabilities(appPath, options) {
     capabilities["appium:autoAcceptAlerts"] = void 0;
   }
   for (const [key, value] of Object.entries(options)) {
-    if (!["deviceName", "platformVersion", "automationName", "autoAcceptAlerts", "autoDismissAlerts", "udid", "noReset", "fullReset", "newCommandTimeout"].includes(
+    if (!["deviceName", "platformVersion", "automationName", "autoGrantPermissions", "autoAcceptAlerts", "autoDismissAlerts", "udid", "noReset", "fullReset", "newCommandTimeout"].includes(
       key
     )) {
       capabilities[`appium:${key}`] = value;
@@ -347,7 +377,7 @@ function buildAndroidCapabilities(appPath, options) {
     capabilities["appium:appWaitActivity"] = options.appWaitActivity;
   }
   for (const [key, value] of Object.entries(options)) {
-    if (!["deviceName", "platformVersion", "automationName", "autoGrantPermissions", "appWaitActivity", "noReset", "fullReset", "newCommandTimeout"].includes(
+    if (!["deviceName", "platformVersion", "automationName", "autoGrantPermissions", "autoAcceptAlerts", "autoDismissAlerts", "appWaitActivity", "noReset", "fullReset", "newCommandTimeout"].includes(
       key
     )) {
       capabilities[`appium:${key}`] = value;
@@ -464,12 +494,34 @@ var startAppTool = async (args) => {
     const shouldAutoDetach = noReset === true || !appPath;
     const state2 = getState();
     state2.browsers.set(sessionId, browser);
-    state2.currentSession = sessionId;
     state2.sessionMetadata.set(sessionId, {
       type: platform.toLowerCase(),
       capabilities: mergedCapabilities,
       isAttached: shouldAutoDetach
     });
+    if (state2.currentSession && state2.currentSession !== sessionId) {
+      const outgoing = state2.sessionHistory.get(state2.currentSession);
+      if (outgoing) {
+        outgoing.steps.push({
+          index: outgoing.steps.length + 1,
+          tool: "__session_transition__",
+          params: { newSessionId: sessionId },
+          status: "ok",
+          durationMs: 0,
+          timestamp: (/* @__PURE__ */ new Date()).toISOString()
+        });
+        outgoing.endedAt = (/* @__PURE__ */ new Date()).toISOString();
+      }
+    }
+    state2.sessionHistory.set(sessionId, {
+      sessionId,
+      type: platform.toLowerCase(),
+      startedAt: (/* @__PURE__ */ new Date()).toISOString(),
+      capabilities: mergedCapabilities,
+      appiumConfig: { hostname: serverConfig.hostname, port: serverConfig.port, path: serverConfig.path },
+      steps: []
+    });
+    state2.currentSession = sessionId;
     const appInfo = 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.)" : "";
@@ -485,6 +537,7 @@ Appium Server: ${serverConfig.hostname}:${serverConfig.port}${serverConfig.path}
     };
   } catch (e) {
     return {
+      isError: true,
       content: [{ type: "text", text: `Error starting app session: ${e}` }]
     };
   }
@@ -518,6 +571,7 @@ var scrollTool = async ({ direction, pixels = 500 }) => {
     };
   } catch (e) {
     return {
+      isError: true,
       content: [{ type: "text", text: `Error scrolling: ${e}` }]
     };
   }
@@ -1690,6 +1744,7 @@ var getVisibleElementsTool = async (args) => {
     };
   } catch (e) {
     return {
+      isError: true,
       content: [{ type: "text", text: `Error getting visible elements: ${e}` }]
     };
   }
@@ -1905,7 +1960,7 @@ var accessibilityTreeScript = () => (function() {
     if (ariaLevel) return parseInt(ariaLevel, 10);
     return void 0;
   }
-  function getState2(el) {
+  function getState3(el) {
     const inputEl = el;
     const isCheckable = ["input", "menuitemcheckbox", "menuitemradio"].includes(el.tagName.toLowerCase()) || ["checkbox", "radio", "switch"].includes(el.getAttribute("role") || "");
     return {
@@ -1933,7 +1988,7 @@ var accessibilityTreeScript = () => (function() {
     const isLandmark = LANDMARK_ROLES.has(role);
     const hasIdentity = !!(name || isLandmark);
     const selector = hasIdentity ? getSelector(el) : "";
-    const node = { role, name, selector, level: getLevel(el) ?? "", ...getState2(el) };
+    const node = { role, name, selector, level: getLevel(el) ?? "", ...getState3(el) };
     result.push(node);
     for (const child of Array.from(el.children)) {
       walk(child, depth + 1);
@@ -2009,6 +2064,7 @@ var getAccessibilityTreeTool = async (args) => {
     };
   } catch (e) {
     return {
+      isError: true,
       content: [{ type: "text", text: `Error getting accessibility tree: ${e}` }]
     };
   }
@@ -2069,6 +2125,7 @@ var takeScreenshotTool = async ({ outputPath }) => {
     };
   } catch (e) {
     return {
+      isError: true,
       content: [{ type: "text", text: `Error taking screenshot: ${e.message}` }]
     };
   }
@@ -2108,6 +2165,7 @@ var getCookiesTool = async ({ name }) => {
     };
   } catch (e) {
     return {
+      isError: true,
       content: [{ type: "text", text: `Error getting cookies: ${e}` }]
     };
   }
@@ -2145,6 +2203,7 @@ var setCookieTool = async ({
     };
   } catch (e) {
     return {
+      isError: true,
       content: [{ type: "text", text: `Error setting cookie: ${e}` }]
     };
   }
@@ -2171,6 +2230,7 @@ var deleteCookiesTool = async ({ name }) => {
     };
   } catch (e) {
     return {
+      isError: true,
       content: [{ type: "text", text: `Error deleting cookies: ${e}` }]
     };
   }
@@ -2204,10 +2264,12 @@ var tapElementTool = async (args) => {
       };
     }
     return {
+      isError: true,
       content: [{ type: "text", text: "Error: Must provide either selector or x,y coordinates" }]
     };
   } catch (e) {
     return {
+      isError: true,
       content: [{ type: "text", text: `Error tapping: ${e}` }]
     };
   }
@@ -2242,6 +2304,7 @@ var swipeTool = async (args) => {
     };
   } catch (e) {
     return {
+      isError: true,
       content: [{ type: "text", text: `Error swiping: ${e}` }]
     };
   }
@@ -2275,10 +2338,12 @@ var dragAndDropTool = async (args) => {
       };
     }
     return {
+      isError: true,
       content: [{ type: "text", text: "Error: Must provide either targetSelector or x,y coordinates" }]
     };
   } catch (e) {
     return {
+      isError: true,
       content: [{ type: "text", text: `Error dragging: ${e}` }]
     };
   }
@@ -2316,6 +2381,7 @@ var getAppStateTool = async (args) => {
     };
   } catch (e) {
     return {
+      isError: true,
       content: [{ type: "text", text: `Error getting app state: ${e}` }]
     };
   }
@@ -2357,6 +2423,7 @@ ${contexts.map((ctx, idx) => `${idx + 1}. ${ctx}`).join("\n")}`
     };
   } catch (e) {
     return {
+      isError: true,
       content: [{ type: "text", text: `Error getting contexts: ${e}` }]
     };
   }
@@ -2370,6 +2437,7 @@ var getCurrentContextTool = async () => {
     };
   } catch (e) {
     return {
+      isError: true,
       content: [{ type: "text", text: `Error getting current context: ${e}` }]
     };
   }
@@ -2385,14 +2453,7 @@ var switchContextTool = async (args) => {
       if (index >= 0 && index < contexts.length) {
         targetContext = contexts[index];
       } else {
-        return {
-          content: [
-            {
-              type: "text",
-              text: `Error: Invalid context index ${context}. Available contexts: ${contexts.length}`
-            }
-          ]
-        };
+        throw new Error(`Error: Invalid context index ${context}. Available contexts: ${contexts.length}`);
       }
     }
     await browser.switchContext(targetContext);
@@ -2401,6 +2462,7 @@ var switchContextTool = async (args) => {
     };
   } catch (e) {
     return {
+      isError: true,
       content: [{ type: "text", text: `Error switching context: ${e}` }]
     };
   }
@@ -2444,6 +2506,7 @@ var rotateDeviceTool = async (args) => {
     };
   } catch (e) {
     return {
+      isError: true,
       content: [{ type: "text", text: `Error rotating device: ${e}` }]
     };
   }
@@ -2457,6 +2520,7 @@ var hideKeyboardTool = async () => {
     };
   } catch (e) {
     return {
+      isError: true,
       content: [{ type: "text", text: `Error hiding keyboard: ${e}` }]
     };
   }
@@ -2478,6 +2542,7 @@ var getGeolocationTool = async () => {
     };
   } catch (e) {
     return {
+      isError: true,
       content: [{ type: "text", text: `Error getting geolocation: ${e}` }]
     };
   }
@@ -2500,6 +2565,7 @@ var setGeolocationTool = async (args) => {
     };
   } catch (e) {
     return {
+      isError: true,
       content: [{ type: "text", text: `Error setting geolocation: ${e}` }]
     };
   }
@@ -2565,6 +2631,7 @@ var executeScriptTool = async (args) => {
     };
   } catch (e) {
     return {
+      isError: true,
       content: [{ type: "text", text: `Error executing script: ${e}` }]
     };
   }
@@ -2639,6 +2706,19 @@ var attachBrowserTool = async ({
       capabilities: browser.capabilities,
       isAttached: true
     });
+    state2.sessionHistory.set(sessionId, {
+      sessionId,
+      type: "browser",
+      startedAt: (/* @__PURE__ */ new Date()).toISOString(),
+      capabilities: {
+        browserName: "chrome",
+        "goog:chromeOptions": {
+          debuggerAddress: `${host}:${port}`,
+          args: [`--user-data-dir=${userDataDir}`]
+        }
+      },
+      steps: []
+    });
     if (activeUrl) {
       await browser.url(activeUrl);
     }
@@ -2654,6 +2734,7 @@ Current page: "${title}" (${url})`
     };
   } catch (e) {
     return {
+      isError: true,
       content: [{ type: "text", text: `Error attaching to browser: ${e}` }]
     };
   }
@@ -2688,11 +2769,13 @@ var emulateDeviceTool = async ({
     const metadata = state2.sessionMetadata.get(sessionId);
     if (metadata?.type === "ios" || metadata?.type === "android") {
       return {
+        isError: true,
         content: [{ type: "text", text: "Error: emulate_device is only supported for web browser sessions, not iOS/Android." }]
       };
     }
     if (!browser.isBidi) {
       return {
+        isError: true,
         content: [{
           type: "text",
           text: "Error: emulate_device requires a BiDi-enabled session.\nRestart the browser with: start_browser({ capabilities: { webSocketUrl: true } })"
@@ -2712,7 +2795,7 @@ var emulateDeviceTool = async ({
 ${names.join("\n")}` }]
           };
         }
-        return { content: [{ type: "text", text: `Error listing devices: ${e}` }] };
+        return { isError: true, content: [{ type: "text", text: `Error listing devices: ${e}` }] };
       }
       return { content: [{ type: "text", text: "Could not retrieve device list." }] };
     }
@@ -2741,10 +2824,11 @@ ${names.join("\n")}` }]
           }]
         };
       }
-      return { content: [{ type: "text", text: `Error: ${e}` }] };
+      return { isError: true, content: [{ type: "text", text: `Error: ${e}` }] };
     }
   } catch (e) {
     return {
+      isError: true,
       content: [{ type: "text", text: `Error: ${e}` }]
     };
   }
@@ -2758,7 +2842,7 @@ var package_default = {
     type: "git",
     url: "git://github.com/webdriverio/mcp.git"
   },
-  version: "2.3.1",
+  version: "2.4.1",
   description: "MCP server with WebdriverIO for browser and mobile app automation (iOS/Android via Appium)",
   main: "./lib/server.js",
   module: "./lib/server.js",
@@ -2826,6 +2910,171 @@ var package_default = {
   packageManager: "pnpm@10.12.4"
 };
 
+// src/server.ts
+import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+
+// src/recording/step-recorder.ts
+function getState2() {
+  return getBrowser.__state;
+}
+function appendStep(toolName, params, status, durationMs, error) {
+  const state2 = getState2();
+  const sessionId = state2.currentSession;
+  if (!sessionId) return;
+  const history = state2.sessionHistory.get(sessionId);
+  if (!history) return;
+  const step = {
+    index: history.steps.length + 1,
+    tool: toolName,
+    params,
+    status,
+    durationMs,
+    timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+    ...error !== void 0 && { error }
+  };
+  history.steps.push(step);
+}
+function getSessionHistory() {
+  return getState2().sessionHistory;
+}
+function extractErrorText(result) {
+  const textContent = result.content.find((c) => c.type === "text");
+  return textContent ? textContent.text : "Unknown error";
+}
+function withRecording(toolName, callback) {
+  return async (params, extra) => {
+    const start = Date.now();
+    const result = await callback(params, extra);
+    const isError = result.isError === true;
+    appendStep(
+      toolName,
+      params,
+      isError ? "error" : "ok",
+      Date.now() - start,
+      isError ? extractErrorText(result) : void 0
+    );
+    return result;
+  };
+}
+
+// src/recording/code-generator.ts
+function escapeStr(value) {
+  return String(value).replace(/\\/g, "\\\\").replace(/'/g, "\\'");
+}
+function formatParams(params) {
+  return Object.entries(params).map(([k, v]) => `${k}="${v}"`).join(" ");
+}
+function indentJson(value) {
+  return JSON.stringify(value, null, 2).split("\n").map((line, i) => i > 0 ? `  ${line}` : line).join("\n");
+}
+function generateStep(step, history) {
+  if (step.tool === "__session_transition__") {
+    const newId = step.params.newSessionId ?? "unknown";
+    return `// --- new session: ${newId} started at ${step.timestamp} ---`;
+  }
+  if (step.status === "error") {
+    return `// [error] ${step.tool}: ${formatParams(step.params)} \u2014 ${step.error ?? "unknown error"}`;
+  }
+  const p = step.params;
+  switch (step.tool) {
+    case "start_browser": {
+      const nav = p.navigationUrl ? `
+await browser.url('${escapeStr(p.navigationUrl)}');` : "";
+      return `const browser = await remote({
+  capabilities: ${indentJson(history.capabilities)}
+});${nav}`;
+    }
+    case "start_app_session": {
+      const config = {
+        protocol: "http",
+        hostname: history.appiumConfig?.hostname ?? "localhost",
+        port: history.appiumConfig?.port ?? 4723,
+        path: history.appiumConfig?.path ?? "/",
+        capabilities: history.capabilities
+      };
+      return `const browser = await remote(${indentJson(config)});`;
+    }
+    case "attach_browser": {
+      const nav = p.navigationUrl ? `
+await browser.url('${escapeStr(p.navigationUrl)}');` : "";
+      return `const browser = await remote({
+  capabilities: ${indentJson(history.capabilities)}
+});${nav}`;
+    }
+    case "navigate":
+      return `await browser.url('${escapeStr(p.url)}');`;
+    case "click_element":
+      return `await browser.$('${escapeStr(p.selector)}').click();`;
+    case "set_value":
+      return `await browser.$('${escapeStr(p.selector)}').setValue('${escapeStr(p.value)}');`;
+    case "scroll": {
+      const scrollAmount = p.direction === "down" ? p.pixels : -p.pixels;
+      return `await browser.execute(() => window.scrollBy(0, ${scrollAmount}));`;
+    }
+    case "tap_element":
+      if (p.selector !== void 0) {
+        return `await browser.$('${escapeStr(p.selector)}').click();`;
+      }
+      return `await browser.tap({ x: ${p.x}, y: ${p.y} });`;
+    case "swipe":
+      return `await browser.execute('mobile: swipe', { direction: '${escapeStr(p.direction)}' });`;
+    case "drag_and_drop":
+      if (p.targetSelector !== void 0) {
+        return `await browser.$('${escapeStr(p.sourceSelector)}').dragAndDrop(browser.$('${escapeStr(p.targetSelector)}'));`;
+      }
+      return `await browser.$('${escapeStr(p.sourceSelector)}').dragAndDrop({ x: ${p.x}, y: ${p.y} });`;
+    default:
+      return `// [unknown tool] ${step.tool}`;
+  }
+}
+function generateCode(history) {
+  const steps = history.steps.map((step) => generateStep(step, history)).join("\n");
+  return `import { remote } from 'webdriverio';
+
+${steps}
+
+await browser.deleteSession();`;
+}
+
+// src/recording/resources.ts
+function getCurrentSessionId() {
+  return getBrowser.__state?.currentSession ?? null;
+}
+function buildSessionsIndex() {
+  const histories = getSessionHistory();
+  const currentId = getCurrentSessionId();
+  const sessions = Array.from(histories.values()).map((h) => ({
+    sessionId: h.sessionId,
+    type: h.type,
+    startedAt: h.startedAt,
+    ...h.endedAt ? { endedAt: h.endedAt } : {},
+    stepCount: h.steps.length,
+    isCurrent: h.sessionId === currentId
+  }));
+  return JSON.stringify({ sessions });
+}
+function buildCurrentSessionSteps() {
+  const currentId = getCurrentSessionId();
+  if (!currentId) return null;
+  return buildSessionStepsById(currentId);
+}
+function buildSessionStepsById(sessionId) {
+  const history = getSessionHistory().get(sessionId);
+  if (!history) return null;
+  return buildSessionPayload(history);
+}
+function buildSessionPayload(history) {
+  const stepsJson = JSON.stringify({
+    sessionId: history.sessionId,
+    type: history.type,
+    startedAt: history.startedAt,
+    ...history.endedAt ? { endedAt: history.endedAt } : {},
+    stepCount: history.steps.length,
+    steps: history.steps
+  });
+  return { stepsJson, generatedJs: generateCode(history) };
+}
+
 // src/server.ts
 console.log = (...args) => console.error("[LOG]", ...args);
 console.info = (...args) => console.error("[INFO]", ...args);
@@ -2840,31 +3089,32 @@ var server = new McpServer({
 }, {
   instructions: "MCP server for browser and mobile app automation using WebDriverIO. Supports Chrome, Firefox, Edge, and Safari browser control plus iOS/Android native app testing via Appium.",
   capabilities: {
-    tools: {}
+    tools: {},
+    resources: {}
   }
 });
 var registerTool = (definition, callback) => server.registerTool(definition.name, {
   description: definition.description,
   inputSchema: definition.inputSchema
 }, callback);
-registerTool(startBrowserToolDefinition, startBrowserTool);
-registerTool(startAppToolDefinition, startAppTool);
+registerTool(startBrowserToolDefinition, withRecording("start_browser", startBrowserTool));
+registerTool(startAppToolDefinition, withRecording("start_app_session", startAppTool));
 registerTool(closeSessionToolDefinition, closeSessionTool);
-registerTool(attachBrowserToolDefinition, attachBrowserTool);
+registerTool(attachBrowserToolDefinition, withRecording("attach_browser", attachBrowserTool));
 registerTool(emulateDeviceToolDefinition, emulateDeviceTool);
-registerTool(navigateToolDefinition, navigateTool);
+registerTool(navigateToolDefinition, withRecording("navigate", navigateTool));
 registerTool(getVisibleElementsToolDefinition, getVisibleElementsTool);
 registerTool(getAccessibilityToolDefinition, getAccessibilityTreeTool);
-registerTool(scrollToolDefinition, scrollTool);
-registerTool(clickToolDefinition, clickTool);
-registerTool(setValueToolDefinition, setValueTool);
+registerTool(scrollToolDefinition, withRecording("scroll", scrollTool));
+registerTool(clickToolDefinition, withRecording("click_element", clickTool));
+registerTool(setValueToolDefinition, withRecording("set_value", setValueTool));
 registerTool(takeScreenshotToolDefinition, takeScreenshotTool);
 registerTool(getCookiesToolDefinition, getCookiesTool);
 registerTool(setCookieToolDefinition, setCookieTool);
 registerTool(deleteCookiesToolDefinition, deleteCookiesTool);
-registerTool(tapElementToolDefinition, tapElementTool);
-registerTool(swipeToolDefinition, swipeTool);
-registerTool(dragAndDropToolDefinition, dragAndDropTool);
+registerTool(tapElementToolDefinition, withRecording("tap_element", tapElementTool));
+registerTool(swipeToolDefinition, withRecording("swipe", swipeTool));
+registerTool(dragAndDropToolDefinition, withRecording("drag_and_drop", dragAndDropTool));
 registerTool(getAppStateToolDefinition, getAppStateTool);
 registerTool(getContextsToolDefinition, getContextsTool);
 registerTool(getCurrentContextToolDefinition, getCurrentContextTool);
@@ -2874,6 +3124,58 @@ registerTool(hideKeyboardToolDefinition, hideKeyboardTool);
 registerTool(getGeolocationToolDefinition, getGeolocationTool);
 registerTool(setGeolocationToolDefinition, setGeolocationTool);
 registerTool(executeScriptToolDefinition, executeScriptTool);
+server.registerResource(
+  "sessions",
+  "wdio://sessions",
+  { description: "JSON index of all browser and app sessions with metadata and step counts" },
+  async () => ({
+    contents: [{ uri: "wdio://sessions", mimeType: "application/json", text: buildSessionsIndex() }]
+  })
+);
+server.registerResource(
+  "session-current-steps",
+  "wdio://session/current/steps",
+  { description: "JSON step log for the currently active session" },
+  async () => {
+    const payload = buildCurrentSessionSteps();
+    return {
+      contents: [{ uri: "wdio://session/current/steps", mimeType: "application/json", text: payload?.stepsJson ?? '{"error":"No active session"}' }]
+    };
+  }
+);
+server.registerResource(
+  "session-current-code",
+  "wdio://session/current/code",
+  { description: "Generated WebdriverIO JS code for the currently active session" },
+  async () => {
+    const payload = buildCurrentSessionSteps();
+    return {
+      contents: [{ uri: "wdio://session/current/code", mimeType: "text/plain", text: payload?.generatedJs ?? "// No active session" }]
+    };
+  }
+);
+server.registerResource(
+  "session-steps",
+  new ResourceTemplate("wdio://session/{sessionId}/steps", { list: void 0 }),
+  { description: "JSON step log for a specific session by ID" },
+  async (uri, { sessionId }) => {
+    const payload = buildSessionStepsById(sessionId);
+    return {
+      contents: [{ uri: uri.href, mimeType: "application/json", text: payload?.stepsJson ?? `{"error":"Session not found: ${sessionId}"}` }]
+    };
+  }
+);
+server.registerResource(
+  "session-code",
+  new ResourceTemplate("wdio://session/{sessionId}/code", { list: void 0 }),
+  { description: "Generated WebdriverIO JS code for a specific session by ID" },
+  async (uri, { sessionId }) => {
+    const payload = buildSessionStepsById(sessionId);
+    return {
+      contents: [{ uri: uri.href, mimeType: "text/plain", text: payload?.generatedJs ?? `// Session not found: ${sessionId}` }]
+    };
+  }
+);
 async function main() {
   const transport = new StdioServerTransport();
   await server.connect(transport);