feat(mcp-tools): add hover element tool

Author: rocketraccoon

.gitignore

@@ -3,3 +3,4 @@ build
 testplane-mcp-*.tgz
 tmp
 .vscode
+.idea

src/tools/hover-element.ts

@@ -0,0 +1,44 @@
+import { ToolCallback } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { ToolDefinition } from "../types.js";
+import { contextProvider } from "../context-provider.js";
+import { createElementStateResponse, createErrorResponse } from "../responses/index.js";
+import { elementSelectorSchema, findElement } from "./utils/element-selector.js";
+
+export const elementHoverSchema = elementSelectorSchema;
+
+const hoverElementCb: ToolCallback<typeof elementHoverSchema> = async args => {
+    try {
+        const context = contextProvider.getContext();
+        const browser = await context.browser.get();
+
+        const { element, queryDescription, testplaneCode } = await findElement(browser, args.locator);
+
+        await element.moveTo();
+
+        console.error(`Successfully hovered element with ${queryDescription}`);
+
+        return await createElementStateResponse(element, {
+            action: `Successfully hovered element found by ${queryDescription}`,
+            testplaneCode: testplaneCode.startsWith("await")
+                ? `await (${testplaneCode}).moveTo();`
+                : `await ${testplaneCode}.moveTo();`,
+        });
+    } catch (error) {
+        console.error("Error hover element:", error);
+
+        if (error instanceof Error && error.message.includes("Unable to find")) {
+            return createErrorResponse(
+                "Element not found. Try using a different query strategy or check if the element exists on the page.",
+            );
+        }
+
+        return createErrorResponse("Error hover element", error instanceof Error ? error : undefined);
+    }
+};
+
+export const hoverElement: ToolDefinition<typeof elementHoverSchema> = {
+    name: "hoverElement",
+    description: "Hover an element on the page.",
+    schema: elementHoverSchema,
+    cb: hoverElementCb,
+};

src/tools/index.ts

@@ -2,6 +2,7 @@ import { ToolDefinition } from "../types.js";
 import { navigate } from "./navigate.js";
 import { closeBrowser } from "./close-browser.js";
 import { clickOnElement } from "./click-on-element.js";
+import { hoverElement } from "./hover-element.js";
 import { typeIntoElement } from "./type-into-element.js";
 import { takePageSnapshot } from "./take-page-snapshot.js";
 import { listTabs } from "./list-tabs.js";
@@ -14,6 +15,7 @@ export const tools = [
     navigate,
     closeBrowser,
     clickOnElement,
+    hoverElement,
     typeIntoElement,
     takePageSnapshot,
     listTabs,