@ticktockbent/charlotte 0.6.0 → 0.6.2

package/dist/tools/wait-for.js

@@ -0,0 +1,169 @@
+import { z } from "zod";
+import { CharlotteError, CharlotteErrorCode } from "../types/errors.js";
+import { logger } from "../utils/logger.js";
+import { ensureReady, renderActivePage, renderAfterAction, formatPageResponse, handleToolError, } from "./tool-helpers.js";
+export function registerWaitForTools(server, deps) {
+    const tools = {};
+    // ─── charlotte_wait_for ───
+    tools["charlotte_wait_for"] = server.registerTool("charlotte_wait_for", {
+        description: "Wait for a condition to be met on the page. Returns page representation when the condition is satisfied, or a TIMEOUT error.",
+        inputSchema: {
+            element_id: z.string().optional().describe("Wait for specific element to appear/change"),
+            state: z
+                .enum(["visible", "hidden", "enabled", "disabled", "exists", "removed"])
+                .optional()
+                .describe("Target element state to wait for"),
+            text: z.string().optional().describe("Wait for text to appear on the page"),
+            selector: z.string().optional().describe("Wait for CSS selector to match"),
+            js: z.string().optional().describe("Wait for JS expression to return truthy"),
+            timeout: z.number().optional().describe("Max wait in ms (default: 10000)"),
+        },
+    }, async ({ element_id, state, text, selector, js, timeout }) => {
+        try {
+            await ensureReady(deps);
+            const page = deps.pageManager.getActivePage();
+            const waitTimeout = timeout ?? 10000;
+            // Validate that at least one condition is provided
+            if (!element_id && !text && !selector && !js) {
+                throw new CharlotteError(CharlotteErrorCode.SESSION_ERROR, "At least one wait condition is required (element_id, text, selector, or js).");
+            }
+            logger.info("Waiting for condition", {
+                element_id,
+                state,
+                text,
+                selector,
+                js,
+                timeout: waitTimeout,
+            });
+            // Build a composite wait condition
+            const satisfied = await pollWaitForCondition(deps, page, { element_id, state, text, selector, js }, waitTimeout);
+            if (!satisfied) {
+                const representation = await renderAfterAction(deps);
+                const timeoutError = new CharlotteError(CharlotteErrorCode.TIMEOUT, `Wait condition not met within ${waitTimeout}ms.`, "The current page state is included in the response. Consider increasing timeout or adjusting your condition.");
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                ...timeoutError.toResponse(),
+                                page: representation,
+                            }),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            const representation = await renderAfterAction(deps);
+            return formatPageResponse(representation);
+        }
+        catch (error) {
+            return handleToolError(error);
+        }
+    });
+    return tools;
+}
+/**
+ * Poll for complex wait_for conditions that may involve element state checks.
+ */
+async function pollWaitForCondition(deps, page, condition, timeoutMs) {
+    const pollInterval = 100;
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        let allSatisfied = true;
+        // Check element_id + state condition
+        if (condition.element_id) {
+            const targetState = condition.state ?? "exists";
+            const elementSatisfied = await checkElementCondition(deps, condition.element_id, targetState);
+            if (!elementSatisfied)
+                allSatisfied = false;
+        }
+        // Check text condition
+        if (allSatisfied && condition.text) {
+            const textFound = await page.evaluate((searchText) => {
+                return document.body?.innerText?.includes(searchText) ?? false;
+            }, condition.text);
+            if (!textFound)
+                allSatisfied = false;
+        }
+        // Check selector condition
+        if (allSatisfied && condition.selector) {
+            const selectorMatched = await page.$(condition.selector);
+            if (!selectorMatched)
+                allSatisfied = false;
+        }
+        // Check JS condition via CDP Runtime.evaluate (matches evaluate.ts pattern)
+        if (allSatisfied && condition.js) {
+            const cdpSession = await page.createCDPSession();
+            try {
+                const evalResult = await cdpSession.send("Runtime.evaluate", {
+                    expression: condition.js,
+                    returnByValue: true,
+                    awaitPromise: true,
+                    timeout: Math.max(0, deadline - Date.now()),
+                });
+                const isTruthy = !evalResult.exceptionDetails && !!evalResult.result.value;
+                if (!isTruthy)
+                    allSatisfied = false;
+            }
+            catch {
+                allSatisfied = false;
+            }
+            finally {
+                await cdpSession.detach().catch(() => { });
+            }
+        }
+        if (allSatisfied)
+            return true;
+        const remainingTime = deadline - Date.now();
+        if (remainingTime <= 0)
+            break;
+        await new Promise((resolve) => setTimeout(resolve, Math.min(pollInterval, remainingTime)));
+    }
+    return false;
+}
+/**
+ * Check if an element meets a specific state condition.
+ */
+async function checkElementCondition(deps, elementId, targetState) {
+    switch (targetState) {
+        case "exists": {
+            const backendNodeId = deps.elementIdGenerator.resolveId(elementId);
+            return backendNodeId !== null;
+        }
+        case "removed": {
+            const backendNodeId = deps.elementIdGenerator.resolveId(elementId);
+            if (backendNodeId !== null) {
+                // Re-render to check if it's truly still there
+                await renderActivePage(deps, { detail: "minimal" });
+                return deps.elementIdGenerator.resolveId(elementId) === null;
+            }
+            return true;
+        }
+        case "visible":
+        case "hidden":
+        case "enabled":
+        case "disabled": {
+            // Re-render to get fresh state
+            const representation = await renderActivePage(deps, { detail: "minimal" });
+            const element = representation.interactive.find((el) => el.id === elementId);
+            if (!element) {
+                // Element doesn't exist — "hidden" and "disabled" are satisfied, others not
+                return targetState === "hidden" || targetState === "disabled";
+            }
+            switch (targetState) {
+                case "visible":
+                    return element.state.visible === true;
+                case "hidden":
+                    return element.state.visible === false;
+                case "enabled":
+                    return element.state.enabled === true;
+                case "disabled":
+                    return element.state.enabled === false;
+            }
+            return false;
+        }
+        default:
+            return false;
+    }
+}
+//# sourceMappingURL=wait-for.js.map

