ios-webkit-mcp 0.18.3

package/build/src/tools/list_pages.js

@@ -0,0 +1,113 @@
+import { z } from 'zod';
+import { fetchProxyDevices, fetchDevicePages } from '../wip-client/iwdp-http.js';
+const DEFAULT_PROXY_BASE = 'http://127.0.0.1:9221';
+export const listPagesTool = {
+    name: 'list_pages',
+    description: [
+        'List iOS WebView pages currently inspectable via ios_webkit_debug_proxy.',
+        'Requires the proxy to be running with an iPhone connected and Web Inspector enabled.',
+        'Returns one row per page (id, type, title, url) plus the raw WIP webSocketDebuggerUrl.',
+        'NOTE: webSocketDebuggerUrl path looks chromium-style but frame content is Apple WIP, not CDP.',
+    ].join(' '),
+    inputSchema: {
+        proxyDeviceListUrl: z
+            .string()
+            .url()
+            .optional()
+            .describe(`Base URL of ios_webkit_debug_proxy's device-list endpoint (default ${DEFAULT_PROXY_BASE})`),
+    },
+    handler: async ({ proxyDeviceListUrl, }) => {
+        const base = proxyDeviceListUrl ?? DEFAULT_PROXY_BASE;
+        let devices;
+        try {
+            devices = await fetchProxyDevices(base);
+        }
+        catch (e) {
+            return errorResult(`Failed to reach ios_webkit_debug_proxy at ${base}: ${describeError(e)}\n\nIs the proxy running? Try: pgrep -fl ios_webkit_debug_proxy`);
+        }
+        if (devices.length === 0) {
+            return textResult([
+                '# No iOS devices found',
+                '',
+                'Possible causes:',
+                '- iPhone not connected via USB',
+                '- iPhone has not trusted this Mac (check `idevice_id -l`)',
+                '- Settings > Safari > Advanced > Web Inspector is OFF',
+                '- ios_webkit_debug_proxy is not running',
+            ].join('\n'));
+        }
+        const allPages = [];
+        const deviceErrors = [];
+        for (const dev of devices) {
+            try {
+                const pages = await fetchDevicePages(dev.url);
+                pages.forEach((p, idx) => {
+                    allPages.push({
+                        deviceId: dev.deviceId,
+                        idx,
+                        id: p.id,
+                        title: p.title,
+                        url: p.url,
+                        type: p.type ?? 'page',
+                        webSocketDebuggerUrl: p.webSocketDebuggerUrl,
+                    });
+                });
+            }
+            catch (e) {
+                deviceErrors.push({ deviceId: dev.deviceId, error: describeError(e) });
+            }
+        }
+        if (allPages.length === 0) {
+            const lines = [
+                `# No inspectable pages on ${devices.length} device(s)`,
+                '',
+                `Devices found: ${devices.map(d => d.deviceId).join(', ')}`,
+                '',
+                'Make sure the target app has a WebView/Safari page open AND the WKWebView has `isInspectable = true` (iOS 16.4+ requirement).',
+            ];
+            if (deviceErrors.length > 0) {
+                lines.push('', '## Errors fetching device pages');
+                for (const e of deviceErrors) {
+                    lines.push(`- ${e.deviceId}: ${e.error}`);
+                }
+            }
+            return textResult(lines.join('\n'));
+        }
+        const pageCount = allPages.filter(p => p.url && !p.title.startsWith('jsi_')).length;
+        const workerCount = allPages.length - pageCount;
+        const md = [
+            `# ${allPages.length} inspectable target(s) on ${devices.length} device(s) — ${pageCount} WKWebView page(s), ${workerCount} JSCore worker(s)`,
+            '',
+            '| # | kind | device | id | title | url |',
+            '|---|------|--------|----|-------|-----|',
+        ];
+        allPages.forEach((p, i) => {
+            const kind = p.url && !p.title.startsWith('jsi_') ? 'page' : 'worker';
+            md.push(`| ${i} | ${kind} | \`${p.deviceId.slice(0, 12)}${p.deviceId.length > 12 ? '…' : ''}\` | ${p.id} | ${escapeCell(p.title)} | ${escapeCell(p.url)} |`);
+        });
+        md.push('', '## webSocketDebuggerUrl (raw WIP frames, not CDP)', '');
+        allPages.forEach((p, i) => md.push(`- [${i}] \`${p.webSocketDebuggerUrl}\``));
+        if (deviceErrors.length > 0) {
+            md.push('', '## Devices with errors', '');
+            for (const e of deviceErrors) {
+                md.push(`- ${e.deviceId}: ${e.error}`);
+            }
+        }
+        return textResult(md.join('\n'));
+    },
+};
+function textResult(text) {
+    return { content: [{ type: 'text', text }] };
+}
+function errorResult(text) {
+    return { content: [{ type: 'text', text }], isError: true };
+}
+function escapeCell(s) {
+    return s.replace(/\|/g, '\\|').replace(/\n/g, ' ');
+}
+function describeError(e) {
+    if (e instanceof Error)
+        return e.message;
+    return String(e);
+}
+//# sourceMappingURL=list_pages.js.map

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

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

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

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

