@roxybrowser/playwright 2.0.2-beta.0

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

@@ -0,0 +1,70 @@
+import { z } from "zod";
+export declare const optionalElementSchema: z.ZodObject<{
+    element: z.ZodOptional<z.ZodString>;
+    target: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const elementSchema: z.ZodObject<{
+    element: z.ZodOptional<z.ZodString>;
+    target: z.ZodString;
+}, z.core.$strip>;
+export declare const snapshot: import("./tool.js").Tool<z.ZodObject<{
+    target: z.ZodOptional<z.ZodString>;
+    filename: z.ZodOptional<z.ZodString>;
+    depth: z.ZodOptional<z.ZodNumber>;
+    boxes: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>>;
+export declare const click: import("./tool.js").Tool<z.ZodObject<{
+    element: z.ZodOptional<z.ZodString>;
+    target: z.ZodString;
+    doubleClick: z.ZodOptional<z.ZodBoolean>;
+    button: z.ZodOptional<z.ZodEnum<{
+        left: "left";
+        right: "right";
+        middle: "middle";
+    }>>;
+    modifiers: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        Alt: "Alt";
+        Control: "Control";
+        ControlOrMeta: "ControlOrMeta";
+        Meta: "Meta";
+        Shift: "Shift";
+    }>>>;
+    human: z.ZodOptional<z.ZodObject<{
+        profile: z.ZodOptional<z.ZodEnum<{
+            cautious: "cautious";
+            balanced: "balanced";
+            fast: "fast";
+        }>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>>;
+export declare const drag: import("./tool.js").Tool<z.ZodObject<{
+    startElement: z.ZodOptional<z.ZodString>;
+    startTarget: z.ZodString;
+    endElement: z.ZodOptional<z.ZodString>;
+    endTarget: z.ZodString;
+}, z.core.$strip>>;
+export declare const hover: import("./tool.js").Tool<z.ZodObject<{
+    element: z.ZodOptional<z.ZodString>;
+    target: z.ZodString;
+}, z.core.$strip>>;
+export declare const selectOption: import("./tool.js").Tool<z.ZodObject<{
+    element: z.ZodOptional<z.ZodString>;
+    target: z.ZodString;
+    values: z.ZodArray<z.ZodString>;
+}, z.core.$strip>>;
+declare const _default: (import("./tool.js").Tool<z.ZodObject<{
+    target: z.ZodOptional<z.ZodString>;
+    filename: z.ZodOptional<z.ZodString>;
+    depth: z.ZodOptional<z.ZodNumber>;
+    boxes: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>> | import("./tool.js").Tool<z.ZodObject<{
+    startElement: z.ZodOptional<z.ZodString>;
+    startTarget: z.ZodString;
+    endElement: z.ZodOptional<z.ZodString>;
+    endTarget: z.ZodString;
+}, z.core.$strip>> | import("./tool.js").Tool<z.ZodObject<{
+    element: z.ZodOptional<z.ZodString>;
+    target: z.ZodString;
+}, z.core.$strip>>)[];
+export default _default;
+//# sourceMappingURL=snapshot.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../../src/mcp/backend/snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,qBAAqB;;;iBAKhC,CAAC;AAEH,eAAO,MAAM,aAAa;;;iBAKxB,CAAC;AAiCH,eAAO,MAAM,QAAQ;;;;;mBA4CnB,CAAC;AAEH,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;kBAqChB,CAAC;AAEH,eAAO,MAAM,IAAI;;;;;kBAsCf,CAAC;AAEH,eAAO,MAAM,KAAK;;;kBAkBhB,CAAC;AAMH,eAAO,MAAM,YAAY;;;;kBAmBvB,CAAC;;;;;;;;;;;;;;;AAEH,wBAME"}

package/dist/mcp/backend/snapshot.js

@@ -0,0 +1,185 @@
+import { z } from "zod";
+import { defineTabTool } from "./tool.js";
+const elementTargetDescription = "Exact target element reference from the page snapshot, or a unique element selector";
+export const optionalElementSchema = z.object({
+    element: z.string().optional().describe("Human-readable element description used to obtain permission to interact with the element"),
+    target: z.string().optional().describe(elementTargetDescription)
+});
+export 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 clickSchema = 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")
+});
+function optionsCode(params, hasTimeout) {
+    const entries = [];
+    if (params.button !== undefined) {
+        entries.push(`button: ${JSON.stringify(params.button)}`);
+    }
+    if (params.modifiers !== undefined) {
+        entries.push(`modifiers: ${JSON.stringify(params.modifiers)}`);
+    }
+    if (hasTimeout) {
+        entries.push("timeout");
+    }
+    return entries.length ? `{ ${entries.join(", ")} }` : "";
+}
+export const snapshot = defineTabTool({
+    capability: "core",
+    schema: {
+        name: "browser_snapshot",
+        title: "Page snapshot",
+        description: "Capture accessibility snapshot of the current page, this is better than screenshot",
+        inputSchema: z.object({
+            target: z.string().optional().describe(elementTargetDescription),
+            filename: z.string().optional().describe("Save snapshot to markdown file instead of returning it in the response."),
+            depth: z.number().optional().describe("Limit the depth of the snapshot tree"),
+            boxes: z.boolean().optional().describe("Include each element's bounding box as [box=x,y,width,height] in the snapshot. Coordinates are viewport-relative, in CSS pixels (Element.getBoundingClientRect)")
+        }).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
+        },
+        type: "readOnly"
+    },
+    handle: async (tab, params, response) => {
+        if (params.target) {
+            await tab.targetLocator({ target: params.target });
+        }
+        response.setIncludeFullSnapshot(params.filename, params.target, params.depth, params.boxes);
+    }
+});
+export const click = defineTabTool({
+    capability: "core",
+    schema: {
+        name: "browser_click",
+        title: "Click",
+        description: "Perform click on a web page",
+        inputSchema: clickSchema,
+        type: "input"
+    },
+    handle: async (tab, params, response) => {
+        response.setIncludeSnapshot();
+        response.addTextResult(`Clicked "${params.element ?? params.target}".`);
+        const { locator, resolved } = await tab.targetLocator(params);
+        const options = {
+            ...(params.button !== undefined ? { button: params.button } : {}),
+            ...(params.modifiers !== undefined ? { modifiers: params.modifiers } : {}),
+            ...(params.human !== undefined ? { human: params.human } : {}),
+            ...tab.actionTimeoutOptions
+        };
+        const codeOptions = optionsCode(params, "timeout" in tab.actionTimeoutOptions);
+        if (params.doubleClick) {
+            response.addCode(`await page.${resolved}.dblclick(${codeOptions});`);
+        }
+        else {
+            response.addCode(`await page.${resolved}.click(${codeOptions});`);
+        }
+        await tab.waitForCompletion(async () => {
+            if (params.doubleClick) {
+                await locator.dblclick(options);
+            }
+            else {
+                await locator.click(options);
+            }
+        });
+    }
+});
+export const drag = defineTabTool({
+    capability: "core",
+    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(elementTargetDescription),
+            endElement: z.string().optional().describe("Human-readable target element description used to obtain the permission to interact with the element"),
+            endTarget: z.string().describe(elementTargetDescription)
+        }),
+        type: "input"
+    },
+    handle: async (tab, params, response) => {
+        response.setIncludeSnapshot();
+        response.addTextResult(`Dragged "${params.startElement ?? params.startTarget}" to "${params.endElement ?? params.endTarget}".`);
+        const locators = await tab.targetLocators([
+            { target: params.startTarget, element: params.startElement },
+            { target: params.endTarget, element: params.endElement }
+        ]);
+        const start = locators[0];
+        const end = locators[1];
+        await tab.waitForCompletion(async () => {
+            await start.locator.dragTo(end.locator, tab.actionTimeoutOptions);
+        });
+        response.addCode(`await page.${start.resolved}.dragTo(page.${end.resolved});`);
+    }
+});
+export const hover = defineTabTool({
+    capability: "core",
+    schema: {
+        name: "browser_hover",
+        title: "Hover mouse",
+        description: "Hover over element on page",
+        inputSchema: elementSchema,
+        type: "input"
+    },
+    handle: async (tab, params, response) => {
+        response.setIncludeSnapshot();
+        const { locator, resolved } = await tab.targetLocator(params);
+        response.addCode(`await page.${resolved}.hover();`);
+        await locator.hover(tab.actionTimeoutOptions);
+    }
+});
+const selectOptionSchema = elementSchema.extend({
+    values: z.array(z.string()).describe("Option values or visible labels to select")
+});
+export const selectOption = defineTabTool({
+    capability: "core",
+    schema: {
+        name: "browser_select_option",
+        title: "Select option",
+        description: "Select an option in a dropdown",
+        inputSchema: selectOptionSchema,
+        type: "input"
+    },
+    handle: async (tab, params, response) => {
+        response.setIncludeSnapshot();
+        const { locator, resolved } = await tab.targetLocator(params);
+        response.addCode(`await page.${resolved}.selectOption(${JSON.stringify(params.values)});`);
+        const selected = await locator.selectOption(params.values, tab.actionTimeoutOptions);
+        response.addTextResult(`Selected options: ${selected.join(", ")}`);
+    }
+});
+export default [
+    snapshot,
+    click,
+    drag,
+    hover,
+    selectOption
+];
+//# sourceMappingURL=snapshot.js.map

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

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