package/dist/tools/wait-for.js.map

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

package/dist/types/config.d.ts

@@ -1,5 +1,11 @@
 export type AutoSnapshotMode = "every_action" | "observe_only" | "manual";
 export type DialogAutoDismiss = "none" | "accept_alerts" | "accept_all" | "dismiss_all";
+export type DeviceType = "mobile" | "tablet" | "desktop";
+/** Default viewport dimensions for each device type. */
+export declare const DEVICE_VIEWPORT_PRESETS: Record<DeviceType, {
+    width: number;
+    height: number;
+}>;
 export interface CharlotteConfig {
     /** Root directory boundary for dev_serve to prevent path traversal */
     allowedWorkspaceRoot?: string;
@@ -14,6 +20,16 @@ export interface CharlotteConfig {
     includeIframes: boolean;
     /** Maximum iframe nesting depth to traverse. Default: 3. */
     iframeDepth: number;
+    /** Default viewport dimensions used at browser launch and as fallback. */
+    defaultViewport: {
+        width: number;
+        height: number;
+    };
+    /** Named device viewport presets for the charlotte_viewport tool. */
+    deviceViewportPresets: Record<DeviceType, {
+        width: number;
+        height: number;
+    }>;
 }
 export declare function createDefaultConfig(): CharlotteConfig;
 //# sourceMappingURL=config.d.ts.map

package/dist/types/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG,cAAc,GAAG,cAAc,GAAG,QAAQ,CAAC;AAC1E,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,eAAe,GAAG,YAAY,GAAG,aAAa,CAAC;AAExF,MAAM,WAAW,eAAe;IAC9B,sEAAsE;IACtE,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,gBAAgB,CAAC;IAC/B,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,8EAA8E;IAC9E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kGAAkG;IAClG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iFAAiF;IACjF,cAAc,EAAE,OAAO,CAAC;IACxB,4DAA4D;IAC5D,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,mBAAmB,IAAI,eAAe,CASrD"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG,cAAc,GAAG,cAAc,GAAG,QAAQ,CAAC;AAC1E,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,eAAe,GAAG,YAAY,GAAG,aAAa,CAAC;AACxF,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEzD,wDAAwD;AACxD,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,UAAU,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAOzF,CAAC;AAEF,MAAM,WAAW,eAAe;IAC9B,sEAAsE;IACtE,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,gBAAgB,CAAC;IAC/B,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,8EAA8E;IAC9E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kGAAkG;IAClG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iFAAiF;IACjF,cAAc,EAAE,OAAO,CAAC;IACxB,4DAA4D;IAC5D,WAAW,EAAE,MAAM,CAAC;IACpB,0EAA0E;IAC1E,eAAe,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,qEAAqE;IACrE,qBAAqB,EAAE,MAAM,CAAC,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC9E;AAED,wBAAgB,mBAAmB,IAAI,eAAe,CAerD"}

