@roxybrowser/playwright 2.0.2-beta.0

package/dist/mcp/tools/keyboard.js

@@ -0,0 +1,44 @@
+import { z } from "zod";
+import { defineTool, textResult } from "../tool.js";
+import { formatSnapshot } from "../format.js";
+const type = defineTool({
+    schema: {
+        name: "browser_type",
+        title: "Browser Type",
+        description: "Type text into an element. Returns an updated snapshot after typing.",
+        inputSchema: z.object({
+            element: z.string().optional().describe("Human-readable element description used to obtain permission"),
+            target: z.string().describe("Exact target element reference from the page snapshot, or a unique element selector"),
+            text: z.string().describe("Text to type into the element"),
+            submit: z.boolean().optional().describe("Whether to submit entered text (press Enter after)"),
+            slowly: z.boolean().optional().describe("Whether to type one character at a time. Useful for triggering key handlers in the page. By default entire text is filled in at once.")
+        })
+    },
+    handle: async (args, runtime) => {
+        const snap = await runtime.type(args.target, args.text, {
+            ...(args.submit !== undefined ? { submit: args.submit } : {}),
+            ...(args.slowly !== undefined ? { slowly: args.slowly } : {})
+        });
+        if (!snap)
+            return textResult(`Typed into "${args.element ?? args.target}".`);
+        return textResult(formatSnapshot(snap));
+    }
+});
+const pressKey = defineTool({
+    schema: {
+        name: "browser_press_key",
+        title: "Browser Press Key",
+        description: "Press a keyboard key, optionally with modifier keys. Returns an updated snapshot.",
+        inputSchema: z.object({
+            key: z.string().describe("Key to press, e.g. Enter, Escape, Tab, ArrowLeft, Backspace, Delete, or printable characters")
+        })
+    },
+    handle: async (args, runtime) => {
+        const snap = await runtime.pressKey(args.key);
+        if (!snap)
+            return textResult(`Pressed key "${args.key}".`);
+        return textResult(formatSnapshot(snap));
+    }
+});
+export default [];
+//# sourceMappingURL=keyboard.js.map

package/dist/mcp/tools/keyboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyboard.js","sourceRoot":"","sources":["../../../src/mcp/tools/keyboard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,IAAI,GAAG,UAAU,CAAC;IACtB,MAAM,EAAE;QACN,IAAI,EAAE,cAAc;QACpB,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE,sEAAsE;QACnF,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CACrC,8DAA8D,CAC/D;YACD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CACzB,qFAAqF,CACtF;YACD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;YAC1D,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oDAAoD,CAAC;YAC7F,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uIAAuI,CAAC;SACjL,CAAC;KACH;IACD,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;QAC9B,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE;YACtD,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7D,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9D,CAAC,CAAC;QACH,IAAI,CAAC,IAAI;YAAE,OAAO,UAAU,CAAC,eAAe,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;QAC7E,OAAO,UAAU,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1C,CAAC;CACF,CAAC,CAAC;AAEH,MAAM,QAAQ,GAAG,UAAU,CAAC;IAC1B,MAAM,EAAE;QACN,IAAI,EAAE,mBAAmB;QACzB,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EAAE,mFAAmF;QAChG,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CACtB,8FAA8F,CAC/F;SACF,CAAC;KACH;IACD,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;QAC9B,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC9C,IAAI,CAAC,IAAI;YAAE,OAAO,UAAU,CAAC,gBAAgB,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;QAC3D,OAAO,UAAU,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1C,CAAC;CACF,CAAC,CAAC;AAEH,eAAe,EAAE,CAAC"}

package/dist/mcp/tools/mouse.d.ts

@@ -0,0 +1,3 @@
+declare const _default: never[];
+export default _default;
+//# sourceMappingURL=mouse.d.ts.map

package/dist/mcp/tools/mouse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mouse.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/mouse.ts"],"names":[],"mappings":";AAwGA,wBAAkB"}

package/dist/mcp/tools/mouse.js

