ios-webkit-mcp 0.18.3

package/build/src/tools/type_text.js

@@ -0,0 +1,203 @@
+import { z } from 'zod';
+import { PageSession } from '../page-session.js';
+/**
+ * WIP gotcha: `Runtime.evaluate` with `awaitPromise:true` does NOT correctly
+ * serialize the resolved value of a returned Promise — even `Promise.resolve(42)`
+ * comes back as `{}`. So this tool MUST keep the inner expression synchronous.
+ * Per-char delay is implemented by issuing one Runtime.evaluate per character
+ * from TS land when `delayMs > 0`. When `delayMs === 0`, a single sync IIFE
+ * types the whole string in one round-trip.
+ */
+export const typeTextTool = {
+    name: 'type_text',
+    description: [
+        'Type text into the currently focused element (or a selector-targeted one) character-by-character on the inspected iOS WebView page.',
+        'NOTE: WIP has no `Input.dispatchKeyEvent`. Each character is simulated via `dispatchEvent(new KeyboardEvent(...))` for `keydown` + `keypress` + `keyup`, with the input value updated and an `input` event between keys. Listeners that read `event.isTrusted` will see `false`; IME / composition events are NOT replayed.',
+        'If `selector` is omitted, types into `document.activeElement`. Pass `clearFirst:true` to wipe the field before typing.',
+    ].join(' '),
+    inputSchema: {
+        text: z.string().min(1).describe('Text to type, one character at a time.'),
+        selector: z
+            .string()
+            .min(1)
+            .optional()
+            .describe('Optional CSS selector to focus before typing. If omitted uses document.activeElement.'),
+        nth: z
+            .number()
+            .int()
+            .min(0)
+            .optional()
+            .describe('When the selector matches multiple, pick the Nth (0-indexed). Default 0.'),
+        clearFirst: z
+            .boolean()
+            .optional()
+            .describe('Clear the field via value setter before typing. Default false.'),
+        delayMs: z
+            .number()
+            .int()
+            .min(0)
+            .max(500)
+            .optional()
+            .describe('Delay between characters (default 0). Use small values like 10–30 to mimic human cadence.'),
+        waitAfterMs: z
+            .number()
+            .int()
+            .min(0)
+            .max(10_000)
+            .optional()
+            .describe('Block after typing for this long (default 100).'),
+    },
+    handler: async ({ text, selector, nth = 0, clearFirst = false, delayMs = 0, waitAfterMs = 100, }) => {
+        let ps;
+        try {
+            ps = await PageSession.get();
+        }
+        catch (e) {
+            return errorResult(`Unable to attach to a WKWebView page: ${describe(e)}`);
+        }
+        const selJson = selector !== undefined ? JSON.stringify(selector) : 'null';
+        const prelude = `
+      (() => {
+        let el = null;
+        if (${selJson} !== null) {
+          const matches = document.querySelectorAll(${selJson});
+          if (matches.length === 0) return { ok: false, reason: 'no_match', selector: ${selJson} };
+          if (${nth} >= matches.length) return { ok: false, reason: 'nth_out_of_range', found: matches.length };
+          el = matches[${nth}];
+        } else {
+          el = document.activeElement;
+          if (!el || el === document.body) return { ok: false, reason: 'no_active_element' };
+        }
+        const tag = el.tagName.toLowerCase();
+        const isInput = tag === 'input' || tag === 'textarea';
+        const isCE = el.isContentEditable === true;
+        if (!isInput && !isCE) return { ok: false, reason: 'not_typable', tag };
+        try { el.focus(); } catch (e) {}
+        window.__wdm_type_target = el;
+        window.__wdm_type_mode = isInput ? 'input' : 'ce';
+        if (${clearFirst}) {
+          if (isInput) {
+            const proto = tag === 'input' ? HTMLInputElement.prototype : HTMLTextAreaElement.prototype;
+            const setter = Object.getOwnPropertyDescriptor(proto, 'value') && Object.getOwnPropertyDescriptor(proto, 'value').set;
+            if (setter) setter.call(el, ''); else el.value = '';
+          } else {
+            el.textContent = '';
+          }
+          el.dispatchEvent(new Event('input', { bubbles: true }));
+        }
+        return { ok: true, tag, mode: isInput ? 'input-keystroke' : 'contenteditable-keystroke' };
+      })()
+    `;
+        let pre;
+        try {
+            pre = await ps.session.send('Runtime.evaluate', { expression: prelude, returnByValue: true, awaitPromise: false }, 10_000);
+        }
+        catch (e) {
+            return errorResult(`Runtime.evaluate (type_text prelude) failed: ${describe(e)}`);
+        }
+        const preVal = pre?.result?.value;
+        if (!preVal || preVal.ok !== true) {
+            return errorResult(`# type_text: failed at prelude\n\n${JSON.stringify(preVal)}`);
+        }
+        const fastSync = `
+      (() => {
+        const el = window.__wdm_type_target;
+        const isInput = window.__wdm_type_mode === 'input';
+        const tag = el.tagName.toLowerCase();
+        const setter = isInput
+          ? (Object.getOwnPropertyDescriptor(tag === 'input' ? HTMLInputElement.prototype : HTMLTextAreaElement.prototype, 'value') || {}).set
+          : null;
+        const text = ${JSON.stringify(text)};
+        for (let i = 0; i < text.length; i++) {
+          const ch = text[i];
+          el.dispatchEvent(new KeyboardEvent('keydown', { bubbles: true, cancelable: true, key: ch }));
+          el.dispatchEvent(new KeyboardEvent('keypress', { bubbles: true, cancelable: true, key: ch }));
+          if (isInput) {
+            const next = (el.value || '') + ch;
+            if (setter) setter.call(el, next); else el.value = next;
+          } else {
+            el.textContent = (el.textContent || '') + ch;
+          }
+          el.dispatchEvent(new InputEvent('input', { bubbles: true, data: ch, inputType: 'insertText' }));
+          el.dispatchEvent(new KeyboardEvent('keyup', { bubbles: true, cancelable: true, key: ch }));
+        }
+        el.dispatchEvent(new Event('change', { bubbles: true }));
+        const finalValue = isInput ? el.value : el.textContent;
+        return { ok: true, chars: text.length, finalLen: (finalValue || '').length };
+      })()
+    `;
+        const perChar = (ch, isLast) => `
+      (() => {
+        const el = window.__wdm_type_target;
+        const isInput = window.__wdm_type_mode === 'input';
+        const tag = el.tagName.toLowerCase();
+        const setter = isInput
+          ? (Object.getOwnPropertyDescriptor(tag === 'input' ? HTMLInputElement.prototype : HTMLTextAreaElement.prototype, 'value') || {}).set
+          : null;
+        const ch = ${JSON.stringify(ch)};
+        el.dispatchEvent(new KeyboardEvent('keydown', { bubbles: true, cancelable: true, key: ch }));
+        el.dispatchEvent(new KeyboardEvent('keypress', { bubbles: true, cancelable: true, key: ch }));
+        if (isInput) {
+          const next = (el.value || '') + ch;
+          if (setter) setter.call(el, next); else el.value = next;
+        } else {
+          el.textContent = (el.textContent || '') + ch;
+        }
+        el.dispatchEvent(new InputEvent('input', { bubbles: true, data: ch, inputType: 'insertText' }));
+        el.dispatchEvent(new KeyboardEvent('keyup', { bubbles: true, cancelable: true, key: ch }));
+        ${isLast ? 'el.dispatchEvent(new Event("change", { bubbles: true }));' : ''}
+        const finalValue = isInput ? el.value : el.textContent;
+        return { ok: true, finalLen: (finalValue || '').length };
+      })()
+    `;
+        let finalLen = 0;
+        try {
+            if (delayMs === 0) {
+                const r = await ps.session.send('Runtime.evaluate', { expression: fastSync, returnByValue: true, awaitPromise: false }, 15_000);
+                const v = r?.result?.value;
+                if (!v || v.ok !== true) {
+                    return errorResult(`# type_text: failed at fast loop\n\n${JSON.stringify(v)}`);
+                }
+                finalLen = v.finalLen;
+            }
+            else {
+                for (let i = 0; i < text.length; i++) {
+                    const r = await ps.session.send('Runtime.evaluate', { expression: perChar(text[i], i === text.length - 1), returnByValue: true, awaitPromise: false }, 10_000);
+                    const v = r?.result?.value;
+                    if (!v || v.ok !== true) {
+                        return errorResult(`# type_text: failed at char ${i} (${JSON.stringify(text[i])})\n\n${JSON.stringify(v)}`);
+                    }
+                    finalLen = v.finalLen;
+                    if (i < text.length - 1) {
+                        await new Promise(r => setTimeout(r, delayMs));
+                    }
+                }
+            }
+        }
+        catch (e) {
+            return errorResult(`Runtime.evaluate (type_text loop) failed: ${describe(e)}`);
+        }
+        if (waitAfterMs > 0) {
+            await new Promise(r => setTimeout(r, waitAfterMs));
+        }
+        return textResult([
+            `# type_text ✓`,
+            '',
+            `tag: \`<${preVal.tag}>\` (mode: ${preVal.mode})`,
+            `chars typed: ${text.length}${delayMs > 0 ? ` (per-char, ${delayMs}ms between)` : ' (single sync round-trip)'}`,
+            `final field length: ${finalLen}`,
+            '',
+            '⚠ Synthetic KeyboardEvent sequence — `isTrusted=false`, no IME / composition. For fast bulk assignment use `fill`.',
+        ].join('\n'));
+    },
+};
+function textResult(text) {
+    return { content: [{ type: 'text', text }] };
+}
+function errorResult(text) {
+    return { content: [{ type: 'text', text }], isError: true };
+}
+function describe(e) {
+    return e instanceof Error ? e.message : String(e);
+}
+//# sourceMappingURL=type_text.js.map

