import { type EveSandboxSession } from "./sandbox";
/** Structural subset of eve's tool context — every eve `ctx` satisfies it. */
export interface BrowserToolContext {
    readonly abortSignal?: AbortSignal;
    getSandbox(): PromiseLike<EveSandboxSession | null | undefined>;
}
export declare const SELECTOR_HINT = "Element selector: a ref from the snapshot tool like \"@e12\" (most reliable), a CSS selector like \"#login .submit\", \"text=Sign in\", or \"xpath=//button[1]\".";
/**
 * Run an agent-browser command in the eve sandbox and return the parsed
 * `data` payload of its `--json` envelope. Throws when the sandbox is
 * unavailable, the command exits non-zero, or the envelope reports failure.
 */
export declare function runBrowser<TData = unknown>(ctx: BrowserToolContext, args: readonly string[]): Promise<TData>;