package/dist/mcp/backend/tab.d.ts

@@ -0,0 +1,72 @@
+import type { McpRuntime } from "../runtime.js";
+import type { Context } from "./context.js";
+import type { ModalState } from "./tool.js";
+type TargetParams = {
+    element?: string | undefined;
+    target: string;
+};
+type HumanOptions = {
+    profile?: "cautious" | "balanced" | "fast" | undefined;
+};
+declare class Locator {
+    private readonly runtime;
+    private readonly target;
+    constructor(runtime: McpRuntime, target: string);
+    click(options?: {
+        button?: "left" | "right" | "middle";
+        modifiers?: Array<"Alt" | "Control" | "ControlOrMeta" | "Meta" | "Shift">;
+        human?: HumanOptions;
+    }): Promise<void>;
+    dblclick(options?: {
+        button?: "left" | "right" | "middle";
+        modifiers?: Array<"Alt" | "Control" | "ControlOrMeta" | "Meta" | "Shift">;
+        human?: HumanOptions;
+    }): Promise<void>;
+    hover(_options?: {
+        timeout?: number;
+    }): Promise<void>;
+    selectOption(values: string[], _options?: {
+        timeout?: number;
+    }): Promise<string[]>;
+    dragTo(target: Locator, _options?: {
+        timeout?: number;
+    }): Promise<void>;
+    fill(value: string, _options?: {
+        timeout?: number;
+    }): Promise<void>;
+    pressSequentially(value: string, _options?: {
+        timeout?: number;
+    }): Promise<void>;
+    type(value: string, options?: {
+        submit?: boolean;
+        slowly?: boolean;
+        timeout?: number;
+    }): Promise<void>;
+}
+export declare class Tab {
+    readonly context: Context;
+    readonly actionTimeoutOptions: {
+        timeout?: number;
+    };
+    readonly navigationTimeoutOptions: {
+        timeout?: number;
+    };
+    readonly expectTimeoutOptions: {
+        timeout?: number;
+    };
+    constructor(context: Context);
+    modalStates(): ModalState[];
+    waitForCompletion<T>(callback: () => Promise<T>): Promise<T>;
+    targetLocator(params: TargetParams): Promise<{
+        locator: Locator;
+        resolved: string;
+    }>;
+    targetLocators(params: TargetParams[]): Promise<Array<{
+        locator: Locator;
+        resolved: string;
+    }>>;
+    pressKey(key: string, modifiers?: Array<"Alt" | "Control" | "ControlOrMeta" | "Meta" | "Shift">): Promise<void>;
+    uploadFile(paths: string[]): Promise<void>;
+}
+export {};
+//# sourceMappingURL=tab.d.ts.map