@@ -0,0 +1,89 @@
+import { z } from "zod";
+import { defineTool, textResult } from "../tool.js";
+import { formatSnapshot } from "../format.js";
+const elementTargetDescription = "Exact target element reference from the page snapshot, or a unique element selector";
+const elementSchema = z.object({
+    element: z.string().optional().describe("Human-readable element description used to obtain permission to interact with the element"),
+    target: z.string().describe(elementTargetDescription)
+});
+const click = defineTool({
+    schema: {
+        name: "browser_click",
+        title: "Browser Click",
+        description: "Perform click on a web page. Returns an updated snapshot.",
+        inputSchema: elementSchema.extend({
+            doubleClick: z.boolean().optional().describe("Whether to perform a double click instead of a single click"),
+            button: z.enum(["left", "right", "middle"]).optional().describe("Button to click, defaults to left"),
+            modifiers: z.array(z.enum(["Alt", "Control", "ControlOrMeta", "Meta", "Shift"])).optional().describe("Modifier keys to press during the click"),
+            human: z.object({
+                profile: z.enum(["cautious", "balanced", "fast"]).optional().describe("Humanization timing profile, defaults to balanced")
+            }).optional().describe("Humanization settings for this click")
+        })
+    },
+    handle: async (args, runtime) => {
+        const snap = await runtime.click(args.target, {
+            ...(args.element !== undefined ? { element: args.element } : {}),
+            ...(args.doubleClick !== undefined ? { doubleClick: args.doubleClick } : {}),
+            ...(args.button !== undefined ? { button: args.button } : {}),
+            ...(args.modifiers !== undefined ? { modifiers: args.modifiers } : {}),
+            ...(args.human !== undefined ? { human: args.human } : {})
+        });
+        if (!snap)
+            return textResult(`Clicked "${args.element ?? args.target}".`);
+        return textResult(formatSnapshot(snap));
+    }
+});
+const hover = defineTool({
+    schema: {
+        name: "browser_hover",
+        title: "Browser Hover",
+        description: "Hover over element on page.",
+        inputSchema: elementSchema
+    },
+    handle: async (args, runtime) => {
+        const snap = await runtime.hover(args.target);
+        if (!snap)
+            return textResult(`Hovered "${args.element ?? args.target}".`);
+        return textResult(formatSnapshot(snap));
+    }
+});
+const drag = defineTool({
+    schema: {
+        name: "browser_drag",
+        title: "Drag mouse",
+        description: "Perform drag and drop between two elements",
+        inputSchema: z.object({
+            startElement: z.string().optional().describe("Human-readable source element description used to obtain the permission to interact with the element"),
+            startTarget: z.string().describe("Exact target element reference from the page snapshot, or a unique element selector"),
+            endElement: z.string().optional().describe("Human-readable target element description used to obtain the permission to interact with the element"),
+            endTarget: z.string().describe("Exact target element reference from the page snapshot, or a unique element selector")
+        })
+    },
+    handle: async (args, runtime) => {
+        const snap = await runtime.drag(args.startTarget, args.endTarget);
+        if (!snap)
+            return textResult(`Dragged "${args.startElement ?? args.startTarget}" to "${args.endElement ?? args.endTarget}".`);
+        return textResult(formatSnapshot(snap));
+    }
+});
+const scroll = defineTool({
+    schema: {
+        name: "browser_scroll",
+        title: "Browser Scroll",
+        description: "Scroll the page or a specific element. Returns an updated snapshot.",
+        inputSchema: z.object({
+            element: z.string().optional().describe("Human-readable element description used to obtain permission"),
+            ref: z.string().optional().describe("Element to scroll; omit to scroll the whole page"),
+            deltaX: z.number().optional().describe("Horizontal scroll delta in pixels (default 0)"),
+            deltaY: z.number().optional().describe("Vertical scroll delta in pixels (default 0)")
+        })
+    },
+    handle: async (args, runtime) => {
+        const snap = await runtime.scroll(args.ref ?? null, args.deltaX ?? 0, args.deltaY ?? 0);
+        if (!snap)
+            return textResult("Scrolled.");
+        return textResult(formatSnapshot(snap));
+    }
+});
+export default [];
+//# sourceMappingURL=mouse.js.map

package/dist/mcp/tools/mouse.js.map

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

package/dist/mcp/tools/navigate.d.ts

@@ -0,0 +1,6 @@
+import { z } from "zod";
+declare const _default: import("../tool.js").Tool<z.ZodObject<Readonly<{
+    [k: string]: z.core.$ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+}>, z.core.$strip>>[];
+export default _default;
+//# sourceMappingURL=navigate.d.ts.map

