browser-autopilot 0.1.0

package/dist/agent/tools.d.ts

@@ -0,0 +1,414 @@
+/**
+ * Complete browser automation tools.
+ * Each tool maps to a CDP operation. Index-based element targeting.
+ */
+import { z } from "zod";
+import { CDPBrowser } from "../browser/cdp.js";
+export declare function createBrowserTools(browser: CDPBrowser, dataDir?: string): {
+    navigate: import("ai").Tool<z.ZodObject<{
+        url: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+    }, {
+        url: string;
+    }>, string> & {
+        execute: (args: {
+            url: string;
+        }, options: import("ai").ToolExecutionOptions) => PromiseLike<string>;
+    };
+    go_back: import("ai").Tool<z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>, string> & {
+        execute: (args: {}, options: import("ai").ToolExecutionOptions) => PromiseLike<string>;
+    };
+    reload: import("ai").Tool<z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>, string> & {
+        execute: (args: {}, options: import("ai").ToolExecutionOptions) => PromiseLike<string>;
+    };
+    search: import("ai").Tool<z.ZodObject<{
+        query: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        query: string;
+    }, {
+        query: string;
+    }>, string> & {
+        execute: (args: {
+            query: string;
+        }, options: import("ai").ToolExecutionOptions) => PromiseLike<string>;
+    };
+    click: import("ai").Tool<z.ZodObject<{
+        index: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        index: number;
+    }, {
+        index: number;
+    }>, string> & {
+        execute: (args: {
+            index: number;
+        }, options: import("ai").ToolExecutionOptions) => PromiseLike<string>;
+    };
+    click_at: import("ai").Tool<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        x: number;
+        y: number;
+    }, {
+        x: number;
+        y: number;
+    }>, string> & {
+        execute: (args: {
+            x: number;
+            y: number;
+        }, options: import("ai").ToolExecutionOptions) => PromiseLike<string>;
+    };
+    input: import("ai").Tool<z.ZodObject<{
+        index: z.ZodNumber;
+        text: z.ZodString;
+        clear: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        text: string;
+        index: number;
+        clear: boolean;
+    }, {
+        text: string;
+        index: number;
+        clear?: boolean | undefined;
+    }>, string> & {
+        execute: (args: {
+            text: string;
+            index: number;
+            clear: boolean;
+        }, options: import("ai").ToolExecutionOptions) => PromiseLike<string>;
+    };
+    send_keys: import("ai").Tool<z.ZodObject<{
+        keys: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        keys: string;
+    }, {
+        keys: string;
+    }>, string> & {
+        execute: (args: {
+            keys: string;
+        }, options: import("ai").ToolExecutionOptions) => PromiseLike<string>;
+    };
+    scroll: import("ai").Tool<z.ZodObject<{
+        direction: z.ZodEnum<["up", "down"]>;
+        pixels: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        direction: "up" | "down";
+        pixels: number;
+    }, {
+        direction: "up" | "down";
+        pixels?: number | undefined;
+    }>, string> & {
+        execute: (args: {
+            direction: "up" | "down";
+            pixels: number;
+        }, options: import("ai").ToolExecutionOptions) => PromiseLike<string>;
+    };
+    find_text: import("ai").Tool<z.ZodObject<{
+        text: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        text: string;
+    }, {
+        text: string;
+    }>, string> & {
+        execute: (args: {
+            text: string;
+        }, options: import("ai").ToolExecutionOptions) => PromiseLike<string>;
+    };
+    scroll_to_element: import("ai").Tool<z.ZodObject<{
+        index: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        index: number;
+    }, {
+        index: number;
+    }>, string> & {
+        execute: (args: {
+            index: number;
+        }, options: import("ai").ToolExecutionOptions) => PromiseLike<string>;
+    };
+    screenshot: import("ai").Tool<z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>, {
+        type: string;
+        image_base64: string;
+    }> & {
+        execute: (args: {}, options: import("ai").ToolExecutionOptions) => PromiseLike<{
+            type: string;
+            image_base64: string;
+        }>;
+    };
+    extract: import("ai").Tool<z.ZodObject<{
+        query: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        query: string;
+    }, {
+        query: string;
+    }>, string> & {
+        execute: (args: {
+            query: string;
+        }, options: import("ai").ToolExecutionOptions) => PromiseLike<string>;
+    };
+    search_page: import("ai").Tool<z.ZodObject<{
+        query: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        query: string;
+    }, {
+        query: string;
+    }>, string> & {
+        execute: (args: {
+            query: string;
+        }, options: import("ai").ToolExecutionOptions) => PromiseLike<string>;
+    };
+    switch_tab: import("ai").Tool<z.ZodObject<{
+        tab_id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        tab_id: string;
+    }, {
+        tab_id: string;
+    }>, string> & {
+        execute: (args: {
+            tab_id: string;
+        }, options: import("ai").ToolExecutionOptions) => PromiseLike<string>;
+    };
+    close_tab: import("ai").Tool<z.ZodObject<{
+        tab_id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        tab_id: string;
+    }, {
+        tab_id: string;
+    }>, string> & {
+        execute: (args: {
+            tab_id: string;
+        }, options: import("ai").ToolExecutionOptions) => PromiseLike<string>;
+    };
+    new_tab: import("ai").Tool<z.ZodObject<{
+        url: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+    }, {
+        url?: string | undefined;
+    }>, string> & {
+        execute: (args: {
+            url: string;
+        }, options: import("ai").ToolExecutionOptions) => PromiseLike<string>;
+    };
+    dropdown_options: import("ai").Tool<z.ZodObject<{
+        selector: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        selector: string;
+    }, {
+        selector: string;
+    }>, string> & {
+        execute: (args: {
+            selector: string;
+        }, options: import("ai").ToolExecutionOptions) => PromiseLike<string>;
+    };
+    select_dropdown: import("ai").Tool<z.ZodObject<{
+        selector: z.ZodString;
+        value: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        value: string;
+        selector: string;
+    }, {
+        value: string;
+        selector: string;
+    }>, string> & {
+        execute: (args: {
+            value: string;
+            selector: string;
+        }, options: import("ai").ToolExecutionOptions) => PromiseLike<string>;
+    };
+    upload_file: import("ai").Tool<z.ZodObject<{
+        selector: z.ZodString;
+        file_path: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        selector: string;
+        file_path: string;
+    }, {
+        selector: string;
+        file_path: string;
+    }>, string> & {
+        execute: (args: {
+            selector: string;
+            file_path: string;
+        }, options: import("ai").ToolExecutionOptions) => PromiseLike<string>;
+    };
+    write_file: import("ai").Tool<z.ZodObject<{
+        path: z.ZodString;
+        content: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        content: string;
+        path: string;
+    }, {
+        content: string;
+        path: string;
+    }>, string> & {
+        execute: (args: {
+            content: string;
+            path: string;
+        }, options: import("ai").ToolExecutionOptions) => PromiseLike<string>;
+    };
+    read_file: import("ai").Tool<z.ZodObject<{
+        path: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+    }, {
+        path: string;
+    }>, string> & {
+        execute: (args: {
+            path: string;
+        }, options: import("ai").ToolExecutionOptions) => PromiseLike<string>;
+    };
+    type_text: import("ai").Tool<z.ZodObject<{
+        text: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        text: string;
+    }, {
+        text: string;
+    }>, string> & {
+        execute: (args: {
+            text: string;
+        }, options: import("ai").ToolExecutionOptions) => PromiseLike<string>;
+    };
+    save_page_snapshot: import("ai").Tool<z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>, string> & {
+        execute: (args: {}, options: import("ai").ToolExecutionOptions) => PromiseLike<string>;
+    };
+    save_element_html: import("ai").Tool<z.ZodObject<{
+        index: z.ZodOptional<z.ZodNumber>;
+        selector: z.ZodOptional<z.ZodString>;
+        filename: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        index?: number | undefined;
+        selector?: string | undefined;
+        filename?: string | undefined;
+    }, {
+        index?: number | undefined;
+        selector?: string | undefined;
+        filename?: string | undefined;
+    }>, string> & {
+        execute: (args: {
+            index?: number | undefined;
+            selector?: string | undefined;
+            filename?: string | undefined;
+        }, options: import("ai").ToolExecutionOptions) => PromiseLike<string>;
+    };
+    shell: import("ai").Tool<z.ZodObject<{
+        command: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        command: string;
+    }, {
+        command: string;
+    }>, any> & {
+        execute: (args: {
+            command: string;
+        }, options: import("ai").ToolExecutionOptions) => PromiseLike<any>;
+    };
+    evaluate: import("ai").Tool<z.ZodObject<{
+        code: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        code: string;
+    }, {
+        code: string;
+    }>, string> & {
+        execute: (args: {
+            code: string;
+        }, options: import("ai").ToolExecutionOptions) => PromiseLike<string>;
+    };
+    handle_dialog: import("ai").Tool<z.ZodObject<{
+        accept: z.ZodBoolean;
+        text: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        accept: boolean;
+        text?: string | undefined;
+    }, {
+        accept: boolean;
+        text?: string | undefined;
+    }>, string> & {
+        execute: (args: {
+            accept: boolean;
+            text?: string | undefined;
+        }, options: import("ai").ToolExecutionOptions) => PromiseLike<string>;
+    };
+    wait: import("ai").Tool<z.ZodObject<{
+        seconds: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        seconds: number;
+    }, {
+        seconds: number;
+    }>, string> & {
+        execute: (args: {
+            seconds: number;
+        }, options: import("ai").ToolExecutionOptions) => PromiseLike<string>;
+    };
+    solve_captcha: import("ai").Tool<z.ZodObject<{
+        site_url: z.ZodString;
+        site_key: z.ZodString;
+        captcha_type: z.ZodDefault<z.ZodEnum<["recaptcha_v2", "recaptcha_v3", "hcaptcha", "turnstile"]>>;
+    }, "strip", z.ZodTypeAny, {
+        site_url: string;
+        site_key: string;
+        captcha_type: "recaptcha_v2" | "recaptcha_v3" | "hcaptcha" | "turnstile";
+    }, {
+        site_url: string;
+        site_key: string;
+        captcha_type?: "recaptcha_v2" | "recaptcha_v3" | "hcaptcha" | "turnstile" | undefined;
+    }>, string> & {
+        execute: (args: {
+            site_url: string;
+            site_key: string;
+            captcha_type: "recaptcha_v2" | "recaptcha_v3" | "hcaptcha" | "turnstile";
+        }, options: import("ai").ToolExecutionOptions) => PromiseLike<string>;
+    };
+    inject_captcha_token: import("ai").Tool<z.ZodObject<{
+        token: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        token: string;
+    }, {
+        token: string;
+    }>, string> & {
+        execute: (args: {
+            token: string;
+        }, options: import("ai").ToolExecutionOptions) => PromiseLike<string>;
+    };
+    solve_datadome: import("ai").Tool<z.ZodObject<{
+        site_url: z.ZodString;
+        captcha_url: z.ZodString;
+        user_agent: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        site_url: string;
+        captcha_url: string;
+        user_agent?: string | undefined;
+    }, {
+        site_url: string;
+        captcha_url: string;
+        user_agent?: string | undefined;
+    }>, string> & {
+        execute: (args: {
+            site_url: string;
+            captcha_url: string;
+            user_agent?: string | undefined;
+        }, options: import("ai").ToolExecutionOptions) => PromiseLike<string>;
+    };
+    done: import("ai").Tool<z.ZodObject<{
+        text: z.ZodString;
+        success: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        text: string;
+        success: boolean;
+    }, {
+        text: string;
+        success?: boolean | undefined;
+    }>, {
+        done: boolean;
+        text: string;
+        success: boolean;
+    }> & {
+        execute: (args: {
+            text: string;
+            success: boolean;
+        }, options: import("ai").ToolExecutionOptions) => PromiseLike<{
+            done: boolean;
+            text: string;
+            success: boolean;
+        }>;
+    };
+};
+export type BrowserTools = ReturnType<typeof createBrowserTools>;