import type { AgentTool, AgentToolContext, AgentToolResult, AgentToolUpdateCallback } from "@oh-my-pi/pi-agent-core";
import * as z from "zod/v4";
import type { ToolSession } from "../sdk";
import { type BrowserKindTag } from "./browser/registry";
import type { Observation, ScreenshotResult } from "./browser/tab-protocol";
import type { OutputMeta } from "./output-meta";
export { extractReadableFromHtml, type ReadableFormat, type ReadableResult } from "./browser/readable";
export type { Observation, ObservationEntry } from "./browser/tab-protocol";
declare const browserSchema: z.ZodObject<{
    action: z.ZodEnum<{
        close: "close";
        open: "open";
        run: "run";
    }>;
    name: z.ZodOptional<z.ZodString>;
    url: z.ZodOptional<z.ZodString>;
    app: z.ZodOptional<z.ZodObject<{
        path: z.ZodOptional<z.ZodString>;
        cdp_url: z.ZodOptional<z.ZodString>;
        args: z.ZodOptional<z.ZodArray<z.ZodString>>;
        target: z.ZodOptional<z.ZodString>;
    }, z.core.$strip>>;
    viewport: z.ZodOptional<z.ZodObject<{
        width: z.ZodNumber;
        height: z.ZodNumber;
        scale: z.ZodOptional<z.ZodNumber>;
    }, z.core.$strip>>;
    wait_until: z.ZodOptional<z.ZodEnum<{
        domcontentloaded: "domcontentloaded";
        load: "load";
        networkidle0: "networkidle0";
        networkidle2: "networkidle2";
    }>>;
    dialogs: z.ZodOptional<z.ZodEnum<{
        accept: "accept";
        dismiss: "dismiss";
    }>>;
    code: z.ZodOptional<z.ZodString>;
    timeout: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
    all: z.ZodOptional<z.ZodBoolean>;
    kill: z.ZodOptional<z.ZodBoolean>;
}, z.core.$strip>;
/** Input schema for the browser tool. */
export type BrowserParams = z.infer<typeof browserSchema>;
/** Details describing a browser tool execution result (for renderers + transcript). */
export interface BrowserToolDetails {
    action: BrowserParams["action"];
    name?: string;
    url?: string;
    browser?: BrowserKindTag;
    viewport?: {
        width: number;
        height: number;
        deviceScaleFactor?: number;
    };
    observation?: Observation;
    screenshots?: ScreenshotResult[];
    result?: string;
    meta?: OutputMeta;
}
/**
 * Browser tool: stateful, multi-tab. Three actions:
 * - `open`  → acquire/create a named tab on a browser kind (headless | spawned | connected) and optionally goto a url.
 * - `close` → release a named tab (or all tabs); dispose browser when refcount hits 0.
 * - `run`   → execute JS code against an existing tab with `page`/`browser`/`tab` helpers in scope.
 */
export declare class BrowserTool implements AgentTool<typeof browserSchema, BrowserToolDetails> {
    #private;
    private readonly session;
    readonly name = "browser";
    readonly label = "Browser";
    readonly loadMode = "discoverable";
    readonly summary = "Control a headless browser to navigate and interact with web pages";
    readonly parameters: z.ZodObject<{
        action: z.ZodEnum<{
            close: "close";
            open: "open";
            run: "run";
        }>;
        name: z.ZodOptional<z.ZodString>;
        url: z.ZodOptional<z.ZodString>;
        app: z.ZodOptional<z.ZodObject<{
            path: z.ZodOptional<z.ZodString>;
            cdp_url: z.ZodOptional<z.ZodString>;
            args: z.ZodOptional<z.ZodArray<z.ZodString>>;
            target: z.ZodOptional<z.ZodString>;
        }, z.core.$strip>>;
        viewport: z.ZodOptional<z.ZodObject<{
            width: z.ZodNumber;
            height: z.ZodNumber;
            scale: z.ZodOptional<z.ZodNumber>;
        }, z.core.$strip>>;
        wait_until: z.ZodOptional<z.ZodEnum<{
            domcontentloaded: "domcontentloaded";
            load: "load";
            networkidle0: "networkidle0";
            networkidle2: "networkidle2";
        }>>;
        dialogs: z.ZodOptional<z.ZodEnum<{
            accept: "accept";
            dismiss: "dismiss";
        }>>;
        code: z.ZodOptional<z.ZodString>;
        timeout: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
        all: z.ZodOptional<z.ZodBoolean>;
        kill: z.ZodOptional<z.ZodBoolean>;
    }, z.core.$strip>;
    readonly strict = true;
    constructor(session: ToolSession);
    get description(): string;
    /** Restart browser to apply mode changes (e.g. headless toggle). Drops only headless browsers. */
    restartForModeChange(): Promise<void>;
    execute(_toolCallId: string, params: BrowserParams, signal?: AbortSignal, _onUpdate?: AgentToolUpdateCallback<BrowserToolDetails>, _ctx?: AgentToolContext): Promise<AgentToolResult<BrowserToolDetails>>;
}