@ticktockbent/charlotte 0.5.1 → 0.6.1

package/dist/tools/interaction-helpers.js

@@ -0,0 +1,312 @@
+import { CharlotteError, CharlotteErrorCode } from "../types/errors.js";
+import { logger } from "../utils/logger.js";
+/** Maps short modifier names to Puppeteer KeyInput values. */
+export const MODIFIER_KEY_MAP = {
+    ctrl: "Control",
+    shift: "Shift",
+    alt: "Alt",
+    meta: "Meta",
+};
+/**
+ * Click an element by backend node ID using CDP to get coordinates, then click at those coords.
+ */
+export async function clickElementByBackendNodeId(page, backendNodeId, clickType = "left", modifiers = []) {
+    // Get the element's box model to find clickable coordinates
+    const cdpSession = await page.createCDPSession();
+    try {
+        // First, scroll the element into view
+        await cdpSession.send("DOM.scrollIntoViewIfNeeded", { backendNodeId });
+        // Get box model for coordinates
+        const { model } = await cdpSession.send("DOM.getBoxModel", {
+            backendNodeId,
+        });
+        if (!model) {
+            throw new CharlotteError(CharlotteErrorCode.ELEMENT_NOT_FOUND, "Element has no visible box model — it may be hidden or zero-sized.", "Call charlotte_observe to check the element's state.");
+        }
+        // content quad: [x1,y1, x2,y2, x3,y3, x4,y4]
+        const contentQuad = model.content;
+        const centerX = (contentQuad[0] + contentQuad[2] + contentQuad[4] + contentQuad[6]) / 4;
+        const centerY = (contentQuad[1] + contentQuad[3] + contentQuad[5] + contentQuad[7]) / 4;
+        // Hold down modifier keys before the click
+        for (const modifier of modifiers) {
+            const modifierKey = MODIFIER_KEY_MAP[modifier];
+            await page.keyboard.down(modifierKey);
+        }
+        try {
+            if (clickType === "right") {
+                await page.mouse.click(centerX, centerY, { button: "right" });
+            }
+            else if (clickType === "double") {
+                await page.mouse.click(centerX, centerY, { clickCount: 2 });
+            }
+            else {
+                await page.mouse.click(centerX, centerY);
+            }
+        }
+        finally {
+            // Release modifier keys in reverse order (always release even if click fails)
+            for (const modifier of [...modifiers].reverse()) {
+                const modifierKey = MODIFIER_KEY_MAP[modifier];
+                await page.keyboard.up(modifierKey);
+            }
+        }
+    }
+    finally {
+        await cdpSession.detach();
+    }
+}
+/**
+ * Wait for any navigation triggered by an action, or fall back to a brief settle pause.
+ *
+ * Listens for the `framenavigated` CDP event to detect if a click caused navigation.
+ * If navigation is detected within `detectionWindowMs`, waits for the page load event
+ * (up to `loadTimeoutMs`). If no navigation fires, returns after `settleMs`.
+ *
+ * Also races against dialog events — if the action triggers a JavaScript dialog
+ * (alert, confirm, prompt, beforeunload), the action promise will block indefinitely.
+ * This function detects that and returns early so the caller can surface `pending_dialog`.
+ */
+export async function waitForPossibleNavigation(page, action, { detectionWindowMs = 500, loadTimeoutMs = 10000, settleMs = 50 } = {}) {
+    let navigationDetected = false;
+    let dialogDetected = false;
+    // Listen for navigation start via page event (fires on any navigation)
+    const navigationStartPromise = new Promise((resolve) => {
+        const handler = () => {
+            navigationDetected = true;
+            page.off("framenavigated", handler);
+            resolve();
+        };
+        page.on("framenavigated", handler);
+        // Clean up listener if no navigation fires within detection window
+        setTimeout(() => {
+            page.off("framenavigated", handler);
+            resolve();
+        }, detectionWindowMs);
+    });
+    // Listen for dialog (blocks the action from completing)
+    const dialogPromise = new Promise((resolve) => {
+        const handler = () => {
+            dialogDetected = true;
+            page.off("dialog", handler);
+            resolve();
+        };
+        page.on("dialog", handler);
+        // Clean up on timeout — if no dialog fires, we don't need this listener
+        setTimeout(() => {
+            page.off("dialog", handler);
+            resolve();
+        }, detectionWindowMs);
+    });
+    // Race: action vs dialog
+    const actionPromise = action();
+    await Promise.race([
+        actionPromise.then(() => "action"),
+        dialogPromise.then(() => "dialog"),
+    ]);
+    if (dialogDetected) {
+        // Dialog is blocking the action. Don't await actionPromise — it will
+        // resolve later when the dialog is handled via charlotte_dialog.
+        // Guard against unhandled rejection from the fire-and-forget promise.
+        actionPromise.catch(() => {
+            logger.debug("Post-dialog action promise rejected (expected)");
+        });
+        return;
+    }
+    // Action completed normally — check for navigation
+    await navigationStartPromise;
+    if (navigationDetected) {
+        // Navigation occurred — wait for the page to finish loading
+        try {
+            await page.waitForNavigation({ waitUntil: "load", timeout: loadTimeoutMs });
+        }
+        catch {
+            // Page may have already finished loading before we called waitForNavigation,
+            // or the load timed out. Either way, render what we have.
+            logger.debug("Post-navigation load wait ended (page may already be loaded)");
+        }
+    }
+    else {
+        // No navigation — brief settle for in-page DOM updates
+        await new Promise((resolve) => setTimeout(resolve, settleMs));
+    }
+}
+/**
+ * Focus an element by backend node ID using CDP.
+ */
+export async function focusElementByBackendNodeId(page, backendNodeId) {
+    const cdpSession = await page.createCDPSession();
+    try {
+        await cdpSession.send("DOM.focus", { backendNodeId });
+    }
+    finally {
+        await cdpSession.detach();
+    }
+}
+/**
+ * Hover over an element by backend node ID.
+ */
+export async function hoverElementByBackendNodeId(page, backendNodeId) {
+    const cdpSession = await page.createCDPSession();
+    try {
+        await cdpSession.send("DOM.scrollIntoViewIfNeeded", { backendNodeId });
+        const { model } = await cdpSession.send("DOM.getBoxModel", {
+            backendNodeId,
+        });
+        if (!model) {
+            throw new CharlotteError(CharlotteErrorCode.ELEMENT_NOT_FOUND, "Element has no visible box model for hover.");
+        }
+        const contentQuad = model.content;
+        const centerX = (contentQuad[0] + contentQuad[2] + contentQuad[4] + contentQuad[6]) / 4;
+        const centerY = (contentQuad[1] + contentQuad[3] + contentQuad[5] + contentQuad[7]) / 4;
+        await page.mouse.move(centerX, centerY);
+    }
+    finally {
+        await cdpSession.detach();
+    }
+}
+/**
+ * Get the center coordinates of an element by backend node ID.
+ * Scrolls the element into view first.
+ */
+async function getElementCenter(page, backendNodeId) {
+    const cdpSession = await page.createCDPSession();
+    try {
+        await cdpSession.send("DOM.scrollIntoViewIfNeeded", { backendNodeId });
+        const { model } = await cdpSession.send("DOM.getBoxModel", {
+            backendNodeId,
+        });
+        if (!model) {
+            throw new CharlotteError(CharlotteErrorCode.ELEMENT_NOT_FOUND, "Element has no visible box model — it may be hidden or zero-sized.", "Call charlotte_observe to check the element's state.");
+        }
+        const contentQuad = model.content;
+        return {
+            x: (contentQuad[0] + contentQuad[2] + contentQuad[4] + contentQuad[6]) / 4,
+            y: (contentQuad[1] + contentQuad[3] + contentQuad[5] + contentQuad[7]) / 4,
+        };
+    }
+    finally {
+        await cdpSession.detach();
+    }
+}
+/**
+ * Drag one element to another using mouse primitives.
+ * Sequence: move to source → mousedown → move to target → mouseup
+ * Includes intermediate move steps and delays to ensure drag events fire reliably.
+ */
+export async function dragElementToElement(page, sourceBackendNodeId, targetBackendNodeId) {
+    const sourceCenter = await getElementCenter(page, sourceBackendNodeId);
+    const targetCenter = await getElementCenter(page, targetBackendNodeId);
+    // Move to source and press down
+    await page.mouse.move(sourceCenter.x, sourceCenter.y);
+    await page.mouse.down();
+    // Intermediate move to trigger dragstart (some browsers need movement to begin a drag)
+    await page.mouse.move(sourceCenter.x + (targetCenter.x - sourceCenter.x) * 0.25, sourceCenter.y + (targetCenter.y - sourceCenter.y) * 0.25, { steps: 5 });
+    await new Promise((resolve) => setTimeout(resolve, 50));
+    // Move to target
+    await page.mouse.move(targetCenter.x, targetCenter.y, { steps: 10 });
+    await new Promise((resolve) => setTimeout(resolve, 50));
+    // Release
+    await page.mouse.up();
+}
+/**
+ * Type text into an input element. Uses CDP to focus, optionally clears, then types via keyboard.
+ */
+export async function typeIntoElement(page, backendNodeId, text, clearFirst, pressEnter, characterDelay) {
+    // Focus the element
+    await focusElementByBackendNodeId(page, backendNodeId);
+    if (clearFirst) {
+        // Select all text then delete — works cross-platform
+        await page.keyboard.down("Control");
+        await page.keyboard.press("a");
+        await page.keyboard.up("Control");
+        await page.keyboard.press("Backspace");
+    }
+    // Type the text — with optional per-character delay for sites with
+    // key-by-key event handlers (autocomplete, search-as-you-type, etc.)
+    await page.keyboard.type(text, characterDelay ? { delay: characterDelay } : undefined);
+    if (pressEnter) {
+        await page.keyboard.press("Enter");
+    }
+}
+/**
+ * Select a value in a <select> element using CDP to set the value and dispatch change events.
+ */
+export async function selectOptionByBackendNodeId(page, backendNodeId, value) {
+    const cdpSession = await page.createCDPSession();
+    try {
+        // Resolve the node to get a remote object reference
+        const { object } = await cdpSession.send("DOM.resolveNode", {
+            backendNodeId,
+        });
+        if (!object?.objectId) {
+            throw new CharlotteError(CharlotteErrorCode.ELEMENT_NOT_FOUND, "Could not resolve select element.");
+        }
+        // Use Runtime.callFunctionOn to set the value and fire events
+        await cdpSession.send("Runtime.callFunctionOn", {
+            objectId: object.objectId,
+            functionDeclaration: `function(targetValue) {
+        const options = Array.from(this.options);
+        const matchByValue = options.find(o => o.value === targetValue);
+        const matchByText = options.find(o => o.textContent.trim() === targetValue);
+        const match = matchByValue || matchByText;
+        if (match) {
+          this.value = match.value;
+          this.dispatchEvent(new Event('input', { bubbles: true }));
+          this.dispatchEvent(new Event('change', { bubbles: true }));
+        } else {
+          throw new Error('Option "' + targetValue + '" not found');
+        }
+      }`,
+            arguments: [{ value }],
+        });
+    }
+    finally {
+        await cdpSession.detach();
+    }
+}
+/**
+ * Submit a form by backend node ID — calls form.submit() via CDP.
+ */
+export async function submitFormByBackendNodeId(page, backendNodeId) {
+    const cdpSession = await page.createCDPSession();
+    try {
+        const { object } = await cdpSession.send("DOM.resolveNode", {
+            backendNodeId,
+        });
+        if (!object?.objectId) {
+            throw new CharlotteError(CharlotteErrorCode.ELEMENT_NOT_FOUND, "Could not resolve form element.");
+        }
+        await cdpSession.send("Runtime.callFunctionOn", {
+            objectId: object.objectId,
+            functionDeclaration: `function() {
+        this.dispatchEvent(new Event('submit', { bubbles: true, cancelable: true }));
+      }`,
+        });
+    }
+    finally {
+        await cdpSession.detach();
+    }
+}
+/**
+ * Set files on a file input element using CDP DOM.setFileInputFiles.
+ * Validates that the target element is actually an <input type="file">.
+ */
+export async function setFileInputFiles(page, backendNodeId, filePaths) {
+    const cdpSession = await page.createCDPSession();
+    try {
+        const { node } = await cdpSession.send("DOM.describeNode", { backendNodeId });
+        const isFileInput = node.nodeName === "INPUT" &&
+            (node.attributes ?? []).some((attr, i, arr) => attr === "type" && arr[i + 1] === "file");
+        if (!isFileInput) {
+            throw new CharlotteError(CharlotteErrorCode.SESSION_ERROR, "Element is not a file input.", "Use charlotte_find to locate file_input elements.");
+        }
+        await cdpSession.send("DOM.setFileInputFiles", {
+            files: filePaths,
+            backendNodeId,
+        });
+    }
+    finally {
+        await cdpSession.detach();
+    }
+}
+//# sourceMappingURL=interaction-helpers.js.map

