import type { Locator } from "playwright";
import type { BrowserSession } from "./types.js";
/**
 * Get a Playwright locator from a ref (@e1) or CSS selector.
 * Refs are looked up in the session's refMap from the last snapshot.
 */
export declare function getLocator(session: BrowserSession, selector: string): Locator;
/**
 * Convert Playwright errors to AI-friendly messages with actionable guidance.
 */
export declare function toAIFriendlyError(e: unknown, selector: string): string;
/**
 * Wrap a selector-based action so Playwright errors become AI-friendly Errors.
 * Mirrors the MCP server's `error(toAIFriendlyError(e, selector))` behaviour:
 * the thrown Error's message is the AI-friendly string.
 */
export declare function withFriendlyError<T>(selector: string, fn: () => Promise<T>): Promise<T>;
//# sourceMappingURL=locator.d.ts.map