package/dist/types/config.js

@@ -1,3 +1,12 @@
+/** Default viewport dimensions for each device type. */
+export const DEVICE_VIEWPORT_PRESETS = {
+    /** Common Modern Laptop Effective Resolution */
+    desktop: { width: 1440, height: 900 },
+    /** iPhone 14 Pro Effective Resolution */
+    mobile: { width: 393, height: 852 },
+    /** Standard Tablet Resolution */
+    tablet: { width: 768, height: 1024 },
+};
 export function createDefaultConfig() {
     return {
         snapshotDepth: 50,
@@ -6,6 +15,12 @@ export function createDefaultConfig() {
         allowedWorkspaceRoot: process.cwd(), // Default to cwd for universal safety
         includeIframes: false,
         iframeDepth: 3,
+        defaultViewport: { ...DEVICE_VIEWPORT_PRESETS.desktop },
+        deviceViewportPresets: {
+            desktop: { ...DEVICE_VIEWPORT_PRESETS.desktop },
+            mobile: { ...DEVICE_VIEWPORT_PRESETS.mobile },
+            tablet: { ...DEVICE_VIEWPORT_PRESETS.tablet },
+        },
     };
 }
 //# sourceMappingURL=config.js.map

package/dist/types/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAmBA,MAAM,UAAU,mBAAmB;IACjC,OAAO;QACL,aAAa,EAAE,EAAE;QACjB,YAAY,EAAE,cAAc;QAC5B,iBAAiB,EAAE,MAAM;QACzB,oBAAoB,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,sCAAsC;QAC3E,cAAc,EAAE,KAAK;QACrB,WAAW,EAAE,CAAC;KACf,CAAC;AACJ,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAIA,wDAAwD;AACxD,MAAM,CAAC,MAAM,uBAAuB,GAA0D;IAC5F,gDAAgD;IAChD,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE;IACrC,yCAAyC;IACzC,MAAM,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE;IACnC,iCAAiC;IACjC,MAAM,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE;CACrC,CAAC;AAsBF,MAAM,UAAU,mBAAmB;IACjC,OAAO;QACL,aAAa,EAAE,EAAE;QACjB,YAAY,EAAE,cAAc;QAC5B,iBAAiB,EAAE,MAAM;QACzB,oBAAoB,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,sCAAsC;QAC3E,cAAc,EAAE,KAAK;QACrB,WAAW,EAAE,CAAC;QACd,eAAe,EAAE,EAAE,GAAG,uBAAuB,CAAC,OAAO,EAAE;QACvD,qBAAqB,EAAE;YACrB,OAAO,EAAE,EAAE,GAAG,uBAAuB,CAAC,OAAO,EAAE;YAC/C,MAAM,EAAE,EAAE,GAAG,uBAAuB,CAAC,MAAM,EAAE;YAC7C,MAAM,EAAE,EAAE,GAAG,uBAAuB,CAAC,MAAM,EAAE;SAC9C;KACF,CAAC;AACJ,CAAC"}

package/dist/utils/wait.js

@@ -35,17 +35,23 @@ async function evaluateCondition(page, condition) {
             return false;
     }
     if (condition.js) {
-        const jsExpression = condition.js;
+        const cdpSession = await page.createCDPSession();
         try {
-            const result = await page.evaluate((expression) => {
-                return !!new Function("return " + expression)();
-            }, jsExpression);
-            if (!result)
+            const evalResult = await cdpSession.send("Runtime.evaluate", {
+                expression: condition.js,
+                returnByValue: true,
+                awaitPromise: true,
+            });
+            const isTruthy = !evalResult.exceptionDetails && !!evalResult.result.value;
+            if (!isTruthy)
                 return false;
         }
         catch {
             return false;
         }
+        finally {
+            await cdpSession.detach().catch(() => { });
+        }
     }
     return true;
 }

package/dist/utils/wait.js.map

