/**
 * Weavetab — tools/snapshot.ts
 * browser_snapshot: Create and restore MHTML snapshots of the DOM state.
 *
 * Secret containment: before capture, all elements marked data-wt-secret have
 * their value blanked in the live DOM (then restored after capture). This prevents
 * typed credential values from appearing in the MHTML archive.
 *
 * Weavetab by fy2ne
 */
import CDP from "chrome-remote-interface";
import type { Config } from "../config/loader.js";
export interface SnapshotOptions {
    action: "capture" | "restore";
    /** Preferred parameter name. */
    filename?: string;
    /** Accepted alias for filename (sent by the MCP schema). */
    filePath?: string;
    /** If false, keeps the WeaveTab UI overlay visible in the MHTML snapshot.
     * Default: true — overlay (cursor, thought bubble, HUD) is always hidden from snapshots. */
    hideOverlay?: boolean;
}
export declare function browserSnapshot(session: CDP.Client, options: SnapshotOptions, config: Config): Promise<{
    success: boolean;
    message: string;
    warning?: string;
}>;