package/build/src/tools/type_text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type_text.js","sourceRoot":"","sources":["../../../src/tools/type_text.ts"],"names":[],"mappings":"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"}

package/build/src/tools/wait_for.d.ts

@@ -0,0 +1,24 @@
+import { z } from 'zod';
+export declare const waitForTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        selector: z.ZodOptional<z.ZodString>;
+        text: z.ZodOptional<z.ZodString>;
+        expression: z.ZodOptional<z.ZodString>;
+        timeoutMs: z.ZodOptional<z.ZodNumber>;
+        pollMs: z.ZodOptional<z.ZodNumber>;
+    };
+    handler: ({ selector, text, expression, timeoutMs, pollMs, }: {
+        selector?: string;
+        text?: string;
+        expression?: string;
+        timeoutMs?: number;
+        pollMs?: number;
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};

package/build/src/tools/wait_for.js

@@ -0,0 +1,93 @@
+import { z } from 'zod';
+import { PageSession } from '../page-session.js';
+const DEFAULT_TIMEOUT_MS = 10_000;
+const DEFAULT_POLL_MS = 250;
+export const waitForTool = {
+    name: 'wait_for',
+    description: [
+        'Wait for a condition on the inspected iOS WebView page. Polls via `Runtime.evaluate` until the condition is met or timeout.',
+        'Modes (exactly one required):',
+        '  • `selector`: wait for `document.querySelector(selector)` to return non-null',
+        '  • `text`: wait for `document.body.textContent.includes(text)` to be true',
+        '  • `expression`: wait for the given JS expression to evaluate truthy',
+    ].join(' '),
+    inputSchema: {
+        selector: z.string().min(1).optional().describe('CSS selector to wait for.'),
+        text: z.string().min(1).optional().describe('Text substring to appear in document.body.textContent.'),
+        expression: z.string().min(1).optional().describe('JS expression — succeeds when truthy.'),
+        timeoutMs: z
+            .number()
+            .int()
+            .min(100)
+            .max(60_000)
+            .optional()
+            .describe(`Max time to wait (default ${DEFAULT_TIMEOUT_MS}).`),
+        pollMs: z
+            .number()
+            .int()
+            .min(50)
+            .max(5_000)
+            .optional()
+            .describe(`Polling interval (default ${DEFAULT_POLL_MS}).`),
+    },
+    handler: async ({ selector, text, expression, timeoutMs = DEFAULT_TIMEOUT_MS, pollMs = DEFAULT_POLL_MS, }) => {
+        const modes = [selector, text, expression].filter(x => x !== undefined).length;
+        if (modes !== 1) {
+            return errorResult(`Provide exactly one of: selector / text / expression (got ${modes}).`);
+        }
+        let ps;
+        try {
+            ps = await PageSession.get();
+        }
+        catch (e) {
+            return errorResult(`Unable to attach to a WKWebView page: ${describe(e)}`);
+        }
+        let probe;
+        let label;
+        if (selector !== undefined) {
+            probe = `(document.querySelector(${JSON.stringify(selector)}) !== null)`;
+            label = `selector \`${selector}\``;
+        }
+        else if (text !== undefined) {
+            probe = `(typeof document.body !== 'undefined' && (document.body.textContent || '').includes(${JSON.stringify(text)}))`;
+            label = `text \`${text}\``;
+        }
+        else {
+            probe = `Boolean(${expression})`;
+            label = `expression \`${expression.length > 60 ? expression.slice(0, 60) + '…' : expression}\``;
+        }
+        const deadline = Date.now() + timeoutMs;
+        let polls = 0;
+        while (Date.now() < deadline) {
+            polls++;
+            try {
+                const r = await ps.session.send('Runtime.evaluate', {
+                    expression: probe,
+                    returnByValue: true,
+                }, Math.max(2_000, pollMs));
+                if (r?.result?.value === true) {
+                    return textResult([
+                        `# wait_for ✓ ${label}`,
+                        '',
+                        `Matched after ${polls} poll(s) / ${Date.now() - (deadline - timeoutMs)}ms (timeout was ${timeoutMs}ms, poll ${pollMs}ms).`,
+                    ].join('\n'));
+                }
+            }
+            catch (e) {
+                return errorResult(`Runtime.evaluate during wait_for failed: ${describe(e)}`);
+            }
+            await new Promise(r => setTimeout(r, pollMs));
+        }
+        return errorResult(`# wait_for ✗ ${label} — timed out after ${timeoutMs}ms (${polls} polls)`);
+    },
+};
+function textResult(text) {
+    return { content: [{ type: 'text', text }] };
+}
+function errorResult(text) {
+    return { content: [{ type: 'text', text }], isError: true };
+}
+function describe(e) {
+    return e instanceof Error ? e.message : String(e);
+}
+//# sourceMappingURL=wait_for.js.map

package/build/src/tools/wait_for.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait_for.js","sourceRoot":"","sources":["../../../src/tools/wait_for.ts"],"names":[],"mappings":"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"}

package/build/src/tools/wip_send.d.ts

@@ -0,0 +1,22 @@
+import { z } from 'zod';
+export declare const wipSendTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        method: z.ZodString;
+        params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        timeoutMs: z.ZodOptional<z.ZodNumber>;
+        previewMaxLen: z.ZodOptional<z.ZodNumber>;
+    };
+    handler: ({ method, params, timeoutMs, previewMaxLen, }: {
+        method: string;
+        params?: Record<string, unknown>;
+        timeoutMs?: number;
+        previewMaxLen?: number;
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};

package/build/src/tools/wip_send.js

@@ -0,0 +1,81 @@
+import { z } from 'zod';
+import { PageSession } from '../page-session.js';
+export const wipSendTool = {
+    name: 'wip_send',
+    description: [
+        'Escape hatch — send an arbitrary WIP method through the shared PageSession with full envelope wrapping (`Target.sendMessageToTarget`).',
+        'Use this to probe new methods, drive Apple-specific domains (`CSS`, `Animation`, `Heap`, `DOMDebugger`, …) not yet wrapped by dedicated tools, or experiment before promoting to a real tool.',
+        'Returns the raw `result` payload on success, or a structured error with WIP error code/message.',
+    ].join(' '),
+    inputSchema: {
+        method: z
+            .string()
+            .min(1)
+            .describe('WIP method, e.g. `Page.getResourceTree`, `CSS.enable`, `Heap.gc`.'),
+        params: z
+            .record(z.unknown())
+            .optional()
+            .describe('Method params object. Omit for parameterless methods.'),
+        timeoutMs: z
+            .number()
+            .int()
+            .min(500)
+            .max(120_000)
+            .optional()
+            .describe('Per-call timeout (default 15000).'),
+        previewMaxLen: z
+            .number()
+            .int()
+            .min(100)
+            .max(500_000)
+            .optional()
+            .describe('Result JSON truncation cap (default 20000).'),
+    },
+    handler: async ({ method, params, timeoutMs = 15_000, previewMaxLen = 20_000, }) => {
+        let ps;
+        try {
+            ps = await PageSession.get();
+        }
+        catch (e) {
+            return errorResult(`Unable to attach to a WKWebView page: ${describe(e)}`);
+        }
+        let result;
+        try {
+            result = await ps.session.send(method, params, timeoutMs);
+        }
+        catch (e) {
+            const err = e;
+            const code = err.code;
+            const tag = code === -32601 ? '❌ NOT_FOUND' : code === -32602 ? '⚠ INVALID_PARAMS' : `⚠ ${code ?? '?'}`;
+            return errorResult([
+                `# wip_send ${tag} \`${method}\``,
+                '',
+                `params: ${JSON.stringify(params ?? {})}`,
+                '',
+                `error: ${err.message ?? describe(e)}`,
+            ].join('\n'));
+        }
+        const json = JSON.stringify(result, null, 2) ?? 'null';
+        const body = json.length > previewMaxLen ? json.slice(0, previewMaxLen) + `\n… (truncated, full length ${json.length})` : json;
+        return textResult([
+            `# wip_send ✓ \`${method}\``,
+            '',
+            `params: ${JSON.stringify(params ?? {})}`,
+            '',
+            '## result',
+            '```json',
+            body,
+            '```',
+        ].join('\n'));
+    },
+};
+function textResult(text) {
+    return { content: [{ type: 'text', text }] };
+}
+function errorResult(text) {
+    return { content: [{ type: 'text', text }], isError: true };
+}
+function describe(e) {
+    return e instanceof Error ? e.message : String(e);
+}
+//# sourceMappingURL=wip_send.js.map

package/build/src/tools/wip_send.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wip_send.js","sourceRoot":"","sources":["../../../src/tools/wip_send.ts"],"names":[],"mappings":"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"}

package/build/src/wip-client/iwdp-http.d.ts

@@ -0,0 +1,17 @@
+export interface ProxyDevice {
+    deviceId: string;
+    deviceName: string;
+    deviceOSVersion?: string;
+    url: string;
+}
+export interface DevicePage {
+    id: string;
+    title: string;
+    url: string;
+    type?: string;
+    webSocketDebuggerUrl: string;
+    webkitVersion?: string;
+    description?: string;
+}
+export declare function fetchProxyDevices(deviceListBaseUrl: string): Promise<ProxyDevice[]>;
+export declare function fetchDevicePages(deviceUrl: string): Promise<DevicePage[]>;

package/build/src/wip-client/iwdp-http.js

@@ -0,0 +1,98 @@
+/**
+ * Minimal HTTP client for ios_webkit_debug_proxy's HTTP endpoints.
+ *
+ * Endpoint shapes (verified against v1.9.2 default config `null:9221,:9222-9322`):
+ *
+ *   GET http://127.0.0.1:9221/json            → array of devices with `url` pointing to per-device port
+ *   GET http://127.0.0.1:<devicePort>/json/list → array of inspectable pages on that device
+ *
+ * The returned `webSocketDebuggerUrl` looks like CDP but frames are Apple WIP (proxy is transport, not translator).
+ */
+import { request as httpRequest } from 'node:http';
+export async function fetchProxyDevices(deviceListBaseUrl) {
+    const json = await httpGetJson(stripTrailingSlash(deviceListBaseUrl) + '/json');
+    if (!Array.isArray(json))
+        return [];
+    return json
+        .map((entry) => {
+        const url = entry.url;
+        if (typeof url !== 'string' || url.length === 0)
+            return null;
+        const r = entry;
+        return {
+            deviceId: String(r.deviceId ?? 'unknown'),
+            deviceName: String(r.deviceName ?? ''),
+            deviceOSVersion: typeof r.deviceOSVersion === 'string' ? r.deviceOSVersion : undefined,
+            url,
+        };
+    })
+        .filter((d) => d !== null);
+}
+export async function fetchDevicePages(deviceUrl) {
+    const baseUrl = normalizeToHttp(deviceUrl);
+    const json = await httpGetJson(baseUrl + '/json/list');
+    if (!Array.isArray(json))
+        return [];
+    return json.map((p) => {
+        const o = p;
+        const wsUrl = typeof o.webSocketDebuggerUrl === 'string' ? o.webSocketDebuggerUrl : '';
+        // /json/list response on ios_webkit_debug_proxy v1.9.2 omits `id`;
+        // the page id is the trailing segment of `webSocketDebuggerUrl` (e.g. ".../devtools/page/7" → "7").
+        const idFromField = typeof o.id === 'string' || typeof o.id === 'number' ? String(o.id) : '';
+        const idFromUrl = wsUrl.match(/\/devtools\/page\/([^/?]+)$/)?.[1] ?? '';
+        return {
+            id: idFromField || idFromUrl,
+            title: typeof o.title === 'string' ? o.title : '',
+            url: typeof o.url === 'string' ? o.url : '',
+            type: typeof o.type === 'string' ? o.type : undefined,
+            webSocketDebuggerUrl: wsUrl,
+            webkitVersion: typeof o.webkitVersion === 'string' ? o.webkitVersion : undefined,
+            description: typeof o.description === 'string' ? o.description : undefined,
+        };
+    });
+}
+function normalizeToHttp(input) {
+    let s = stripTrailingSlash(input);
+    if (s.startsWith('ws://'))
+        s = 'http://' + s.slice('ws://'.length);
+    else if (s.startsWith('wss://'))
+        s = 'https://' + s.slice('wss://'.length);
+    else if (!/^https?:\/\//.test(s))
+        s = 'http://' + s;
+    return s;
+}
+function stripTrailingSlash(s) {
+    return s.endsWith('/') ? s.slice(0, -1) : s;
+}
+function httpGetJson(urlStr, timeoutMs = 5000) {
+    return new Promise((resolve, reject) => {
+        const url = new URL(urlStr);
+        const req = httpRequest({
+            hostname: url.hostname,
+            port: url.port || 80,
+            path: url.pathname + url.search,
+            method: 'GET',
+            timeout: timeoutMs,
+        }, res => {
+            const chunks = [];
+            res.on('data', c => chunks.push(c));
+            res.on('end', () => {
+                const body = Buffer.concat(chunks).toString('utf8');
+                if ((res.statusCode ?? 0) >= 400) {
+                    reject(new Error(`HTTP ${res.statusCode} from ${urlStr}: ${body.slice(0, 200)}`));
+                    return;
+                }
+                try {
+                    resolve(JSON.parse(body));
+                }
+                catch {
+                    reject(new Error(`Non-JSON response from ${urlStr}: ${body.slice(0, 200)}`));
+                }
+            });
+        });
+        req.on('error', reject);
+        req.on('timeout', () => req.destroy(new Error(`Timeout (${timeoutMs}ms) fetching ${urlStr}`)));
+        req.end();
+    });
+}
+//# sourceMappingURL=iwdp-http.js.map

package/build/src/wip-client/iwdp-http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"iwdp-http.js","sourceRoot":"","sources":["../../../src/wip-client/iwdp-http.ts"],"names":[],"mappings":"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"}

package/build/src/wip-client/ws-session.d.ts

@@ -0,0 +1,41 @@
+export interface WipTargetInfo {
+    targetId: string;
+    type: string;
+    [key: string]: unknown;
+}
+type EventHandler = (params: unknown) => void;
+export declare class WipSession {
+    private ws;
+    private nextOuterId;
+    private nextInnerId;
+    private readonly pending;
+    private readonly events;
+    private readonly targets;
+    private pageTargetId;
+    private pageTargetWaiters;
+    private closed;
+    connect(url: string, timeoutMs?: number): Promise<void>;
+    /**
+     * Wait until a `Target.targetCreated` event with type=page arrives.
+     * Resolves immediately if a page target has already been seen.
+     */
+    waitForPageTarget(timeoutMs?: number): Promise<WipTargetInfo>;
+    /**
+     * Send an inner JSON-RPC request to the page target, wrapped in
+     * Target.sendMessageToTarget. Resolves with the inner result.
+     */
+    send<R = unknown>(method: string, params?: unknown, timeoutMs?: number): Promise<R>;
+    sendToTarget<R = unknown>(targetId: string, method: string, params?: unknown, timeoutMs?: number): Promise<R>;
+    /**
+     * Subscribe to a domain event (e.g. `Console.messageAdded`,
+     * `Network.requestWillBeSent`). Handlers receive the inner `params`.
+     */
+    on(event: string, handler: EventHandler): () => void;
+    close(): void;
+    getTargets(): WipTargetInfo[];
+    private handleOuter;
+    private handleInner;
+    private dispatchEvent;
+    private handleClose;
+}
+export {};