package/dist/mcp/backend/tab.d.ts.map

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

package/dist/mcp/backend/tab.js

@@ -0,0 +1,99 @@
+class Locator {
+    runtime;
+    target;
+    constructor(runtime, target) {
+        this.runtime = runtime;
+        this.target = target;
+    }
+    async click(options) {
+        await this.runtime.click(this.target, {
+            ...(options?.button !== undefined ? { button: options.button } : {}),
+            ...(options?.modifiers !== undefined ? { modifiers: options.modifiers } : {}),
+            ...(options?.human?.profile !== undefined ? { human: { profile: options.human.profile } } : {})
+        });
+    }
+    async dblclick(options) {
+        await this.runtime.click(this.target, {
+            ...(options?.button !== undefined ? { button: options.button } : {}),
+            ...(options?.modifiers !== undefined ? { modifiers: options.modifiers } : {}),
+            ...(options?.human?.profile !== undefined ? { human: { profile: options.human.profile } } : {}),
+            doubleClick: true
+        });
+    }
+    async hover(_options) {
+        await this.runtime.hover(this.target);
+    }
+    async selectOption(values, _options) {
+        const result = await this.runtime.selectOption(this.target, values);
+        return result.selected;
+    }
+    async dragTo(target, _options) {
+        await this.runtime.drag(this.target, target.target);
+    }
+    async fill(value, _options) {
+        await this.runtime.type(this.target, value);
+    }
+    async pressSequentially(value, _options) {
+        await this.runtime.type(this.target, value, { slowly: true });
+    }
+    async type(value, options) {
+        await this.runtime.type(this.target, value, {
+            ...(options?.submit !== undefined ? { submit: options.submit } : {}),
+            ...(options?.slowly !== undefined ? { slowly: options.slowly } : {})
+        });
+    }
+}
+function resolvedLocator(target, resolved) {
+    if ("selector" in resolved) {
+        return `locator(${JSON.stringify(resolved.selector)})`;
+    }
+    return `locator(${JSON.stringify(`aria-ref=${target}`)})`;
+}
+export class Tab {
+    context;
+    actionTimeoutOptions;
+    navigationTimeoutOptions;
+    expectTimeoutOptions;
+    constructor(context) {
+        this.context = context;
+        this.actionTimeoutOptions = context.config.timeouts?.action !== undefined
+            ? { timeout: context.config.timeouts.action }
+            : {};
+        this.navigationTimeoutOptions = context.config.timeouts?.navigation !== undefined
+            ? { timeout: context.config.timeouts.navigation }
+            : {};
+        this.expectTimeoutOptions = context.config.timeouts?.expect !== undefined
+            ? { timeout: context.config.timeouts.expect }
+            : {};
+    }
+    modalStates() {
+        if (!this.context.runtime.hasPendingFileUploadTarget()) {
+            return [];
+        }
+        return [{
+                type: "fileChooser",
+                description: "File chooser",
+                clearedBy: { tool: "browser_file_upload", skill: "upload" }
+            }];
+    }
+    async waitForCompletion(callback) {
+        return callback();
+    }
+    async targetLocator(params) {
+        const target = this.context.runtime.resolveTarget(params.target);
+        return {
+            locator: new Locator(this.context.runtime, params.target),
+            resolved: resolvedLocator(params.target, target)
+        };
+    }
+    async targetLocators(params) {
+        return Promise.all(params.map((param) => this.targetLocator(param)));
+    }
+    async pressKey(key, modifiers) {
+        await this.context.runtime.pressKey(key, modifiers);
+    }
+    async uploadFile(paths) {
+        await this.context.runtime.uploadFile(paths);
+    }
+}
+//# sourceMappingURL=tab.js.map