package/dist/mcp/tools/navigate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigate.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/navigate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;;;;AA6ExB,wBAA2C"}

package/dist/mcp/tools/navigate.js

@@ -0,0 +1,74 @@
+import { z } from "zod";
+import { defineTool, textResult } from "../tool.js";
+import { formatSnapshot } from "../format.js";
+const navigate = defineTool({
+    schema: {
+        name: "browser_navigate",
+        title: "Navigate to a URL",
+        description: "Navigate to a URL",
+        inputSchema: z.object({
+            url: z.string().describe("The URL to navigate to")
+        })
+    },
+    handle: async (args, runtime) => {
+        const snap = await runtime.navigate(args.url);
+        if (!snap)
+            return textResult(`Navigated to "${args.url}".`);
+        return textResult(formatSnapshot(snap));
+    }
+});
+const goBack = defineTool({
+    schema: {
+        name: "browser_navigate_back",
+        title: "Go back",
+        description: "Go back to the previous page in the history",
+        inputSchema: z.object({})
+    },
+    handle: async (_args, runtime) => {
+        const snap = await runtime.goBack();
+        if (!snap)
+            return textResult("Navigated back.");
+        return textResult(formatSnapshot(snap));
+    }
+});
+const goForward = defineTool({
+    schema: {
+        name: "browser_navigate_forward",
+        title: "Go forward",
+        description: "Go forward to the next page in the history",
+        inputSchema: z.object({})
+    },
+    handle: async (_args, runtime) => {
+        const snap = await runtime.goForward();
+        if (!snap)
+            return textResult("Navigated forward.");
+        return textResult(formatSnapshot(snap));
+    }
+});
+const waitFor = defineTool({
+    schema: {
+        name: "browser_wait_for",
+        title: "Wait for",
+        description: "Wait for text to appear or disappear or a specified time to pass",
+        inputSchema: z.object({
+            time: z.number().optional().describe("The time to wait in seconds"),
+            text: z.string().optional().describe("The text to wait for"),
+            textGone: z.string().optional().describe("The text to wait for to disappear")
+        })
+    },
+    handle: async (args, runtime) => {
+        if (!args.text && !args.textGone && !args.time) {
+            throw new Error("Either time, text or textGone must be provided");
+        }
+        if (args.time) {
+            await new Promise((resolve) => setTimeout(resolve, Math.min(30_000, args.time * 1000)));
+        }
+        const snap = await runtime.waitFor({
+            ...(args.text !== undefined ? { text: args.text } : {}),
+            ...(args.textGone !== undefined ? { textGone: args.textGone } : {})
+        }, 5000);
+        return textResult(formatSnapshot(snap));
+    }
+});
+export default [navigate, goBack, waitFor];
+//# sourceMappingURL=navigate.js.map

package/dist/mcp/tools/navigate.js.map

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

package/dist/mcp/tools/network.d.ts

@@ -0,0 +1,6 @@
+import { z } from "zod";
+declare const _default: import("../tool.js").Tool<z.ZodObject<Readonly<{
+    [k: string]: z.core.$ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+}>, z.core.$strip>>[];
+export default _default;
+//# sourceMappingURL=network.d.ts.map

package/dist/mcp/tools/network.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/network.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;;;;AAiJxB,wBAAiD"}

package/dist/mcp/tools/network.js

