import { A11yConfig, ResolvedA11yConfig } from './a11y/config';

/** 鼠标光标展示策略：仅操作类展示（默认） / 遮罩期间始终展示 / 永不展示 */
export type PageAgentCursorMode = 'actionOnly' | 'always' | 'never';
export interface PageAgentToolConfig {
    /** 是否启用元素高亮 */
    enableHighlight: boolean;
    /** 是否在工具调用后移除遮罩， 默认值为 true 移除 */
    removeMaskAfterToolCall?: boolean;
    /** 是否启用执行 JavaScript 工具 */
    enableExecuteJavascript?: boolean;
    /**
     * 鼠标光标展示策略。
     * - `actionOnly`（默认）：仅 click/fill/select/hover 期间展示，步骤结束后收起
     * - `always`：未传 showCursor 时遮罩可见即展示光标；显式 `{ showCursor: false }` 仍可临时隐藏；操作结束后不自动收起
     * - `never`：任何路径都不展示光标（含宿主显式 `showCursor: true`）
     */
    cursorMode: PageAgentCursorMode;
    /**
     * 统一无障碍配置：按角色（roles）、状态（states：selected/disabled/error/warning 等）自定义规则，
     * 以及白名单/黑名单/自定义暴露属性/弹窗选择器。已与默认配置合并（数组类字段是拼接结果）。
     */
    a11yConfig: ResolvedA11yConfig;
}
/**
 * 用于初始化（registerPageAgentTool 的入参）或运行期 setPageAgentToolConfig 的补丁对象：
 * enableHighlight 为覆盖式更新；a11yConfig 为拼接式合并（数组类字段追加，不丢已有规则，语义见 a11y/config.ts）。
 */
export interface PageAgentToolConfigPatch {
    /** 是否启用元素高亮 */
    enableHighlight?: boolean;
    /** 是否在工具调用后移除遮罩， 默认值为 true 移除 */
    removeMaskAfterToolCall?: boolean;
    /** 是否启用执行 JavaScript 工具 */
    enableExecuteJavascript?: boolean;
    /** 鼠标光标展示策略，见 {@link PageAgentCursorMode} */
    cursorMode?: PageAgentCursorMode;
    /** 统一无障碍配置，会与当前生效的 a11yConfig 按数组拼接合并 */
    a11yConfig?: A11yConfig;
}
/** registerPageAgentTool(options) 的入参类型，与运行期补丁 {@link PageAgentToolConfigPatch} 完全一致 */
export type PageAgentToolOptions = PageAgentToolConfigPatch;
/** 默认生效的完整工具配置 */
export declare const DEFAULT_PAGE_AGENT_TOOL_CONFIG: PageAgentToolConfig;
declare global {
    interface Window {
        /** 运行期唯一生效的 page-agent-tool 完整配置（已与默认值合并），可通过 getPageAgentToolConfig/setPageAgentToolConfig 读写 */
        __webmcpcli_toolConfig?: PageAgentToolConfig;
    }
}
/** 读取当前生效的完整工具配置（已与默认值合并）。未初始化时返回默认配置 */
export declare function getPageAgentToolConfig(): PageAgentToolConfig;
/**
 * 更新当前生效配置。
 * - patch 为对象时：enableHighlight / cursorMode 等标量覆盖式更新；a11yConfig 与当前配置按数组拼接合并（不丢已有规则）
 * - patch 为函数时：入参为当前生效配置。标量字段与 current 合并（未返回则保持原值，例如只改高亮不会重置 cursorMode）；
 *   若返回了 a11yConfig，则与默认无障碍配置合并（而不是再与 current 相加），以便过滤后的规则不会复活。
 * - options.mode = 'replace' 时（仅影响对象类型的 patch）：不与"当前生效配置"合并，而是与默认配置重新合并
 * 返回合并后的最新完整配置，并写回运行期存储供 buildBrowserStateResponse/buildA11yTree 等读取。
 */
export declare function setPageAgentToolConfig(patch: PageAgentToolConfigPatch | ((current: PageAgentToolConfig) => PageAgentToolConfigPatch), options?: {
    mode?: 'merge' | 'replace';
}): PageAgentToolConfig;