@ticktockbent/charlotte 0.1.0

package/dist/tools/evaluate.d.ts

@@ -0,0 +1,10 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { BrowserManager } from "../browser/browser-manager.js";
+import type { PageManager } from "../browser/page-manager.js";
+export interface EvaluateDeps {
+    browserManager: BrowserManager;
+    pageManager?: PageManager;
+    getActivePage: () => import("puppeteer").Page;
+}
+export declare function registerEvaluateTools(server: McpServer, deps: EvaluateDeps): void;
+//# sourceMappingURL=evaluate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"evaluate.d.ts","sourceRoot":"","sources":["../../src/tools/evaluate.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAI9D,MAAM,WAAW,YAAY;IAC3B,cAAc,EAAE,cAAc,CAAC;IAC/B,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,aAAa,EAAE,MAAM,OAAO,WAAW,EAAE,IAAI,CAAC;CAC/C;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,YAAY,GACjB,IAAI,CA0HN"}

package/dist/tools/evaluate.js

@@ -0,0 +1,109 @@
+import { z } from "zod";
+import { CharlotteError, CharlotteErrorCode } from "../types/errors.js";
+import { logger } from "../utils/logger.js";
+export function registerEvaluateTools(server, deps) {
+    server.registerTool("charlotte:evaluate", {
+        description: "Execute JavaScript in page context. Useful for reading computed values, triggering custom events, or accessing page-level APIs.",
+        inputSchema: {
+            expression: z.string().describe("JS expression to evaluate"),
+            timeout: z
+                .number()
+                .optional()
+                .describe("Max execution time in ms (default: 5000)"),
+            await_promise: z
+                .boolean()
+                .optional()
+                .describe("If the expression returns a Promise, await it before returning (default: true)"),
+        },
+    }, async ({ expression, timeout, await_promise }) => {
+        await deps.browserManager.ensureConnected();
+        const page = deps.getActivePage();
+        const evaluationTimeout = timeout ?? 5000;
+        const shouldAwaitPromise = await_promise ?? true;
+        try {
+            const result = await Promise.race([
+                page.evaluate(async (expr, awaitPromise) => {
+                    try {
+                        let result = eval(expr);
+                        if (awaitPromise && result && typeof result === "object" && typeof result.then === "function") {
+                            result = await result;
+                        }
+                        // Serialize the result
+                        if (result === undefined)
+                            return { value: null, type: "undefined" };
+                        if (result === null)
+                            return { value: null, type: "null" };
+                        if (typeof result === "function")
+                            return { value: result.toString(), type: "function" };
+                        if (result instanceof HTMLElement)
+                            return { value: result.outerHTML.substring(0, 200), type: "HTMLElement" };
+                        if (result instanceof Node)
+                            return { value: result.nodeName, type: "Node" };
+                        try {
+                            return { value: JSON.parse(JSON.stringify(result)), type: typeof result };
+                        }
+                        catch {
+                            return { value: String(result), type: typeof result };
+                        }
+                    }
+                    catch (error) {
+                        return {
+                            error: true,
+                            message: error.message,
+                            stack: error.stack,
+                        };
+                    }
+                }, expression, shouldAwaitPromise),
+                new Promise((_, reject) => setTimeout(() => reject(new Error("TIMEOUT")), evaluationTimeout)),
+            ]);
+            if (result && typeof result === "object" && "error" in result && result.error) {
+                throw new CharlotteError(CharlotteErrorCode.EVALUATION_ERROR, `Evaluation error: ${result.message}`);
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(result, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            if (error instanceof CharlotteError) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify(error.toResponse()),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            if (error instanceof Error && error.message === "TIMEOUT") {
+                const timeoutError = new CharlotteError(CharlotteErrorCode.TIMEOUT, `Expression evaluation exceeded ${evaluationTimeout}ms. The expression may have had side effects before termination.`);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify(timeoutError.toResponse()),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            logger.error("Unexpected error in evaluate", error);
+            const sessionError = new CharlotteError(CharlotteErrorCode.SESSION_ERROR, `Unexpected error: ${error instanceof Error ? error.message : String(error)}`);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(sessionError.toResponse()),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=evaluate.js.map

package/dist/tools/evaluate.js.map

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

package/dist/tools/interaction.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ToolDependencies } from "./tool-helpers.js";
+export declare function registerInteractionTools(server: McpServer, deps: ToolDependencies): void;
+//# sourceMappingURL=interaction.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"interaction.d.ts","sourceRoot":"","sources":["../../src/tools/interaction.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAqR1D,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,gBAAgB,GACrB,IAAI,CA4eN"}