@@ -0,0 +1,142 @@
+import { writeFile } from "node:fs/promises";
+import { z } from "zod";
+import { defineTool, textResult } from "../tool.js";
+import { resolveOutputFilePath } from "../output.js";
+const requestParts = ["request-headers", "request-body", "response-headers", "response-body"];
+const networkRequests = defineTool({
+    schema: {
+        name: "browser_network_requests",
+        title: "List network requests",
+        description: "Returns a numbered list of network requests since loading the page. Use browser_network_request with the number to get full details.",
+        inputSchema: z.object({
+            static: z.boolean().default(false).describe("Whether to include successful static resources like images, fonts, scripts, etc. Defaults to false."),
+            filter: z.string().optional().describe('Only return requests whose URL matches this regexp (e.g. "/api/.*user").'),
+            filename: z.string().optional().describe("Filename to save the network requests to. If not provided, requests are returned as text.")
+        })
+    },
+    handle: async (args, runtime) => {
+        const requests = await runtime.networkRequests();
+        const filter = args.filter ? new RegExp(args.filter) : undefined;
+        const lines = [];
+        let hiddenStaticCount = 0;
+        for (const request of requests) {
+            if (!args.static && !isFetch(request) && isSuccessfulResponse(request)) {
+                hiddenStaticCount++;
+                continue;
+            }
+            if (filter && !filter.test(request.url)) {
+                continue;
+            }
+            lines.push(`${request.index}. ${renderRequestLine(request)}`);
+        }
+        if (hiddenStaticCount > 0) {
+            lines.push(`\nNote: ${hiddenStaticCount} static request${hiddenStaticCount === 1 ? "" : "s"} not shown, run with "static" option to see ${hiddenStaticCount === 1 ? "it" : "them"}.`);
+        }
+        const text = lines.join("\n");
+        if (args.filename) {
+            const resolvedFilename = await resolveOutputFilePath(args.filename, {
+                outputDir: runtime.getOutputDir()
+            });
+            await writeFile(resolvedFilename, text);
+            return textResult(`Saved network requests to "${resolvedFilename}".`);
+        }
+        return textResult(text);
+    }
+});
+const networkRequest = defineTool({
+    schema: {
+        name: "browser_network_request",
+        title: "Show network request details",
+        description: "Returns full details (headers and body) of a single network request, or a single part if part is set. Use the number from browser_network_requests.",
+        inputSchema: z.object({
+            index: z.number().int().min(1).describe("1-based index of the request, as printed by browser_network_requests."),
+            part: z.enum(requestParts).optional().describe("Return only this part of the request. Omit to return full details."),
+            filename: z.string().optional().describe("Filename to save the result to. If not provided, output is returned as text.")
+        })
+    },
+    handle: async (args, runtime) => {
+        const request = await runtime.networkRequest(args.index);
+        if (!request) {
+            return textResult(`Request #${args.index} not found. Use browser_network_requests to see available indexes.`, true);
+        }
+        const text = args.part ? renderRequestPart(request, args.part) : renderRequestDetails(request);
+        if (args.filename) {
+            const resolvedFilename = await resolveOutputFilePath(args.filename, {
+                outputDir: runtime.getOutputDir()
+            });
+            await writeFile(resolvedFilename, text);
+            return textResult(`Saved network request to "${resolvedFilename}".`);
+        }
+        return textResult(text);
+    }
+});
+function isSuccessfulResponse(request) {
+    return !request.failureText && request.status !== undefined && request.status < 400;
+}
+function isFetch(request) {
+    return request.resourceType === "fetch" || request.resourceType === "xhr";
+}
+function renderRequestLine(request) {
+    let line = `[${request.method.toUpperCase()}] ${request.url}`;
+    if (request.status !== undefined) {
+        line += ` => [${request.status}] ${request.statusText ?? ""}`.trimEnd();
+    }
+    else if (request.failureText) {
+        line += ` => [FAILED] ${request.failureText}`;
+    }
+    return line;
+}
+function renderRequestDetails(request) {
+    const lines = [];
+    lines.push(`#${request.index} [${request.method.toUpperCase()}] ${request.url}`);
+    lines.push("");
+    lines.push("  General");
+    if (request.status !== undefined) {
+        lines.push(`    status:    [${request.status}] ${request.statusText ?? ""}`.trimEnd());
+    }
+    else if (request.failureText) {
+        lines.push(`    status:    [FAILED] ${request.failureText}`);
+    }
+    if (request.durationMs !== undefined) {
+        lines.push(`    duration:  ${request.durationMs}ms`);
+    }
+    lines.push(`    type:      ${request.resourceType}`);
+    if (request.mimeType) {
+        lines.push(`    mimeType:  ${request.mimeType}`);
+    }
+    appendHeaders(lines, "Request headers", request.requestHeaders);
+    if (request.responseHeaders) {
+        appendHeaders(lines, "Response headers", request.responseHeaders);
+    }
+    if (request.requestBody) {
+        lines.push("", `Call browser_network_request with part="request-body" to read the request body.`);
+    }
+    if (request.responseBody) {
+        lines.push("", `Call browser_network_request with part="response-body" to read the response body.`);
+    }
+    return lines.join("\n");
+}
+function renderRequestPart(request, part) {
+    if (part === "request-headers")
+        return renderHeaders(request.requestHeaders);
+    if (part === "request-body")
+        return request.requestBody ?? "";
+    if (part === "response-headers")
+        return renderHeaders(request.responseHeaders ?? {});
+    return request.responseBody ?? "";
+}
+function appendHeaders(lines, title, headers) {
+    const entries = Object.entries(headers);
+    if (!entries.length)
+        return;
+    lines.push("");
+    lines.push(`  ${title}`);
+    for (const [key, value] of entries) {
+        lines.push(`    ${key}: ${value}`);
+    }
+}
+function renderHeaders(headers) {
+    return Object.entries(headers).map(([key, value]) => `${key}: ${value}`).join("\n");
+}
+export default [networkRequests, networkRequest];
+//# sourceMappingURL=network.js.map

