@mearl/client 2.22.0 → 3.0.0-beta.0

package/dist/generated/browser-action-protocol.d.ts

@@ -1,1147 +0,0 @@
-export interface GetRequestsParams {
-    tabId: number;
-    count?: number;
-    filter?: string;
-    /** Relative time window in seconds. */
-    since?: number;
-    /** Opaque cursor returned by tab_checkpoint or a previous query. */
-    after?: string;
-    /** Defaults to false when fields are selected, otherwise true. */
-    includeBody?: boolean;
-    includeHeaders?: boolean;
-    maxBodySize?: number;
-    fields?: string[];
-    keysOnly?: boolean;
-    applyHiddenFilter?: boolean;
-    source?: 'mtop' | 'requests' | 'all';
-}
-export interface GetLogsParams {
-    tabId: number;
-    level?: 'log' | 'warn' | 'error' | 'info' | 'all';
-    /** Relative time window in seconds. */
-    since?: number;
-    /** Opaque cursor returned by tab_checkpoint or a previous query. */
-    after?: string;
-    limit?: number;
-    filter?: string;
-}
-export interface CaptureCheckpointParams {
-    tabId: number;
-}
-export interface CaptureCheckpointResult {
-    tabId: number;
-    cursor: string;
-    timestampMs: number;
-    captureStatus: 'armed' | 'active';
-}
-export interface GetEventsParams {
-    tabId: number;
-    source?: 'rum' | 'aplus' | 'arms' | 'all';
-    event_type?: string;
-    filter?: string;
-    since?: number;
-    /** Opaque cursor returned by tab_checkpoint or a previous event query. */
-    after?: string;
-    limit?: number;
-    includeRaw?: boolean;
-}
-export interface SetMockParams {
-    tabId: number;
-    apiName: string;
-    mockData?: unknown;
-    fields?: Array<{
-        path: string;
-        value: unknown;
-    }>;
-    enabled?: boolean;
-    duration?: number;
-    conditions?: Record<string, unknown>;
-}
-export interface GetMocksParams {
-    tabId: number;
-    apiName?: string;
-}
-export declare const SEND_REQUEST_MAX_FILES = 20;
-export declare const SEND_REQUEST_MAX_TOTAL_FILE_BYTES: number;
-export declare const SEND_REQUEST_MAX_TOTAL_BASE64_FILE_BYTES: number;
-export type SendRequestFormValue = string | number | boolean;
-interface SendRequestFileMetadata {
-    /** multipart/form-data field name. */
-    fieldName: string;
-    /** Defaults to a MIME type inferred from filename, then application/octet-stream. */
-    contentType?: string;
-}
-export type SendRequestFile = SendRequestFileMetadata & ({
-    /** Absolute path on the machine running Mearl native-host. */
-    filePath: string;
-    base64?: never;
-    /** Defaults to the basename of filePath. */
-    filename?: string;
-} | {
-    filePath?: never;
-    /** Base64 payload; decoded Base64-backed files are limited to 7 MiB total. */
-    base64: string;
-    /** Multipart filename for the Base64 payload. */
-    filename: string;
-});
-export type SendRequestBinaryBody = {
-    contentType?: string;
-} & ({
-    filePath: string;
-    base64?: never;
-} | {
-    filePath?: never;
-    base64: string;
-});
-export interface SendRequestParams {
-    url: string;
-    method?: string;
-    headers?: Record<string, string>;
-    params?: Record<string, string>;
-    body?: unknown;
-    /** Raw bytes, mutually exclusive with body, formData and files. */
-    bodyFile?: SendRequestBinaryBody;
-    formData?: Record<string, SendRequestFormValue>;
-    files?: SendRequestFile[];
-    withCookies?: boolean;
-    responseType?: 'json' | 'text' | 'auto';
-    timeout?: number;
-}
-export type MtopEnvironmentTarget = 'prod' | 'pre';
-export type MtopEnvironment = 'default' | MtopEnvironmentTarget;
-export interface SendMtopRequestParams {
-    api: string;
-    data?: unknown;
-    version?: string;
-    method?: string;
-    appKey?: string;
-    env?: MtopEnvironmentTarget;
-    timeout?: number;
-    headers?: Record<string, string>;
-    ttid?: string;
-}
-export type BrowserStatus = 'connected' | 'pairing' | 'running_disconnected' | 'stopped';
-export type BrowserTransport = 'extension' | 'cdp' | 'provider';
-export interface BrowserPairingInfo {
-    kind: 'qr';
-    url: string;
-    /** Optional human-readable or provider-specific pairing code. */
-    code?: string;
-    label?: string;
-}
-export interface BrowserSource {
-    kind: 'local' | 'remote';
-    connectorId?: string;
-    connectorName?: string;
-}
-export type BrowserJsonPrimitive = string | number | boolean | null;
-export type BrowserJsonValue = BrowserJsonPrimitive | BrowserJsonValue[] | {
-    [key: string]: BrowserJsonValue;
-};
-export type BrowserProviderOperation = 'start' | 'close' | 'detach' | 'deleteData' | 'access' | 'syncCookies';
-export interface BrowserProviderIdentity {
-    id: string;
-    name: string;
-    builtin: boolean;
-    version?: string;
-    protocolVersion?: number;
-}
-/** Common safe metadata; additional Provider-specific keys must also be non-secret JSON. */
-export type BrowserDetails = Record<string, BrowserJsonValue> & {
-    headless?: boolean;
-    createdAt?: string;
-    cdpPort?: number;
-    copiedCookies?: {
-        domains: string[];
-        count: number;
-    };
-};
-export interface BrowserReference {
-    kind: string;
-    id: string;
-    label?: string;
-}
-export interface BrowserInfoBase {
-    browserId: string;
-    name: string;
-    status: BrowserStatus;
-    /** Source-local values retained when the unified client returns a global browser id and label. */
-    originalBrowserId?: string;
-    originalName?: string;
-    source?: BrowserSource;
-    extensionVersion?: string;
-    nativeHostVersion?: string;
-    transport?: BrowserTransport;
-    /** Provider identity, independent from the browser control transport. */
-    provider?: BrowserProviderIdentity;
-    ownership?: 'owned' | 'attached';
-    persistence?: 'ephemeral' | 'persistent';
-    operations?: BrowserProviderOperation[];
-    references?: BrowserReference[];
-    /** Safe, non-secret metadata suitable for display and remote connectors. */
-    details?: BrowserDetails;
-    /** Setup information exposed by a provider while it waits for an external device. */
-    pairing?: BrowserPairingInfo;
-}
-export type BrowserScreenshotKind = 'native' | 'reconstructed' | 'none';
-/** Browser-targeted actions that an external provider may implement. */
-export type BrowserCapabilityAction = ExtensionBrowserAction | 'page_download';
-/** Capabilities advertised by an external browser-control provider. */
-export interface BrowserCapabilities {
-    actions: BrowserCapabilityAction[];
-    /** Pixel fidelity of page_screenshot, or none when that action is unavailable. */
-    screenshot: BrowserScreenshotKind;
-}
-export interface RegularBrowserInfo extends BrowserInfoBase {
-    type: 'regular';
-    status: 'connected' | 'pairing';
-}
-export interface ManagedBrowserInfo extends BrowserInfoBase {
-    type: 'managed';
-    status: 'connected' | 'pairing' | 'running_disconnected' | 'stopped';
-    provider: BrowserProviderIdentity;
-    persistence: 'ephemeral' | 'persistent';
-    operations: BrowserProviderOperation[];
-}
-export type BrowserInfo = RegularBrowserInfo | ManagedBrowserInfo;
-export interface BrowserListResult {
-    count: number;
-    connectedCount: number;
-    defaultBrowserId: string | null;
-    browsers: BrowserInfo[];
-    /** Partial discovery failures; successfully inspected browser sources remain in the result. */
-    warnings?: string[];
-}
-export interface SelectBrowserParams {
-    browser?: string;
-}
-export interface SelectBrowserResult {
-    selected: {
-        browserId: string;
-        name: string;
-    } | null;
-    note?: string;
-}
-export interface BrowserReleaseFailure {
-    tabId: number;
-    stage: string;
-    error: string;
-}
-export interface BrowserReleaseResult {
-    released: boolean;
-    hadActiveControl: boolean;
-    transports: BrowserTransport[];
-    affectedTabIds: number[];
-    failures?: BrowserReleaseFailure[];
-}
-export interface ControlSessionInfo {
-    sessionId: string;
-    browserId: string;
-    transport: BrowserTransport;
-    status: 'active' | 'user' | 'releasing' | 'released';
-    generation: number;
-    tabs: Array<{
-        tabId: number;
-        source: 'created' | 'attached';
-        title?: string;
-        url?: string;
-    }>;
-    reason?: string;
-}
-export interface BrowserReleaseParams {
-    /** Close only session-created pages; attached user pages are protected. */
-    closeCreatedTabs?: boolean;
-    keepTabIds?: number[];
-    /** Preserve the browser environment by default for a scoped release. */
-    preserveEnvironment?: boolean;
-    keepArtifactIds?: string[];
-}
-export interface BrowserControlParams {
-    operation: 'handoff' | 'resume';
-    tabId?: number;
-    reason?: string;
-}
-export interface BrowserArtifact {
-    artifactId: string;
-    filename: string;
-    bytes: number;
-    location: 'browser';
-    /** Global browser route is attached by the unified client. */
-    browserId?: string;
-}
-export interface PageDownloadParams {
-    tabId: number;
-    trigger: Omit<PageClickParams, 'tabId'>;
-    /** Restrict the expected download URL; useful when the browser cannot identify its source. */
-    url?: string;
-    timeout?: number;
-}
-export interface PageDownloadResult {
-    download: BrowserArtifact;
-    action: unknown;
-}
-export interface CookieCopyScope {
-    /** Maintained authentication-domain presets to include. */
-    presets?: Array<'mearl-services'>;
-    /** Additional domains or URLs to copy alongside the selected presets. */
-    domains?: string[];
-}
-export interface BrowserLaunchParams {
-    /** Required by the built-in local Provider. */
-    name?: string;
-    /** Built-in runtime or the id of a registered external Provider. */
-    provider?: string;
-    /** Structured launch parameters declared by the selected Provider. Cannot be mixed with flat options. */
-    providerOptions?: Record<string, BrowserJsonValue>;
-    /** Whether the built-in local Chrome uses headless mode. Defaults to true. */
-    headless?: boolean;
-    /** Desktop mode uses a user agent matching the local Chrome version. */
-    userAgentMode?: 'default' | 'desktop';
-    persistent?: boolean;
-    executablePath?: string;
-    url?: string;
-    /** Copy explicit domains, the Mearl-service preset, or a combination of both. */
-    copyCookieDomains?: string[] | 'mearl-services' | CookieCopyScope;
-}
-export interface BrowserCloseParams {
-    browser: string;
-    deleteProfile?: boolean;
-}
-interface BrowserProviderSchemaBase {
-    title?: string;
-    description?: string;
-    default?: BrowserJsonValue;
-    /** Optional Mearl form component used to edit this schema value. */
-    component?: 'cookie-sync' | 'switch';
-    /** Presentation-only default used by Mearl forms without changing runtime semantics. */
-    formDefault?: BrowserJsonValue;
-    /** Excludes an advanced runtime option from generated Mearl forms. */
-    formHidden?: boolean;
-    /** Places compact fields side by side in generated Mearl forms. */
-    formWidth?: 'half' | 'full';
-    /** Hides the optional badge without changing schema validation. */
-    formHideOptional?: boolean;
-    /** Conditionally displays and submits this field based on another form value. */
-    formVisibleWhen?: {
-        field: string;
-        empty: boolean;
-    };
-}
-export type BrowserProviderInputSchema = (BrowserProviderSchemaBase & {
-    type: 'string';
-    secret?: boolean;
-    enum?: readonly string[];
-    minLength?: number;
-    maxLength?: number;
-    pattern?: string;
-    placeholder?: string;
-    options?: readonly {
-        value: string;
-        label: string;
-        description?: string;
-        disabled?: boolean;
-    }[];
-}) | (BrowserProviderSchemaBase & {
-    type: 'number';
-    integer?: boolean;
-    minimum?: number;
-    maximum?: number;
-}) | (BrowserProviderSchemaBase & {
-    type: 'boolean';
-}) | (BrowserProviderSchemaBase & {
-    type: 'array';
-    items: BrowserProviderInputSchema;
-    minItems?: number;
-    maxItems?: number;
-}) | BrowserProviderObjectSchema;
-export interface BrowserProviderObjectSchema extends BrowserProviderSchemaBase {
-    type: 'object';
-    properties: Record<string, BrowserProviderInputSchema>;
-    required?: readonly string[];
-    oneOf?: readonly BrowserProviderObjectSchema[];
-    not?: BrowserProviderObjectSchema;
-    additionalProperties?: boolean;
-}
-export interface BrowserProviderDefinition {
-    provider: BrowserProviderIdentity;
-    browserType: {
-        name: string;
-        documentationUrl?: string;
-        inputSchema: BrowserProviderObjectSchema;
-        configuration?: {
-            inputSchema: BrowserProviderObjectSchema;
-        };
-        dynamicLaunchForm?: boolean;
-        launchForm?: BrowserProviderLaunchForm;
-    };
-}
-export interface BrowserProviderLaunchFormVariant {
-    id: string;
-    title: string;
-    description?: string;
-    inputSchema?: BrowserProviderObjectSchema;
-    values?: Record<string, BrowserJsonValue>;
-    refreshOn?: readonly string[];
-    dynamicFields?: readonly string[];
-}
-export interface BrowserProviderLaunchForm {
-    inputSchema: BrowserProviderObjectSchema;
-    variants?: readonly BrowserProviderLaunchFormVariant[];
-    variant?: string;
-    values?: Record<string, BrowserJsonValue>;
-    refreshOn?: readonly string[];
-    dynamicFields?: readonly string[];
-    message?: string;
-    blocked?: boolean;
-}
-export interface BrowserProviderListResult {
-    providers: BrowserProviderDefinition[];
-}
-export interface BrowserAccessResult {
-    browserAccess: {
-        kind: string;
-        url: string;
-        sensitive: true;
-    };
-}
-export interface AddRuleParams {
-    enabled?: true;
-    actionType: 'redirect' | 'block' | 'allow' | 'upgradeScheme' | 'modifyHeaders';
-    filter: string;
-    redirectUrl?: string;
-    requestHeaders?: Array<{
-        header: string;
-        operation: 'set' | 'append' | 'remove';
-        value?: string;
-    }>;
-    responseHeaders?: Array<{
-        header: string;
-        operation: 'set' | 'append' | 'remove';
-        value?: string;
-    }>;
-    initiatorDomains?: string;
-    resourceTypes?: string[];
-    priority?: number;
-    description?: string;
-}
-export interface DeleteRuleParams {
-    enabled: false;
-    ruleId: number;
-}
-export type SetRuleParams = AddRuleParams | DeleteRuleParams;
-export interface RulesResult {
-    enabled: boolean;
-    rules: Array<Record<string, unknown>>;
-}
-export interface PageScreenshotParams {
-    tabId: number;
-    selector?: string;
-    format?: 'png' | 'jpeg';
-    quality?: number;
-    captureMode?: 'cdp' | 'visible';
-}
-export declare const BROWSER_DEVICE_PRESET_NAMES: readonly ["iphone-duo-folded", "iphone-duo-unfolded", "iphone-17-pro", "iphone-17e", "pixel-11", "ipad-mini-a17-pro", "galaxy-s26", "pura-x-max", "iphone-15-pro", "iphone-se", "pixel-8", "ipad-mini", "galaxy-s23"];
-export type BrowserDevicePresetName = (typeof BROWSER_DEVICE_PRESET_NAMES)[number];
-export interface BrowserEmulationOptions {
-    preset?: BrowserDevicePresetName;
-    width?: number;
-    height?: number;
-    deviceScaleFactor?: number;
-    scale?: number;
-    mobile?: boolean;
-    userAgent?: string;
-    orientation?: 'portrait' | 'landscape';
-    touch?: boolean;
-    /** 在 iframe WebView 外渲染设备系统栏；默认 false，保持纯 CDP 设备模拟。 */
-    deviceShell?: boolean;
-    /** App 容器横屏时将根页面与业务页面分置左右 WebView；仅与 deviceShell、App 档案同时生效。 */
-    splitScreen?: boolean;
-}
-export type AppBridgeConfigBehavior = 'navigate' | 'closeAll' | 'closeBackData' | 'postMessage' | 'notifySubscribe' | 'notifyUnsubscribe' | 'notifyPost' | 'sharedFileRead' | 'sharedFileWrite' | 'sharedDataGet' | 'sharedDataSet' | 'legacyBroadcastCreate' | 'legacyBroadcastPost' | 'legacyBroadcastClose' | 'memoryGet' | 'memorySet' | 'memoryDelete' | 'availabilityMap' | 'userInfo' | 'authCode' | 'networkInfo' | 'geolocation' | 'permission' | 'imagePicker' | 'prefetch' | 'fptTrack' | 'mtopStream' | 'previewFile' | 'toast' | 'unsupportedNativeInput' | 'payment' | 'userTrack' | 'calendar' | 'networkQualityMonitor' | 'beaconRequest' | 'voiceRecognition';
-/** 单个桥方法的声明式覆盖；行为、固定回包、成功空实现三选一。 */
-export interface AppBridgeMethodConfig {
-    behavior?: AppBridgeConfigBehavior;
-    response?: unknown;
-    noop?: boolean;
-    silent?: boolean;
-}
-/** 追加或覆盖 App 档案中的桥方法。配置保持 JSON 可序列化，不执行配置提供的代码。 */
-export interface AppBridgeConfig {
-    methods: Record<string, AppBridgeMethodConfig>;
-}
-export interface TabOpenParams {
-    url: string;
-    active?: boolean;
-    /** Source tab whose Agent conversation should own the opened or reused tab. */
-    openerTabId?: number;
-    closeExisting?: boolean;
-    reuse?: 'never' | 'prefer' | 'require';
-    match?: {
-        urlPattern?: string;
-        ignoreSearch?: boolean;
-        ignoreHash?: boolean;
-        onMultiple?: 'error' | 'first';
-    };
-    restoreFocusOnClose?: boolean;
-    emulation?: BrowserEmulationOptions;
-    group?: string;
-    /**
-     * 客户端容器模拟档案名（如 'fliggy'）。只注入容器 UA、环境变量、JSBridge 与桥协议；
-     * 设备视口和 iframe 系统外壳由 emulation.deviceShell 独立控制。可用档案见 APP_PROFILE_NAMES。
-     */
-    appProfile?: AppProfileName;
-    /** 与 appProfile 配合使用；容器系统，默认 ios */
-    os?: 'ios' | 'android';
-    /** 与 appProfile 配合使用；按方法覆盖档案内置桥配置 */
-    bridgeConfig?: AppBridgeConfig;
-}
-export type TabGroupParams = {
-    tabIds: number[];
-    title: string;
-    ungroup?: false;
-} | {
-    tabIds: number[];
-    ungroup: true;
-    title?: never;
-};
-/**
- * 客户端容器模拟可用档案名。
- *
- * 档案数据（UA / 桥对象 / 方法映射）在 @mearl/app-profiles 维护，但名单属于协议：
- * 它是 set_app_profile.profile 与 tab_open.appProfile 的取值域，CLI 帮助与 MCP 工具
- * schema 的 enum 也由它生成。app-profiles 反向引用本清单约束自己的档案表，
- * 因此新增档案时只需改两处（名单 + 档案数据），且漏改会在类型检查时暴露。
- */
-export declare const APP_PROFILE_NAMES: readonly ["fliggy", "taobao", "wechat", "tmall", "alipay", "koubei", "taobao-tj", "taobao-live", "xianyu", "etao", "eleme", "damai", "btrip", "amap", "qianwen", "lingyou", "didi", "easybike"];
-export type BuiltinAppProfileName = (typeof APP_PROFILE_NAMES)[number];
-export type AppProfileName = BuiltinAppProfileName | `${string}/${string}`;
-export interface SetAppProfileParams {
-    tabId: number;
-    /** false 时清除该 tab 的容器模拟并刷新 */
-    enabled: boolean;
-    /** 容器档案名（enabled=true 时必填） */
-    profile?: AppProfileName;
-    /** Immediately use the latest installed definition while preserving explicit options. */
-    refreshDefinition?: boolean;
-    /** 固定当前档案定义；默认在下次文档导航时自动采用可用更新。 */
-    lockDefinition?: boolean;
-    os?: 'ios' | 'android';
-    appVersion?: string;
-    /** 端定义支持的语言选项。 */
-    language?: string;
-    deviceModel?: string;
-    /** 按方法覆盖档案内置桥配置，仅支持受控行为、固定 JSON 回包和成功空实现 */
-    bridgeConfig?: AppBridgeConfig;
-    /**
-     * 可选 MTop 接口环境。default 关闭环境改写；省略时保持当前设置。
-     * 扩展模式与插件设置页共享并全局生效；CDP 模式仅作用于目标 tab。
-     */
-    mtopEnv?: MtopEnvironment;
-    /**
-     * 可选设备联动参数。传入时显式字段覆盖档案推荐设备，空对象使用推荐设备且默认开启
-     * deviceShell；省略时不设置或清除该 tab 的设备状态。
-     */
-    emulation?: BrowserEmulationOptions;
-    /** 默认 true：应用/清除后刷新页面使注入生效 */
-    reload?: boolean;
-}
-export interface TabCloseParams {
-    tabId: number;
-}
-export interface PageObservationWaitOptions {
-    quietMs?: number;
-    firstChangeTimeoutMs?: number;
-    timeoutMs?: number;
-    navigationGraceMs?: number;
-    navigationTimeoutMs?: number;
-    networkIdleMs?: number;
-    contentReadyAfterMs?: number;
-}
-export interface PageDiagnosticsOptions {
-    logs?: boolean | Pick<GetLogsParams, 'level' | 'limit' | 'filter'>;
-    requests?: boolean | Pick<GetRequestsParams, 'count' | 'filter' | 'includeBody' | 'includeHeaders' | 'maxBodySize' | 'fields' | 'keysOnly' | 'source'>;
-    events?: boolean | Pick<GetEventsParams, 'source' | 'event_type' | 'filter' | 'limit' | 'includeRaw'>;
-}
-export type PageDiagnosticsSetting = PageDiagnosticsOptions | boolean;
-export interface PageClickParams {
-    tabId: number;
-    selector?: string;
-    text?: string;
-    point?: {
-        x: number;
-        y: number;
-    };
-    /** CSS/text 查询的目标 frame；省略时容器模式自动使用当前业务 frame。 */
-    frameId?: string;
-    /** point 的坐标空间；默认 outer-viewport 以保持兼容。 */
-    coordinateSpace?: 'outer-viewport' | 'active-frame';
-    role?: string;
-    exact?: boolean;
-    scope?: string;
-    clickMode?: 'auto' | 'dom' | 'mouse' | 'touch';
-    observe?: PageObservationWaitOptions | false;
-    diagnostics?: PageDiagnosticsSetting;
-}
-export interface PageDragPoint {
-    x: number;
-    y: number;
-}
-export type PageDragEndpoint = string | PageDragPoint;
-export interface PageDragParams {
-    tabId: number;
-    from: PageDragEndpoint;
-    to: PageDragEndpoint;
-    dragMode?: 'auto' | 'dom' | 'mouse' | 'touch';
-    durationMs?: number;
-    observe?: PageObservationWaitOptions | false;
-    diagnostics?: PageDiagnosticsSetting;
-}
-export interface PageTypeParams {
-    tabId: number;
-    selector: string;
-    text: string;
-    clearFirst?: boolean;
-    observe?: PageObservationWaitOptions | false;
-    diagnostics?: PageDiagnosticsSetting;
-}
-export interface PageScrollParams {
-    tabId: number;
-    direction: 'up' | 'down' | 'top' | 'bottom';
-    distance?: number;
-    selector?: string;
-    containerPolicy?: 'self' | 'nearest';
-    observe?: PageObservationWaitOptions | false;
-    diagnostics?: PageDiagnosticsSetting;
-}
-export interface PageHoverParams {
-    tabId: number;
-    selector: string;
-    observe?: PageObservationWaitOptions | false;
-    diagnostics?: PageDiagnosticsSetting;
-}
-export interface PageEvalParams {
-    tabId: number;
-    expression: string;
-    /** When provided, expression must evaluate to a function called with these JSON arguments. */
-    args?: unknown[];
-    frameId?: string;
-    awaitPromise?: boolean;
-    observe?: PageObservationWaitOptions | false;
-    diagnostics?: PageDiagnosticsSetting;
-    executionWorld?: 'main' | 'isolated';
-    worldId?: string;
-}
-export declare function resolvePageEvalExpression(params: Pick<PageEvalParams, 'expression' | 'args'>): string;
-export interface PageUserScriptParams {
-    tabId: number;
-    worldId: string;
-    code: string;
-}
-export declare function validatePageUserScriptParams(params: PageUserScriptParams): void;
-export interface PageSnapshotQuery {
-    text?: string;
-    role?: string;
-    exact?: boolean;
-}
-export interface PageSnapshotParams {
-    tabId: number;
-    depth?: number;
-    maxChars?: number;
-    maxNodes?: number;
-    rootSelector?: string;
-    rootRef?: string;
-    ancestorDepth?: number;
-    query?: PageSnapshotQuery;
-    mode?: 'full' | 'interactive' | 'viewport' | 'dom';
-}
-export type PageInspectFilter = 'all' | 'overflowing' | 'horizontal-overflow' | 'vertical-overflow' | 'scrollable';
-export interface PageInspectParams {
-    tabId: number;
-    /** Native CSS selector, a page_snapshot @ref, or DevTools' current selection ($0). */
-    selector?: string;
-    /** Limit results after filtering. Defaults to 20, maximum 100. */
-    maxResults?: number;
-    /** Computed-style properties to return. Defaults to common layout properties. */
-    styles?: string[];
-    /** Page-wide or selector-scoped layout filter. Defaults to all. */
-    filter?: PageInspectFilter;
-    /** Include a trimmed outerHTML string for returned matches. Defaults to true for $0. */
-    includeOuterHTML?: boolean;
-}
-export interface PagePressParams {
-    tabId: number;
-    key: string;
-    modifiers?: string[];
-    /** Dispatch strategy. Auto uses DOM events when the page is hidden. */
-    pressMode?: 'auto' | 'dom' | 'keyboard';
-    observe?: PageObservationWaitOptions | false;
-    diagnostics?: PageDiagnosticsSetting;
-}
-export interface PageWaitParams {
-    tabId: number;
-    time?: number;
-    selector?: string;
-    state?: 'attached' | 'detached' | 'visible' | 'hidden';
-    text?: string;
-    exact?: boolean;
-    condition?: string;
-    timeout?: number;
-    interval?: number;
-}
-export interface PageNavigateParams {
-    tabId: number;
-    url?: string;
-    refresh?: boolean;
-    history?: 'back' | 'forward';
-}
-export interface PageUploadParams {
-    tabId: number;
-    selector: string;
-    /** Absolute paths available to the browser host. */
-    filePaths?: string[];
-    /** SDK/CLI stages caller-local files before dispatch. Mutually exclusive with filePaths. */
-    files?: Array<{
-        filePath: string;
-    } | {
-        artifactId: string;
-    }>;
-    observe?: PageObservationWaitOptions | false;
-    diagnostics?: PageDiagnosticsSetting;
-}
-export interface PageFramesParams {
-    tabId: number;
-}
-export interface SetDeviceEmulationParams extends BrowserEmulationOptions {
-    tabId: number;
-    enabled: boolean;
-    reload?: boolean;
-}
-export interface SetTimezoneParams {
-    tabId: number;
-    timezone: string;
-}
-export interface SetTimezoneResult {
-    enabled: boolean;
-    timezone: string | null;
-}
-export interface GetCookieParams {
-    /** Select the tab's cookie store; omitted for the browser's default store. */
-    tabId?: number;
-    name: string;
-    /** Cookie lookup URL; required without tabId, otherwise defaults to the tab URL. */
-    url?: string;
-    domain?: string;
-    path?: string;
-}
-export interface GetCookieResult {
-    tabId?: number;
-    url: string;
-    name: string;
-    found: boolean;
-    value?: string;
-    domain?: string;
-    path?: string;
-}
-export interface SetCookieParams {
-    /** Select the tab's cookie store; required when reload is true. */
-    tabId?: number;
-    name: string;
-    value: string;
-    /** Cookie target URL; required when tabId is omitted. */
-    url?: string;
-    domain?: string;
-    path?: string;
-    reload?: boolean;
-}
-export interface SetCookieResult {
-    tabId?: number;
-    url: string;
-    name: string;
-    domain: string;
-    path: string;
-    reloaded: boolean;
-}
-export interface RequestDomainPermissionParams {
-    domain: string;
-}
-export type RunActionName = Exclude<ExtensionBrowserAction, 'run_actions' | 'browser_release'>;
-export interface ActionStep {
-    action: RunActionName;
-    data?: Record<string, unknown>;
-}
-export interface RunActionsParams {
-    actions: ActionStep[];
-    tabId: number;
-}
-export interface BrowserActionMap {
-    tab_checkpoint: {
-        request: CaptureCheckpointParams;
-        response: CaptureCheckpointResult;
-    };
-    /** Compatibility alias for tab_checkpoint. */
-    capture_checkpoint: {
-        request: CaptureCheckpointParams;
-        response: CaptureCheckpointResult;
-    };
-    get_requests: {
-        request: GetRequestsParams;
-        response: unknown;
-    };
-    get_logs: {
-        request: GetLogsParams;
-        response: unknown;
-    };
-    get_events: {
-        request: GetEventsParams;
-        response: unknown;
-    };
-    set_mock: {
-        request: SetMockParams;
-        response: unknown;
-    };
-    get_mocks: {
-        request: GetMocksParams;
-        response: unknown;
-    };
-    set_rule: {
-        request: SetRuleParams;
-        response: unknown;
-    };
-    get_rules: {
-        request: undefined;
-        response: RulesResult;
-    };
-    send_request: {
-        request: SendRequestParams;
-        response: unknown;
-    };
-    send_mtop_request: {
-        request: SendMtopRequestParams;
-        response: unknown;
-    };
-    browser_list: {
-        request: undefined;
-        response: BrowserListResult;
-    };
-    browser_select_browser: {
-        request: SelectBrowserParams;
-        response: SelectBrowserResult;
-    };
-    browser_release: {
-        request: BrowserReleaseParams;
-        response: BrowserReleaseResult;
-    };
-    browser_control: {
-        request: BrowserControlParams;
-        response: {
-            session: ControlSessionInfo;
-        };
-    };
-    page_download: {
-        request: PageDownloadParams;
-        response: PageDownloadResult;
-    };
-    browser_launch: {
-        request: BrowserLaunchParams;
-        response: ManagedBrowserInfo;
-    };
-    browser_close: {
-        request: BrowserCloseParams;
-        response: unknown;
-    };
-    page_screenshot: {
-        request: PageScreenshotParams;
-        response: unknown;
-    };
-    tab_open: {
-        request: TabOpenParams;
-        response: unknown;
-    };
-    tab_close: {
-        request: TabCloseParams;
-        response: unknown;
-    };
-    tab_list: {
-        request: undefined;
-        response: unknown;
-    };
-    tab_group: {
-        request: TabGroupParams;
-        response: unknown;
-    };
-    page_click: {
-        request: PageClickParams;
-        response: unknown;
-    };
-    page_drag: {
-        request: PageDragParams;
-        response: unknown;
-    };
-    page_type: {
-        request: PageTypeParams;
-        response: unknown;
-    };
-    page_scroll: {
-        request: PageScrollParams;
-        response: unknown;
-    };
-    page_hover: {
-        request: PageHoverParams;
-        response: unknown;
-    };
-    page_eval: {
-        request: PageEvalParams;
-        response: unknown;
-    };
-    page_runtime: {
-        request: Record<string, unknown>;
-        response: unknown;
-    };
-    page_inspect: {
-        request: PageInspectParams;
-        response: unknown;
-    };
-    page_snapshot: {
-        request: PageSnapshotParams;
-        response: unknown;
-    };
-    page_press: {
-        request: PagePressParams;
-        response: unknown;
-    };
-    page_wait: {
-        request: PageWaitParams;
-        response: unknown;
-    };
-    page_navigate: {
-        request: PageNavigateParams;
-        response: unknown;
-    };
-    page_upload: {
-        request: PageUploadParams;
-        response: unknown;
-    };
-    page_frames: {
-        request: PageFramesParams;
-        response: unknown;
-    };
-    set_device_emulation: {
-        request: SetDeviceEmulationParams;
-        response: unknown;
-    };
-    set_app_profile: {
-        request: SetAppProfileParams;
-        response: unknown;
-    };
-    set_timezone: {
-        request: SetTimezoneParams;
-        response: SetTimezoneResult;
-    };
-    get_cookie: {
-        request: GetCookieParams;
-        response: GetCookieResult;
-    };
-    set_cookie: {
-        request: SetCookieParams;
-        response: SetCookieResult;
-    };
-    request_domain_permission: {
-        request: RequestDomainPermissionParams;
-        response: unknown;
-    };
-    run_actions: {
-        request: RunActionsParams;
-        response: unknown;
-    };
-}
-export type BrowserAction = keyof BrowserActionMap;
-export type BrowserActionRequest<A extends BrowserAction> = BrowserActionMap[A]['request'];
-export type BrowserActionResponse<A extends BrowserAction> = BrowserActionMap[A]['response'] & {
-    /** Routing and execution state; browser_control returns the full tab inventory. */
-    session?: Omit<ControlSessionInfo, 'tabs'>;
-};
-export type BrowserCommandAction = Exclude<BrowserAction, 'browser_select_browser'>;
-export type ExtensionBrowserAction = Exclude<BrowserCommandAction, 'browser_list' | 'browser_launch' | 'browser_close' | 'browser_control' | 'page_download'>;
-export declare const TAB_ID_REQUIRED_ACTIONS: readonly ["tab_checkpoint", "capture_checkpoint", "get_requests", "get_logs", "get_events", "set_mock", "get_mocks", "page_screenshot", "tab_close", "page_click", "page_drag", "page_type", "page_scroll", "page_hover", "page_eval", "page_inspect", "page_snapshot", "page_press", "page_wait", "page_navigate", "page_upload", "page_download", "page_frames", "set_device_emulation", "set_app_profile", "set_timezone", "run_actions"];
-export type TabIdRequiredAction = (typeof TAB_ID_REQUIRED_ACTIONS)[number];
-export declare function actionRequiresTabId(action: unknown): action is TabIdRequiredAction;
-export declare function validateRequiredActionTabId(action: string, data: unknown): void;
-export declare const PAGE_ACT_ACTIONS: readonly ["page_click", "page_drag", "page_type", "page_hover", "page_scroll", "page_press", "page_upload", "page_eval"];
-export type PageActAction = (typeof PAGE_ACT_ACTIONS)[number];
-export declare const BROWSER_ACTIONS: {
-    readonly tab_checkpoint: true;
-    readonly capture_checkpoint: true;
-    readonly get_requests: true;
-    readonly get_logs: true;
-    readonly get_events: true;
-    readonly set_mock: true;
-    readonly get_mocks: true;
-    readonly set_rule: true;
-    readonly get_rules: true;
-    readonly send_request: true;
-    readonly send_mtop_request: true;
-    readonly browser_list: true;
-    readonly browser_select_browser: true;
-    readonly browser_release: true;
-    readonly browser_control: true;
-    readonly page_download: true;
-    readonly browser_launch: true;
-    readonly browser_close: true;
-    readonly page_screenshot: true;
-    readonly tab_open: true;
-    readonly tab_close: true;
-    readonly tab_list: true;
-    readonly tab_group: true;
-    readonly page_click: true;
-    readonly page_drag: true;
-    readonly page_type: true;
-    readonly page_scroll: true;
-    readonly page_hover: true;
-    readonly page_eval: true;
-    readonly page_runtime: true;
-    readonly page_inspect: true;
-    readonly page_snapshot: true;
-    readonly page_press: true;
-    readonly page_wait: true;
-    readonly page_navigate: true;
-    readonly page_upload: true;
-    readonly page_frames: true;
-    readonly set_device_emulation: true;
-    readonly set_app_profile: true;
-    readonly set_timezone: true;
-    readonly get_cookie: true;
-    readonly set_cookie: true;
-    readonly request_domain_permission: true;
-    readonly run_actions: true;
-};
-export declare const BROWSER_COMMAND_ACTIONS: {
-    readonly tab_checkpoint: true;
-    readonly capture_checkpoint: true;
-    readonly get_requests: true;
-    readonly get_logs: true;
-    readonly get_events: true;
-    readonly set_mock: true;
-    readonly get_mocks: true;
-    readonly set_rule: true;
-    readonly get_rules: true;
-    readonly send_request: true;
-    readonly send_mtop_request: true;
-    readonly browser_list: true;
-    readonly browser_release: true;
-    readonly browser_control: true;
-    readonly page_download: true;
-    readonly browser_launch: true;
-    readonly browser_close: true;
-    readonly page_screenshot: true;
-    readonly tab_open: true;
-    readonly tab_close: true;
-    readonly tab_list: true;
-    readonly tab_group: true;
-    readonly page_click: true;
-    readonly page_drag: true;
-    readonly page_type: true;
-    readonly page_scroll: true;
-    readonly page_hover: true;
-    readonly page_eval: true;
-    readonly page_runtime: true;
-    readonly page_inspect: true;
-    readonly page_snapshot: true;
-    readonly page_press: true;
-    readonly page_wait: true;
-    readonly page_navigate: true;
-    readonly page_upload: true;
-    readonly page_frames: true;
-    readonly set_device_emulation: true;
-    readonly set_app_profile: true;
-    readonly set_timezone: true;
-    readonly get_cookie: true;
-    readonly set_cookie: true;
-    readonly request_domain_permission: true;
-    readonly run_actions: true;
-};
-export declare const EXTENSION_BROWSER_ACTIONS: {
-    readonly tab_checkpoint: true;
-    readonly capture_checkpoint: true;
-    readonly get_requests: true;
-    readonly get_logs: true;
-    readonly get_events: true;
-    readonly set_mock: true;
-    readonly get_mocks: true;
-    readonly set_rule: true;
-    readonly get_rules: true;
-    readonly send_request: true;
-    readonly send_mtop_request: true;
-    readonly browser_release: true;
-    readonly page_screenshot: true;
-    readonly tab_open: true;
-    readonly tab_close: true;
-    readonly tab_list: true;
-    readonly tab_group: true;
-    readonly page_click: true;
-    readonly page_drag: true;
-    readonly page_type: true;
-    readonly page_scroll: true;
-    readonly page_hover: true;
-    readonly page_eval: true;
-    readonly page_runtime: true;
-    readonly page_inspect: true;
-    readonly page_snapshot: true;
-    readonly page_press: true;
-    readonly page_wait: true;
-    readonly page_navigate: true;
-    readonly page_upload: true;
-    readonly page_frames: true;
-    readonly set_device_emulation: true;
-    readonly set_app_profile: true;
-    readonly set_timezone: true;
-    readonly get_cookie: true;
-    readonly set_cookie: true;
-    readonly request_domain_permission: true;
-    readonly run_actions: true;
-};
-export declare const BROWSER_CAPABILITY_ACTIONS: {
-    readonly page_download: true;
-    readonly tab_checkpoint: true;
-    readonly capture_checkpoint: true;
-    readonly get_requests: true;
-    readonly get_logs: true;
-    readonly get_events: true;
-    readonly set_mock: true;
-    readonly get_mocks: true;
-    readonly set_rule: true;
-    readonly get_rules: true;
-    readonly send_request: true;
-    readonly send_mtop_request: true;
-    readonly browser_release: true;
-    readonly page_screenshot: true;
-    readonly tab_open: true;
-    readonly tab_close: true;
-    readonly tab_list: true;
-    readonly tab_group: true;
-    readonly page_click: true;
-    readonly page_drag: true;
-    readonly page_type: true;
-    readonly page_scroll: true;
-    readonly page_hover: true;
-    readonly page_eval: true;
-    readonly page_runtime: true;
-    readonly page_inspect: true;
-    readonly page_snapshot: true;
-    readonly page_press: true;
-    readonly page_wait: true;
-    readonly page_navigate: true;
-    readonly page_upload: true;
-    readonly page_frames: true;
-    readonly set_device_emulation: true;
-    readonly set_app_profile: true;
-    readonly set_timezone: true;
-    readonly get_cookie: true;
-    readonly set_cookie: true;
-    readonly request_domain_permission: true;
-    readonly run_actions: true;
-};
-export declare function isBrowserAction(value: unknown): value is BrowserAction;
-export declare function isBrowserCommandAction(value: unknown): value is BrowserCommandAction;
-export declare function isBrowserCapabilityAction(value: unknown): value is BrowserCapabilityAction;
-export declare function isExtensionBrowserAction(value: unknown): value is ExtensionBrowserAction;
-export {};