package/build/src/tools/navigate_page.js

@@ -0,0 +1,73 @@
+import { z } from 'zod';
+import { PageSession } from '../page-session.js';
+export const navigatePageTool = {
+    name: 'navigate_page',
+    description: [
+        'Navigate the inspected iOS WebView page to a new URL.',
+        'NOTE: WIP `Page.navigate` is NOT implemented on iOS (-32601). This tool falls back to `Runtime.evaluate` setting `location.href` — semantics match a regular client-side navigation, but you cannot abort/intercept the way Page.navigate would allow.',
+        'After issuing, call `list_pages` to confirm the new page id (it may change if the navigation crosses an origin boundary).',
+    ].join(' '),
+    inputSchema: {
+        url: z.string().url().describe('Target URL (must be absolute http(s) or about: URL).'),
+        waitMs: z
+            .number()
+            .int()
+            .min(0)
+            .max(60_000)
+            .optional()
+            .describe('Block this long after issuing navigation to let load events settle (default 1500).'),
+    },
+    handler: async ({ url, waitMs = 1500 }) => {
+        let ps;
+        try {
+            ps = await PageSession.get();
+        }
+        catch (e) {
+            return errorResult(`Unable to attach to a WKWebView page: ${describe(e)}`);
+        }
+        const safe = JSON.stringify(url);
+        try {
+            await ps.session.send('Runtime.evaluate', {
+                expression: `location.href = ${safe}`,
+                returnByValue: true,
+                awaitPromise: false,
+            });
+        }
+        catch (e) {
+            return errorResult(`Runtime.evaluate (navigation) failed: ${describe(e)}`);
+        }
+        if (waitMs > 0) {
+            await new Promise(r => setTimeout(r, waitMs));
+        }
+        // Verify by reading location.href back
+        let after = '(unread)';
+        try {
+            const r = await ps.session.send('Runtime.evaluate', {
+                expression: 'location.href',
+                returnByValue: true,
+            });
+            after = String(r?.result?.value ?? '(unread)');
+        }
+        catch {
+            // ignore — page may have detached
+        }
+        return textResult([
+            `# navigate_page`,
+            '',
+            `Requested: ${url}`,
+            `After ${waitMs}ms: ${after}`,
+            '',
+            '⚠ Page.navigate is not implemented on iOS WIP; this used `location.href = …` instead. If a redirect happened, the URL above is the final landing.',
+        ].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=navigate_page.js.map

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

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

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

@@ -0,0 +1,51 @@
+/**
+ * batch-13 Should network runtime controls.
+ *
+ *   - `set_resource_caching_disabled` — `Network.setResourceCachingDisabled`
+ *   - `set_request_interception`      — `Network.setInterceptionEnabled` (enable-only switch)
+ *
+ * `Network.{interceptContinue, interceptWithResponse}` are deferred to batch-14
+ * with a complete fulfill/continue state machine — exposing only the on/off
+ * switch here avoids the "能力幻觉" pitfall raised in cross-review v2.0.1 R3
+ * (LLM sees `intercept_request` and assumes it can fulfill).
+ *
+ * Probe-confirmed (2026-05-17):
+ *   - Network.setInterceptionEnabled ✅
+ *   - Network.setResourceCachingDisabled ✅
+ *   - Network.addInterception ✅ (not exposed yet — needed for fulfill)
+ */
+import { z } from 'zod';
+export declare const setResourceCachingDisabledTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        disabled: z.ZodBoolean;
+    };
+    handler: ({ disabled }: {
+        disabled: boolean;
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};
+export declare const setRequestInterceptionTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        enabled: z.ZodBoolean;
+        urlPattern: z.ZodOptional<z.ZodString>;
+        stage: z.ZodOptional<z.ZodEnum<["request", "response"]>>;
+    };
+    handler: ({ enabled, urlPattern, stage }: {
+        enabled: boolean;
+        urlPattern?: string;
+        stage?: "request" | "response";
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};

package/build/src/tools/network_runtime.js

@@ -0,0 +1,101 @@
+/**
+ * batch-13 Should network runtime controls.
+ *
+ *   - `set_resource_caching_disabled` — `Network.setResourceCachingDisabled`
+ *   - `set_request_interception`      — `Network.setInterceptionEnabled` (enable-only switch)
+ *
+ * `Network.{interceptContinue, interceptWithResponse}` are deferred to batch-14
+ * with a complete fulfill/continue state machine — exposing only the on/off
+ * switch here avoids the "能力幻觉" pitfall raised in cross-review v2.0.1 R3
+ * (LLM sees `intercept_request` and assumes it can fulfill).
+ *
+ * Probe-confirmed (2026-05-17):
+ *   - Network.setInterceptionEnabled ✅
+ *   - Network.setResourceCachingDisabled ✅
+ *   - Network.addInterception ✅ (not exposed yet — needed for fulfill)
+ */
+import { z } from 'zod';
+import { PageSession } from '../page-session.js';
+export const setResourceCachingDisabledTool = {
+    name: 'set_resource_caching_disabled',
+    description: [
+        'Enable or disable resource caching for the current page session via WIP `Network.setResourceCachingDisabled` (✅ probe 2026-05-17).',
+        'Useful for hot-debugging — flip on to force every reload to refetch CSS/JS/images even when ETag would normally serve from cache.',
+        'State persists for the life of the WIP session; auto-cleared when the MCP server restarts. Reload the page after toggling for the new state to take effect.',
+    ].join(' '),
+    inputSchema: {
+        disabled: z.boolean().describe('`true` disables cache (force network fetch); `false` re-enables normal caching.'),
+    },
+    handler: async ({ disabled }) => {
+        let ps;
+        try {
+            ps = await PageSession.get();
+        }
+        catch (e) {
+            return errorResult(`Unable to attach: ${describe(e)}`);
+        }
+        try {
+            await ps.session.send('Network.setResourceCachingDisabled', { disabled }, 5_000);
+        }
+        catch (e) {
+            return errorResult(`Network.setResourceCachingDisabled failed: ${describe(e)}`);
+        }
+        return textResult(`# set_resource_caching_disabled ✓ \`${disabled}\`\n\n` +
+            (disabled
+                ? 'Cache disabled. Subsequent navigations will force re-fetch all resources. Reload the page to see effect.'
+                : 'Cache re-enabled. Normal HTTP cache semantics apply.'));
+    },
+};
+export const setRequestInterceptionTool = {
+    name: 'set_request_interception',
+    description: [
+        'Enable or disable global request interception via WIP `Network.setInterceptionEnabled` + `Network.addInterception` (✅ probe 2026-05-17).',
+        'Apple WIP requires BOTH the master switch AND at least one URL pattern in `addInterception` to actually intercept requests. This tool wires them together: enable=true with `urlPattern` adds the pattern; enable=false clears.',
+        'Pair with `list_intercepted_requests` + `intercept_continue` + `intercept_respond` for fulfill/continue. PageSession buffers pending intercepted requests (cap 16, 30s auto-continue safety net) so the page never hangs.',
+        '⚠ **iOS WKWebView limitation (实测 2026-05-17)**: methods all return `{}` but `Network.requestIntercepted` event is NOT fired on iOS 26.5 — interception runtime is a no-op. Works on macOS Safari per iwdp-mcp. Tool kept for future iOS builds + macOS contexts.',
+    ].join(' '),
+    inputSchema: {
+        enabled: z.boolean().describe('`true` enables interception with the given `urlPattern`; `false` disables and removes all patterns.'),
+        urlPattern: z
+            .string()
+            .optional()
+            .describe('URL substring/glob pattern to intercept when enabled (default `*` matches all). Apple WIP wildcard semantics — `*` matches any prefix/suffix.'),
+        stage: z
+            .enum(['request', 'response'])
+            .optional()
+            .describe('Intercept at request issue (`request`, default) or response receipt (`response`).'),
+    },
+    handler: async ({ enabled, urlPattern = '*', stage = 'request' }) => {
+        let ps;
+        try {
+            ps = await PageSession.get();
+        }
+        catch (e) {
+            return errorResult(`Unable to attach: ${describe(e)}`);
+        }
+        try {
+            if (enabled) {
+                await ps.session.send('Network.setInterceptionEnabled', { enabled: true }, 5_000);
+                await ps.session.send('Network.addInterception', { url: urlPattern, stage }, 5_000);
+                return textResult('# set_request_interception ✓ `enabled`\n\n' +
+                    `URL pattern: \`${urlPattern}\` (stage=${stage})\n\n` +
+                    'Matching requests now suspend awaiting a decision. PageSession buffers pending (cap 16, 30s auto-continue safety net). ' +
+                    'Use `list_intercepted_requests` to inspect, `intercept_continue` to release/abort, or `intercept_respond` to mock a response.');
+            }
+            // Disable path: remove the pattern, then disable master switch.
+            try {
+                await ps.session.send('Network.removeInterception', { url: urlPattern, stage }, 5_000);
+            }
+            catch { /* may have been added with diff pattern */ }
+            await ps.session.send('Network.setInterceptionEnabled', { enabled: false }, 5_000);
+            return textResult('# set_request_interception ✓ `disabled`\n\nInterception cleared. Pending intercepted requests release.');
+        }
+        catch (e) {
+            return errorResult(`set_request_interception failed: ${describe(e)}`);
+        }
+    },
+};
+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=network_runtime.js.map

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

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

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

@@ -0,0 +1,32 @@
+import { z } from 'zod';
+export declare const pressKeyTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        key: z.ZodString;
+        code: z.ZodOptional<z.ZodString>;
+        selector: z.ZodOptional<z.ZodString>;
+        nth: z.ZodOptional<z.ZodNumber>;
+        shift: z.ZodOptional<z.ZodBoolean>;
+        ctrl: z.ZodOptional<z.ZodBoolean>;
+        alt: z.ZodOptional<z.ZodBoolean>;
+        meta: z.ZodOptional<z.ZodBoolean>;
+        waitAfterMs: z.ZodOptional<z.ZodNumber>;
+    };
+    handler: ({ key, code, selector, nth, shift, ctrl, alt, meta, waitAfterMs, }: {
+        key: string;
+        code?: string;
+        selector?: string;
+        nth?: number;
+        shift?: boolean;
+        ctrl?: boolean;
+        alt?: boolean;
+        meta?: boolean;
+        waitAfterMs?: number;
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};

package/build/src/tools/press_key.js

@@ -0,0 +1,108 @@
+import { z } from 'zod';
+import { PageSession } from '../page-session.js';
+export const pressKeyTool = {
+    name: 'press_key',
+    description: [
+        'Dispatch a single key press (`keydown` + `keyup`, plus `keypress` for printable keys) on the inspected iOS WebView page.',
+        'NOTE: WIP has no `Input.dispatchKeyEvent`. This is a synthetic `KeyboardEvent` dispatched via `Runtime.evaluate` — listeners see `isTrusted=false`, and browser default actions (form submit on Enter, scrolling on PageDown) will NOT fire unless explicitly triggered by JS handlers.',
+        'Target is `document.activeElement` by default. Pass `selector` to focus an element first.',
+    ].join(' '),
+    inputSchema: {
+        key: z.string().min(1).describe('KeyboardEvent.key value, e.g. "Enter", "ArrowDown", "a", "Escape".'),
+        code: z.string().optional().describe('KeyboardEvent.code, e.g. "Enter", "ArrowDown", "KeyA". Defaults to a guess from key.'),
+        selector: z.string().optional().describe('Optional CSS selector to focus before dispatching.'),
+        nth: z.number().int().min(0).optional().describe('Pick the Nth selector match. Default 0.'),
+        shift: z.boolean().optional().describe('Hold Shift modifier. Default false.'),
+        ctrl: z.boolean().optional().describe('Hold Control modifier. Default false.'),
+        alt: z.boolean().optional().describe('Hold Alt modifier. Default false.'),
+        meta: z.boolean().optional().describe('Hold Meta (⌘) modifier. Default false.'),
+        waitAfterMs: z.number().int().min(0).max(10_000).optional().describe('Block after press for this long (default 100).'),
+    },
+    handler: async ({ key, code, selector, nth = 0, shift = false, ctrl = false, alt = false, meta = false, 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 keyJson = JSON.stringify(key);
+        const codeJson = JSON.stringify(code ?? guessCode(key));
+        const expression = `
+      (() => {
+        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}];
+          try { el.focus(); } catch (e) {}
+        } else {
+          el = document.activeElement || document.body;
+        }
+        const init = {
+          bubbles: true,
+          cancelable: true,
+          key: ${keyJson},
+          code: ${codeJson},
+          shiftKey: ${shift},
+          ctrlKey: ${ctrl},
+          altKey: ${alt},
+          metaKey: ${meta},
+        };
+        const tag = el.tagName ? el.tagName.toLowerCase() : '#';
+        try {
+          el.dispatchEvent(new KeyboardEvent('keydown', init));
+          if (${keyJson}.length === 1) el.dispatchEvent(new KeyboardEvent('keypress', init));
+          el.dispatchEvent(new KeyboardEvent('keyup', init));
+        } catch (e) {
+          return { ok: false, reason: 'dispatch_threw', error: String(e), tag };
+        }
+        return { ok: true, tag, target: ${selJson} === null ? 'activeElement' : ${selJson} };
+      })()
+    `;
+        let result;
+        try {
+            result = await ps.session.send('Runtime.evaluate', { expression, returnByValue: true, awaitPromise: false }, 10_000);
+        }
+        catch (e) {
+            return errorResult(`Runtime.evaluate (press_key) failed: ${describe(e)}`);
+        }
+        if (waitAfterMs > 0) {
+            await new Promise(r => setTimeout(r, waitAfterMs));
+        }
+        const v = result?.result?.value;
+        if (!v || v.ok !== true) {
+            return errorResult(`# press_key: failed\n\n${JSON.stringify(v)}`);
+        }
+        const mods = [shift && 'Shift', ctrl && 'Ctrl', alt && 'Alt', meta && 'Meta'].filter(Boolean).join('+');
+        return textResult([
+            `# press_key ✓ ${mods ? mods + '+' : ''}${key}`,
+            '',
+            `target: ${v.target}`,
+            `tag: \`<${v.tag}>\``,
+            '',
+            '⚠ Synthetic KeyboardEvent — `isTrusted=false`, browser default actions (form submit, scroll) suppressed unless app JS handlers invoke them.',
+        ].join('\n'));
+    },
+};
+function guessCode(key) {
+    if (key.length === 1) {
+        if (/[a-zA-Z]/.test(key))
+            return 'Key' + key.toUpperCase();
+        if (/[0-9]/.test(key))
+            return 'Digit' + key;
+    }
+    return key;
+}
+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=press_key.js.map

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

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

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

@@ -0,0 +1,22 @@
+import { z } from 'zod';
+export declare const queryDomNodeTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        selector: z.ZodString;
+        mode: z.ZodOptional<z.ZodEnum<["first", "all"]>>;
+        maxMatches: z.ZodOptional<z.ZodNumber>;
+        perNodeMaxLen: z.ZodOptional<z.ZodNumber>;
+    };
+    handler: ({ selector, mode, maxMatches, perNodeMaxLen, }: {
+        selector: string;
+        mode?: "first" | "all";
+        maxMatches?: number;
+        perNodeMaxLen?: number;
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};

package/build/src/tools/query_dom_node.js

@@ -0,0 +1,103 @@
+import { z } from 'zod';
+import { PageSession } from '../page-session.js';
+export const queryDomNodeTool = {
+    name: 'query_dom_node',
+    description: [
+        'Query and serialize matching DOM nodes on the inspected iOS WebView page via WIP `DOM.querySelector(All)` + `DOM.getOuterHTML`.',
+        'Targeted alternative to `take_snapshot` (which dumps whole document). Useful when the AI needs only a specific element\'s HTML — saves context and lets you scope inspection.',
+        'Probe-confirmed chain (2026-05-16): `DOM.getDocument` → `DOM.querySelector` / `DOM.querySelectorAll` → `DOM.getOuterHTML`. `DOM.enable` is NOT required.',
+    ].join(' '),
+    inputSchema: {
+        selector: z.string().min(1).describe('CSS selector to query.'),
+        mode: z
+            .enum(['first', 'all'])
+            .optional()
+            .describe('`first` (default) = querySelector single match; `all` = querySelectorAll multiple matches.'),
+        maxMatches: z
+            .number()
+            .int()
+            .min(1)
+            .max(200)
+            .optional()
+            .describe('When mode=all, cap returned matches (default 20).'),
+        perNodeMaxLen: z
+            .number()
+            .int()
+            .min(100)
+            .max(100_000)
+            .optional()
+            .describe('Per-node outerHTML truncation cap (default 4000).'),
+    },
+    handler: async ({ selector, mode = 'first', maxMatches = 20, perNodeMaxLen = 4_000, }) => {
+        let ps;
+        try {
+            ps = await PageSession.get();
+        }
+        catch (e) {
+            return errorResult(`Unable to attach to a WKWebView page: ${describe(e)}`);
+        }
+        let rootId;
+        try {
+            const doc = await ps.session.send('DOM.getDocument', { depth: 0 }, 10_000);
+            rootId = doc.root.nodeId;
+        }
+        catch (e) {
+            return errorResult(`DOM.getDocument failed: ${describe(e)}`);
+        }
+        let nodeIds = [];
+        try {
+            if (mode === 'first') {
+                const r = await ps.session.send('DOM.querySelector', { nodeId: rootId, selector }, 10_000);
+                if (r.nodeId === 0) {
+                    return textResult(`# query_dom_node — 0 matches for \`${selector}\``);
+                }
+                nodeIds = [r.nodeId];
+            }
+            else {
+                const r = await ps.session.send('DOM.querySelectorAll', { nodeId: rootId, selector }, 10_000);
+                nodeIds = (r.nodeIds || []).slice(0, maxMatches);
+            }
+        }
+        catch (e) {
+            return errorResult(`DOM.querySelector${mode === 'all' ? 'All' : ''} failed: ${describe(e)}`);
+        }
+        const lines = [
+            `# query_dom_node — \`${selector}\` (mode=${mode})`,
+            '',
+            `Matches: ${nodeIds.length}${mode === 'all' && nodeIds.length === maxMatches ? ` (capped at ${maxMatches})` : ''}`,
+            '',
+        ];
+        for (let i = 0; i < nodeIds.length; i++) {
+            const nodeId = nodeIds[i];
+            let html;
+            try {
+                const r = await ps.session.send('DOM.getOuterHTML', { nodeId }, 10_000);
+                html = r.outerHTML ?? '';
+            }
+            catch (e) {
+                lines.push(`## [${i + 1}] nodeId=${nodeId} — getOuterHTML failed: ${describe(e)}`);
+                lines.push('');
+                continue;
+            }
+            const truncated = html.length > perNodeMaxLen
+                ? html.slice(0, perNodeMaxLen) + `\n… (truncated, full length ${html.length})`
+                : html;
+            lines.push(`## [${i + 1}] nodeId=${nodeId} · ${html.length} bytes`);
+            lines.push('```html');
+            lines.push(truncated);
+            lines.push('```');
+            lines.push('');
+        }
+        return textResult(lines.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=query_dom_node.js.map