package/dist/mcp/tools/network.js.map

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

package/dist/mcp/tools/runCode.d.ts

@@ -0,0 +1,6 @@
+import { z } from "zod";
+declare const _default: import("../tool.js").Tool<z.ZodObject<Readonly<{
+    [k: string]: z.core.$ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+}>, z.core.$strip>>[];
+export default _default;
+//# sourceMappingURL=runCode.d.ts.map

package/dist/mcp/tools/runCode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runCode.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/runCode.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;;;;AAuBxB,wBAAyB"}

package/dist/mcp/tools/runCode.js

@@ -0,0 +1,24 @@
+import { readFile } from "node:fs/promises";
+import { z } from "zod";
+import { defineTool, textResult } from "../tool.js";
+const runCode = defineTool({
+    schema: {
+        name: "browser_run_code_unsafe",
+        title: "Run Playwright code (unsafe)",
+        description: "Run a Playwright code snippet. Unsafe: executes arbitrary JavaScript in the browser context approximation and is RCE-equivalent in intent.",
+        inputSchema: z.object({
+            code: z.string().optional().describe("A JavaScript function containing Playwright-like code to execute."),
+            filename: z.string().optional().describe("Load code from the specified file. If both code and filename are provided, code will be ignored.")
+        })
+    },
+    handle: async (args, runtime) => {
+        const code = args.filename ? await readFile(args.filename, "utf8") : args.code;
+        if (!code) {
+            throw new Error("Either code or filename must be provided.");
+        }
+        const result = await runtime.runCodeUnsafe(code);
+        return textResult(JSON.stringify(result, null, 2) ?? "undefined");
+    }
+});
+export default [runCode];
+//# sourceMappingURL=runCode.js.map

package/dist/mcp/tools/runCode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runCode.js","sourceRoot":"","sources":["../../../src/mcp/tools/runCode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEpD,MAAM,OAAO,GAAG,UAAU,CAAC;IACzB,MAAM,EAAE;QACN,IAAI,EAAE,yBAAyB;QAC/B,KAAK,EAAE,8BAA8B;QACrC,WAAW,EAAE,4IAA4I;QACzJ,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mEAAmE,CAAC;YACzG,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kGAAkG,CAAC;SAC7I,CAAC;KACH;IACD,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;QAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAC/E,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAC/D,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QACjD,OAAO,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,WAAW,CAAC,CAAC;IACpE,CAAC;CACF,CAAC,CAAC;AAEH,eAAe,CAAC,OAAO,CAAC,CAAC"}

package/dist/mcp/tools/screenshot.d.ts

@@ -0,0 +1,6 @@
+import { z } from "zod";
+declare const _default: import("../tool.js").Tool<z.ZodObject<Readonly<{
+    [k: string]: z.core.$ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+}>, z.core.$strip>>[];
+export default _default;
+//# sourceMappingURL=screenshot.d.ts.map

package/dist/mcp/tools/screenshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshot.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/screenshot.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;;;;AAsDxB,wBAAgC"}

package/dist/mcp/tools/screenshot.js