package/dist/tools/interaction-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interaction-helpers.js","sourceRoot":"","sources":["../../src/tools/interaction-helpers.ts"],"names":[],"mappings":"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"}

package/dist/tools/interaction.d.ts

@@ -1,22 +1,6 @@
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import type { Page } from "puppeteer";
 import type { RegisteredTool } from "@modelcontextprotocol/sdk/server/mcp.js";
 import type { ToolDependencies } from "./tool-helpers.js";
-/**
- * Wait for any navigation triggered by an action, or fall back to a brief settle pause.
- *
- * Listens for the `framenavigated` CDP event to detect if a click caused navigation.
- * If navigation is detected within `detectionWindowMs`, waits for the page load event
- * (up to `loadTimeoutMs`). If no navigation fires, returns after `settleMs`.
- *
- * Also races against dialog events — if the action triggers a JavaScript dialog
- * (alert, confirm, prompt, beforeunload), the action promise will block indefinitely.
- * This function detects that and returns early so the caller can surface `pending_dialog`.
- */
-export declare function waitForPossibleNavigation(page: Page, action: () => Promise<void>, { detectionWindowMs, loadTimeoutMs, settleMs }?: {
-    detectionWindowMs?: number | undefined;
-    loadTimeoutMs?: number | undefined;
-    settleMs?: number | undefined;
-}): Promise<void>;
+export { waitForPossibleNavigation } from "./interaction-helpers.js";
 export declare function registerInteractionTools(server: McpServer, deps: ToolDependencies): Record<string, RegisteredTool>;
 //# sourceMappingURL=interaction.d.ts.map

package/dist/tools/interaction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interaction.d.ts","sourceRoot":"","sources":["../../src/tools/interaction.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,IAAI,EAAY,MAAM,WAAW,CAAC;AAGhD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AAC9E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAgF1D;;;;;;;;;;GAUG;AACH,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAC3B,EAAE,iBAAuB,EAAE,aAAqB,EAAE,QAAa,EAAE;;;;CAAK,GACrE,OAAO,CAAC,IAAI,CAAC,CAoEf;AAmPD,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,gBAAgB,GACrB,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CA4pBhC"}
+{"version":3,"file":"interaction.d.ts","sourceRoot":"","sources":["../../src/tools/interaction.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AAC9E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAyB1D,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAErE,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,gBAAgB,GACrB,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CA+sBhC"}