package/dist/mcp/backend/tab.js.map

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

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

@@ -0,0 +1,13 @@
+import { z } from "zod";
+declare const _default: import("./tool.js").Tool<z.ZodObject<{
+    action: z.ZodEnum<{
+        close: "close";
+        select: "select";
+        list: "list";
+        new: "new";
+    }>;
+    index: z.ZodOptional<z.ZodNumber>;
+    url: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>[];
+export default _default;
+//# sourceMappingURL=tabs.d.ts.map

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

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

package/dist/mcp/backend/tabs.js

@@ -0,0 +1,44 @@
+import { z } from "zod";
+import { defineTool } from "./tool.js";
+import { formatTabs } from "../format.js";
+const tabs = defineTool({
+    capability: "core-tabs",
+    schema: {
+        name: "browser_tabs",
+        title: "Browser Tabs",
+        description: "List, create, select, and close browser tabs for the current MCP browser session.",
+        inputSchema: z.object({
+            action: z.enum(["list", "new", "select", "close"]).describe("Operation to perform"),
+            index: z.number().optional().describe("Tab index, used for close/select. If omitted for close, current tab is closed."),
+            url: z.string().optional().describe("URL to navigate to in the new tab, used for new.")
+        }),
+        type: "action"
+    },
+    handle: async (context, params, response) => {
+        switch (params.action) {
+            case "list":
+                await context.ensureTab();
+                break;
+            case "new":
+                await context.runtime.newTab(params.url);
+                if (params.url) {
+                    response.setIncludeSnapshot();
+                    response.addCode(`await page.goto('${params.url}');`);
+                }
+                break;
+            case "close":
+                await context.runtime.closeTab(params.index ?? 0);
+                break;
+            case "select":
+                if (params.index === undefined) {
+                    throw new Error("Tab index is required");
+                }
+                await context.runtime.selectTab(params.index);
+                break;
+        }
+        const tabs = await context.runtime.listTabs();
+        response.addTextResult(formatTabs(tabs));
+    }
+});
+export default [tabs];
+//# sourceMappingURL=tabs.js.map

package/dist/mcp/backend/tabs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tabs.js","sourceRoot":"","sources":["../../../src/mcp/backend/tabs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,MAAM,IAAI,GAAG,UAAU,CAAC;IACtB,UAAU,EAAE,WAAW;IACvB,MAAM,EAAE;QACN,IAAI,EAAE,cAAc;QACpB,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE,mFAAmF;QAChG,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,sBAAsB,CAAC;YACnF,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gFAAgF,CAAC;YACvH,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;SACxF,CAAC;QACF,IAAI,EAAE,QAAQ;KACf;IACD,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE;QAC1C,QAAQ,MAAM,CAAC,MAAM,EAAE,CAAC;YACtB,KAAK,MAAM;gBACT,MAAM,OAAO,CAAC,SAAS,EAAE,CAAC;gBAC1B,MAAM;YACR,KAAK,KAAK;gBACR,MAAM,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACzC,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC;oBACf,QAAQ,CAAC,kBAAkB,EAAE,CAAC;oBAC9B,QAAQ,CAAC,OAAO,CAAC,oBAAoB,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC;gBACxD,CAAC;gBACD,MAAM;YACR,KAAK,OAAO;gBACV,MAAM,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC;gBAClD,MAAM;YACR,KAAK,QAAQ;gBACX,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;oBAC/B,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;gBAC3C,CAAC;gBACD,MAAM,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBAC9C,MAAM;QACV,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QAC9C,QAAQ,CAAC,aAAa,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3C,CAAC;CACF,CAAC,CAAC;AAEH,eAAe,CAAC,IAAI,CAAC,CAAC"}

package/dist/mcp/backend/tool.d.ts

@@ -0,0 +1,52 @@
+import type { z } from "zod";
+import type { CallToolResult, Tool as McpToolDefinition } from "@modelcontextprotocol/sdk/types.js";
+import type { Context } from "./context.js";
+import type { Tab } from "./tab.js";
+import type { Response } from "./response.js";
+type AnyZodObject = z.ZodObject<z.ZodRawShape>;
+type ToolSchema<Input extends AnyZodObject> = {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: Input;
+    listedInputSchema?: McpToolDefinition["inputSchema"];
+    type: "input" | "assertion" | "action" | "readOnly";
+};
+export type ToolCapability = "config" | "core" | "core-navigation" | "core-tabs" | "core-input" | "core-install" | "network" | "pdf" | "storage" | "testing" | "vision" | "devtools";
+export type FileUploadModalState = {
+    type: "fileChooser";
+    description: string;
+    clearedBy: {
+        tool: string;
+        skill: string;
+    };
+};
+export type DialogModalState = {
+    type: "dialog";
+    description: string;
+    clearedBy: {
+        tool: string;
+        skill: string;
+    };
+};
+export type ModalState = FileUploadModalState | DialogModalState;
+export type Tool<Input extends AnyZodObject = AnyZodObject> = {
+    capability: ToolCapability;
+    skillOnly?: boolean;
+    schema: ToolSchema<Input>;
+    handle: (context: Context, params: z.output<Input>, response: Response, signal?: AbortSignal) => Promise<void>;
+};
+export declare function defineTool<Input extends AnyZodObject>(tool: Tool<Input>): Tool<Input>;
+export type TabTool<Input extends AnyZodObject = AnyZodObject> = {
+    capability: ToolCapability;
+    skillOnly?: boolean;
+    schema: ToolSchema<Input>;
+    clearsModalState?: ModalState["type"];
+    handle: (tab: Tab, params: z.output<Input>, response: Response, signal?: AbortSignal) => Promise<void>;
+};
+export declare function defineTabTool<Input extends AnyZodObject>(tool: TabTool<Input>): Tool<Input>;
+export type SerializedToolResult = CallToolResult & {
+    isClose?: boolean;
+};
+export {};
+//# sourceMappingURL=tool.d.ts.map

package/dist/mcp/backend/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../../src/mcp/backend/tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,cAAc,EAAE,IAAI,IAAI,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACpG,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,KAAK,YAAY,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;AAE/C,KAAK,UAAU,CAAC,KAAK,SAAS,YAAY,IAAI;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,KAAK,CAAC;IACnB,iBAAiB,CAAC,EAAE,iBAAiB,CAAC,aAAa,CAAC,CAAC;IACrD,IAAI,EAAE,OAAO,GAAG,WAAW,GAAG,QAAQ,GAAG,UAAU,CAAC;CACrD,CAAC;AAEF,MAAM,MAAM,cAAc,GACtB,QAAQ,GACR,MAAM,GACN,iBAAiB,GACjB,WAAW,GACX,YAAY,GACZ,cAAc,GACd,SAAS,GACT,KAAK,GACL,SAAS,GACT,SAAS,GACT,QAAQ,GACR,UAAU,CAAC;AAEf,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,aAAa,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5C,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,QAAQ,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5C,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,oBAAoB,GAAG,gBAAgB,CAAC;AAEjE,MAAM,MAAM,IAAI,CAAC,KAAK,SAAS,YAAY,GAAG,YAAY,IAAI;IAC5D,UAAU,EAAE,cAAc,CAAC;IAC3B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;IAC1B,MAAM,EAAE,CACN,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EACvB,QAAQ,EAAE,QAAQ,EAClB,MAAM,CAAC,EAAE,WAAW,KACjB,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB,CAAC;AAEF,wBAAgB,UAAU,CAAC,KAAK,SAAS,YAAY,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAErF;AAED,MAAM,MAAM,OAAO,CAAC,KAAK,SAAS,YAAY,GAAG,YAAY,IAAI;IAC/D,UAAU,EAAE,cAAc,CAAC;IAC3B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;IAC1B,gBAAgB,CAAC,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IACtC,MAAM,EAAE,CACN,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EACvB,QAAQ,EAAE,QAAQ,EAClB,MAAM,CAAC,EAAE,WAAW,KACjB,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB,CAAC;AAEF,wBAAgB,aAAa,CAAC,KAAK,SAAS,YAAY,EAAE,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAe3F;AASD,MAAM,MAAM,oBAAoB,GAAG,cAAc,GAAG;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC"}

package/dist/mcp/backend/tool.js

@@ -0,0 +1,28 @@
+export function defineTool(tool) {
+    return tool;
+}
+export function defineTabTool(tool) {
+    return {
+        ...tool,
+        handle: async (context, params, response, signal) => {
+            const tab = await context.ensureTab();
+            const modalStates = tab.modalStates().map((state) => state.type);
+            if (tool.clearsModalState && !modalStates.includes(tool.clearsModalState)) {
+                response.addError(missingModalStateMessage(tool));
+            }
+            else if (!tool.clearsModalState && modalStates.length) {
+                response.addError(`Error: Tool "${tool.schema.name}" does not handle the modal state.`);
+            }
+            else {
+                await tool.handle(tab, params, response, signal);
+            }
+        }
+    };
+}
+function missingModalStateMessage(tool) {
+    if (tool.clearsModalState === "fileChooser") {
+        return "[no_file_chooser] No file chooser visible.";
+    }
+    return `Error: The tool "${tool.schema.name}" can only be used when there is related modal state present.`;
+}
+//# sourceMappingURL=tool.js.map

package/dist/mcp/backend/tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../../src/mcp/backend/tool.ts"],"names":[],"mappings":"AAyDA,MAAM,UAAU,UAAU,CAA6B,IAAiB;IACtE,OAAO,IAAI,CAAC;AACd,CAAC;AAeD,MAAM,UAAU,aAAa,CAA6B,IAAoB;IAC5E,OAAO;QACL,GAAG,IAAI;QACP,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE;YAClD,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,SAAS,EAAE,CAAC;YACtC,MAAM,WAAW,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACjE,IAAI,IAAI,CAAC,gBAAgB,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC,EAAE,CAAC;gBAC1E,QAAQ,CAAC,QAAQ,CAAC,wBAAwB,CAAC,IAAI,CAAC,CAAC,CAAC;YACpD,CAAC;iBAAM,IAAI,CAAC,IAAI,CAAC,gBAAgB,IAAI,WAAW,CAAC,MAAM,EAAE,CAAC;gBACxD,QAAQ,CAAC,QAAQ,CAAC,gBAAgB,IAAI,CAAC,MAAM,CAAC,IAAI,oCAAoC,CAAC,CAAC;YAC1F,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;YACnD,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,wBAAwB,CAAC,IAA2B;IAC3D,IAAI,IAAI,CAAC,gBAAgB,KAAK,aAAa,EAAE,CAAC;QAC5C,OAAO,4CAA4C,CAAC;IACtD,CAAC;IACD,OAAO,oBAAoB,IAAI,CAAC,MAAM,CAAC,IAAI,+DAA+D,CAAC;AAC7G,CAAC"}

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

@@ -0,0 +1,4 @@
+import type { Tool } from "./tool.js";
+export declare const browserTools: Tool[];
+export default browserTools;
+//# sourceMappingURL=tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/mcp/backend/tools.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC,eAAO,MAAM,YAAY,EAAE,IAAI,EAc9B,CAAC;AAEF,eAAe,YAAY,CAAC"}