@@ -0,0 +1,46 @@
+import { writeFile } from "node:fs/promises";
+import { z } from "zod";
+import { defineTool, textResult } from "../tool.js";
+import { resolveOutputFilePath } from "../output.js";
+const takeScreenshot = defineTool({
+    schema: {
+        name: "browser_take_screenshot",
+        title: "Browser Take Screenshot",
+        description: "Capture a full-page screenshot of the active tab as a base64-encoded PNG.",
+        inputSchema: z.object({
+            element: z.string().optional().describe("Human-readable description of the area to screenshot"),
+            target: z.string().optional().describe("Element reference or CSS selector to clip screenshot to; omit for full page"),
+            type: z.enum(["png", "jpeg"]).default("png").describe("Image format for the screenshot. Default is png."),
+            filename: z.string().optional().describe("File name to save the screenshot to."),
+            fullPage: z.boolean().optional().describe("When true, takes a screenshot of the full scrollable page, instead of the currently visible viewport. Cannot be used with element screenshots.")
+        })
+    },
+    handle: async (args, runtime) => {
+        const target = args.target;
+        const fileType = args.type;
+        const result = await runtime.takeScreenshot({
+            type: fileType,
+            ...(args.fullPage !== undefined ? { fullPage: args.fullPage } : {}),
+            ...(target !== undefined ? { target } : {})
+        });
+        const requestedFilename = args.filename?.trim();
+        const resolvedFilename = await resolveOutputFilePath(requestedFilename || createDefaultScreenshotFilename(fileType), {
+            outputDir: runtime.getOutputDir()
+        });
+        await writeFile(resolvedFilename, Buffer.from(result.data, "base64"));
+        if (requestedFilename) {
+            return textResult(`Screenshot saved to "${resolvedFilename}".`);
+        }
+        return {
+            content: [
+                { type: "text", text: resolvedFilename },
+                { type: "image", data: result.data, mimeType: result.mimeType }
+            ]
+        };
+    }
+});
+function createDefaultScreenshotFilename(type) {
+    return `page-${new Date().toISOString().replaceAll(":", "-")}.${type}`;
+}
+export default [takeScreenshot];
+//# sourceMappingURL=screenshot.js.map

package/dist/mcp/tools/screenshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshot.js","sourceRoot":"","sources":["../../../src/mcp/tools/screenshot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAErD,MAAM,cAAc,GAAG,UAAU,CAAC;IAChC,MAAM,EAAE;QACN,IAAI,EAAE,yBAAyB;QAC/B,KAAK,EAAE,yBAAyB;QAChC,WAAW,EAAE,2EAA2E;QACxF,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CACrC,sDAAsD,CACvD;YACD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CACpC,6EAA6E,CAC9E;YACD,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,kDAAkD,CAAC;YACzG,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;YAChF,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gJAAgJ,CAAC;SAC5L,CAAC;KACH;IACD,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;QAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC;QAC3B,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC;YAC1C,IAAI,EAAE,QAAQ;YACd,GAAG,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnE,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC5C,CAAC,CAAC;QACH,MAAM,iBAAiB,GAAG,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;QAChD,MAAM,gBAAgB,GAAG,MAAM,qBAAqB,CAClD,iBAAiB,IAAI,+BAA+B,CAAC,QAAQ,CAAC,EAC9D;YACE,SAAS,EAAE,OAAO,CAAC,YAAY,EAAE;SAClC,CACF,CAAC;QACF,MAAM,SAAS,CAAC,gBAAgB,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;QAEtE,IAAI,iBAAiB,EAAE,CAAC;YACtB,OAAO,UAAU,CAAC,wBAAwB,gBAAgB,IAAI,CAAC,CAAC;QAClE,CAAC;QACD,OAAO;YACL,OAAO,EAAE;gBACP,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,EAAE;gBACxC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE;aAChE;SACF,CAAC;IACJ,CAAC;CACF,CAAC,CAAC;AAEH,SAAS,+BAA+B,CAAC,IAAoB;IAC3D,OAAO,QAAQ,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;AACzE,CAAC;AAED,eAAe,CAAC,cAAc,CAAC,CAAC"}

package/dist/mcp/tools/snapshot.d.ts

@@ -0,0 +1,6 @@
+import { z } from "zod";
+declare const _default: import("../tool.js").Tool<z.ZodObject<Readonly<{
+    [k: string]: z.core.$ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+}>, z.core.$strip>>[];
+export default _default;
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/mcp/tools/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/snapshot.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;;;;AAuDxB,wBAA0B"}