@@ -1 +1 @@
-{"version":3,"file":"wait.js","sourceRoot":"","sources":["../../src/utils/wait.ts"],"names":[],"mappings":"AAkBA,MAAM,wBAAwB,GAAG,GAAG,CAAC;AAErC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,IAAU,EACV,SAAwB,EACxB,OAAoB;IAEpB,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,wBAAwB,CAAC;IACtE,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAE9C,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QAC7B,MAAM,SAAS,GAAG,MAAM,iBAAiB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAC3D,IAAI,SAAS;YAAE,OAAO,IAAI,CAAC;QAE3B,MAAM,aAAa,GAAG,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC5C,IAAI,aAAa,IAAI,CAAC;YAAE,MAAM;QAE9B,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC,CAAC;IACrD,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,iBAAiB,CAAC,IAAU,EAAE,SAAwB;IACnE,IAAI,SAAS,CAAC,QAAQ,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACjD,IAAI,CAAC,OAAO;YAAE,OAAO,KAAK,CAAC;IAC7B,CAAC;IAED,IAAI,SAAS,CAAC,IAAI,EAAE,CAAC;QACnB,MAAM,UAAU,GAAG,SAAS,CAAC,IAAI,CAAC;QAClC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC,UAAU,EAAE,EAAE;YAC/C,OAAO,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC;QACjE,CAAC,EAAE,UAAU,CAAC,CAAC;QACf,IAAI,CAAC,KAAK;YAAE,OAAO,KAAK,CAAC;IAC3B,CAAC;IAED,IAAI,SAAS,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,YAAY,GAAG,SAAS,CAAC,EAAE,CAAC;QAClC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC,UAAU,EAAE,EAAE;gBAChD,OAAO,CAAC,CAAC,IAAI,QAAQ,CAAC,SAAS,GAAG,UAAU,CAAC,EAAE,CAAC;YAClD,CAAC,EAAE,YAAY,CAAC,CAAC;YACjB,IAAI,CAAC,MAAM;gBAAE,OAAO,KAAK,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}
+{"version":3,"file":"wait.js","sourceRoot":"","sources":["../../src/utils/wait.ts"],"names":[],"mappings":"AAkBA,MAAM,wBAAwB,GAAG,GAAG,CAAC;AAErC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,IAAU,EACV,SAAwB,EACxB,OAAoB;IAEpB,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,wBAAwB,CAAC;IACtE,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAE9C,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QAC7B,MAAM,SAAS,GAAG,MAAM,iBAAiB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAC3D,IAAI,SAAS;YAAE,OAAO,IAAI,CAAC;QAE3B,MAAM,aAAa,GAAG,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC5C,IAAI,aAAa,IAAI,CAAC;YAAE,MAAM;QAE9B,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC,CAAC;IACrD,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,iBAAiB,CAAC,IAAU,EAAE,SAAwB;IACnE,IAAI,SAAS,CAAC,QAAQ,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACjD,IAAI,CAAC,OAAO;YAAE,OAAO,KAAK,CAAC;IAC7B,CAAC;IAED,IAAI,SAAS,CAAC,IAAI,EAAE,CAAC;QACnB,MAAM,UAAU,GAAG,SAAS,CAAC,IAAI,CAAC;QAClC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC,UAAU,EAAE,EAAE;YAC/C,OAAO,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC;QACjE,CAAC,EAAE,UAAU,CAAC,CAAC;QACf,IAAI,CAAC,KAAK;YAAE,OAAO,KAAK,CAAC;IAC3B,CAAC;IAED,IAAI,SAAS,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACjD,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,kBAAkB,EAAE;gBAC3D,UAAU,EAAE,SAAS,CAAC,EAAE;gBACxB,aAAa,EAAE,IAAI;gBACnB,YAAY,EAAE,IAAI;aACnB,CAAC,CAAC;YACH,MAAM,QAAQ,GAAG,CAAC,UAAU,CAAC,gBAAgB,IAAI,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC;YAC3E,IAAI,CAAC,QAAQ;gBAAE,OAAO,KAAK,CAAC;QAC9B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;gBAAS,CAAC;YACT,MAAM,UAAU,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ticktockbent/charlotte",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "description": "Token-efficient browser MCP server — structured web pages for AI agents, not raw accessibility dumps",
   "type": "module",
   "main": "dist/index.js",