package/dist/mcp/tools/snapshot.js

@@ -0,0 +1,56 @@
+import { writeFile } from "node:fs/promises";
+import { z } from "zod";
+import { defineTool, textResult } from "../tool.js";
+import { formatSnapshot, formatTabs } from "../format.js";
+import { resolveOutputFilePath } from "../output.js";
+const snapshot = defineTool({
+    schema: {
+        name: "browser_snapshot",
+        title: "Browser Snapshot",
+        description: "Return a Playwright-style accessibility and DOM snapshot for the active tab.",
+        inputSchema: z.object({
+            target: z.string().optional(),
+            filename: z.string().optional(),
+            depth: z.number().optional(),
+            boxes: z.boolean().optional()
+        }).strict(),
+        listedInputSchema: {
+            $schema: "https://json-schema.org/draft/2020-12/schema",
+            type: "object",
+            properties: {
+                target: {
+                    type: "string",
+                    description: "Exact target element reference from the page snapshot, or a unique element selector"
+                },
+                filename: {
+                    type: "string",
+                    description: "Save snapshot to markdown file instead of returning it in the response."
+                },
+                depth: {
+                    type: "number",
+                    description: "Limit the depth of the snapshot tree"
+                },
+                boxes: {
+                    type: "boolean",
+                    description: "Include each element's bounding box as [box=x,y,width,height] in the snapshot. Coordinates are viewport-relative, in CSS pixels (Element.getBoundingClientRect)"
+                }
+            },
+            additionalProperties: false
+        }
+    },
+    handle: async (args, runtime) => {
+        const snap = await runtime.snapshot(args);
+        if (args.filename) {
+            const resolvedFilename = await resolveOutputFilePath(args.filename, {
+                outputDir: runtime.getOutputDir()
+            });
+            await writeFile(resolvedFilename, snap.text);
+            return textResult(`Saved snapshot to "${resolvedFilename}".`);
+        }
+        const tabs = await runtime.listTabs();
+        const prefix = tabs.length > 1 ? `${formatTabs(tabs)}\n` : "";
+        return textResult(`${prefix}${formatSnapshot(snap)}`);
+    }
+});
+export default [snapshot];
+//# sourceMappingURL=snapshot.js.map

package/dist/mcp/tools/snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../../../src/mcp/tools/snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAErD,MAAM,QAAQ,GAAG,UAAU,CAAC;IAC1B,MAAM,EAAE;QACN,IAAI,EAAE,kBAAkB;QACxB,KAAK,EAAE,kBAAkB;QACzB,WAAW,EAAE,8EAA8E;QAC3F,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC7B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC/B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC5B,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;SAC9B,CAAC,CAAC,MAAM,EAAE;QACX,iBAAiB,EAAE;YACjB,OAAO,EAAE,8CAA8C;YACvD,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,qFAAqF;iBACnG;gBACD,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,yEAAyE;iBACvF;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,sCAAsC;iBACpD;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,iKAAiK;iBAC/K;aACF;YACD,oBAAoB,EAAE,KAAK;SAC5B;KACF;IACD,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;QAC9B,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,MAAM,gBAAgB,GAAG,MAAM,qBAAqB,CAAC,IAAI,CAAC,QAAQ,EAAE;gBAClE,SAAS,EAAE,OAAO,CAAC,YAAY,EAAE;aAClC,CAAC,CAAC;YACH,MAAM,SAAS,CAAC,gBAAgB,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAC7C,OAAO,UAAU,CAAC,sBAAsB,gBAAgB,IAAI,CAAC,CAAC;QAChE,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAC;QACtC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9D,OAAO,UAAU,CAAC,GAAG,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACxD,CAAC;CACF,CAAC,CAAC;AAEH,eAAe,CAAC,QAAQ,CAAC,CAAC"}

package/dist/mcp/tools/tabs.d.ts

@@ -0,0 +1,6 @@
+import { z } from "zod";
+declare const _default: import("../tool.js").Tool<z.ZodObject<Readonly<{
+    [k: string]: z.core.$ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+}>, z.core.$strip>>[];
+export default _default;
+//# sourceMappingURL=tabs.d.ts.map

package/dist/mcp/tools/tabs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tabs.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/tabs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;;;;AAqCxB,wBAAsB"}