ios-webkit-mcp 0.18.3

package/build/src/tools/get_event_listeners.js

@@ -0,0 +1,129 @@
+/**
+ * `get_event_listeners` (batch-13 Must) — list event listeners bound to a DOM
+ * node via WIP `DOM.getEventListenersForNode`.
+ *
+ * Probe-confirmed 2026-05-17 (capability matrix v2): the method exists and
+ * returns `-32000 Missing node for given nodeId` when called without a valid
+ * id, so chain through DOM.getDocument → querySelector first.
+ *
+ * Returns one row per listener with type / useCapture / passive / sourceURL +
+ * line. Distinguishes inline (set via attribute) vs addEventListener.
+ */
+import { z } from 'zod';
+import { PageSession } from '../page-session.js';
+export const getEventListenersTool = {
+    name: 'get_event_listeners',
+    description: [
+        'List event listeners bound to a DOM node (matched by CSS selector) via WIP `DOM.getEventListenersForNode` (✅ probe 2026-05-17).',
+        'Useful to debug "which handler fires on click", catch stale listeners, audit passive/useCapture flags, and find the source script:line of the handler.',
+        'Chain: DOM.getDocument → DOM.querySelector → DOM.getEventListenersForNode. Returns first match only (use `query_dom_node` first if you need to disambiguate).',
+    ].join(' '),
+    inputSchema: {
+        selector: z.string().min(1).describe('CSS selector matching exactly one node (first match used).'),
+        includeAncestors: z
+            .boolean()
+            .optional()
+            .describe('Walk up parentNode chain and aggregate listeners (default false → target node only). Useful for capture-phase / delegated listeners.'),
+    },
+    handler: async ({ selector, includeAncestors = false }) => {
+        let ps;
+        try {
+            ps = await PageSession.get();
+        }
+        catch (e) {
+            return errorResult(`Unable to attach: ${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 nodeId;
+        try {
+            const r = await ps.session.send('DOM.querySelector', { nodeId: rootId, selector }, 10_000);
+            if (r.nodeId === 0)
+                return textResult(`# get_event_listeners — 0 nodes match \`${selector}\``);
+            nodeId = r.nodeId;
+        }
+        catch (e) {
+            return errorResult(`DOM.querySelector failed: ${describe(e)}`);
+        }
+        const queryNodes = [nodeId];
+        if (includeAncestors) {
+            // Use Runtime.evaluate to enumerate ancestor nodeIds via the inspector remote object trick.
+            // WIP doesn't expose DOM.getParent directly; we walk through getOuterHTML chain via element bridge.
+            // Cheaper: iterate up to body via Runtime call returning a list of ancestor selectors → re-query each.
+            try {
+                const r = await ps.session.send('Runtime.evaluate', {
+                    expression: `(() => {
+              const el = document.querySelector(${JSON.stringify(selector)});
+              if (!el) return [];
+              const out = [];
+              let n = el.parentElement;
+              while (n && n !== document.body) {
+                let s = n.tagName.toLowerCase();
+                if (n.id) s += '#' + CSS.escape(n.id);
+                else if (n.className && typeof n.className === 'string') s += '.' + n.className.trim().split(/\\s+/).slice(0, 2).join('.');
+                out.push(s);
+                n = n.parentElement;
+              }
+              return out;
+            })()`,
+                    returnByValue: true,
+                }, 10_000);
+                const ancestors = r.result?.value ?? [];
+                for (const sel of ancestors) {
+                    try {
+                        const q = await ps.session.send('DOM.querySelector', { nodeId: rootId, selector: sel }, 5_000);
+                        if (q.nodeId && q.nodeId !== 0)
+                            queryNodes.push(q.nodeId);
+                    }
+                    catch { /* skip ancestor we can't resolve */ }
+                }
+            }
+            catch (e) {
+                return errorResult(`ancestor enumeration failed: ${describe(e)}`);
+            }
+        }
+        const allListeners = [];
+        for (let i = 0; i < queryNodes.length; i++) {
+            const nid = queryNodes[i];
+            try {
+                const r = await ps.session.send('DOM.getEventListenersForNode', { nodeId: nid }, 10_000);
+                const list = r.listeners ?? [];
+                const label = i === 0 ? `target (${selector})` : `ancestor[${i}]`;
+                for (const l of list)
+                    allListeners.push({ ownerNodeId: nid, ownerLabel: label, listener: l });
+            }
+            catch (e) {
+                // Carry on; some ancestors may legitimately fail.
+                if (i === 0)
+                    return errorResult(`DOM.getEventListenersForNode failed: ${describe(e)}`);
+            }
+        }
+        if (allListeners.length === 0) {
+            return textResult(`# get_event_listeners — \`${selector}\`\n\nNo listeners found on target${includeAncestors ? ' or ancestors' : ''}.`);
+        }
+        const lines = [
+            `# get_event_listeners — \`${selector}\``,
+            '',
+            `Listeners: ${allListeners.length}${includeAncestors ? ` (across ${queryNodes.length} nodes)` : ''}`,
+            '',
+            '| owner | type | capture | passive | once | inline | source |',
+            '|---|---|---|---|---|---|---|',
+        ];
+        for (const { ownerLabel, listener: l } of allListeners) {
+            const loc = l.location ?? { scriptId: l.scriptId, lineNumber: l.lineNumber, columnNumber: l.columnNumber };
+            const src = loc?.scriptId ? `script ${loc.scriptId}:${loc.lineNumber ?? '?'}:${loc.columnNumber ?? '?'}` : '(unknown)';
+            lines.push(`| ${ownerLabel} | ${l.type ?? '?'} | ${l.useCapture ? 'Y' : ''} | ${l.passive ? 'Y' : ''} | ${l.once ? 'Y' : ''} | ${l.isAttribute ? 'Y' : ''} | ${src} |`);
+        }
+        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=get_event_listeners.js.map

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

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

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

@@ -0,0 +1,22 @@
+import { z } from 'zod';
+export declare const getNetworkRequestTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        requestId: z.ZodOptional<z.ZodString>;
+        index: z.ZodOptional<z.ZodNumber>;
+        withBody: z.ZodOptional<z.ZodBoolean>;
+        bodyMaxLen: z.ZodOptional<z.ZodNumber>;
+    };
+    handler: ({ requestId, index, withBody, bodyMaxLen, }: {
+        requestId?: string;
+        index?: number;
+        withBody?: boolean;
+        bodyMaxLen?: number;
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};

package/build/src/tools/get_network_request.js

@@ -0,0 +1,121 @@
+import { z } from 'zod';
+import { PageSession } from '../page-session.js';
+export const getNetworkRequestTool = {
+    name: 'get_network_request',
+    description: [
+        'Return the full detail of a single network request from the rolling buffer (filled by `Network.requestWillBeSent` / `responseReceived` / `loadingFinished` / `loadingFailed`).',
+        'Lookup by `requestId` (preferred — exact match) or `index` (0-based against current buffer ordering; negative counts from end).',
+        'Returns lifecycle state, request line, request/response headers, and optionally the response body via `Network.getResponseBody` when `withBody=true`.',
+        'NOTE: WIP `Network.getResponseBody` only returns bodies for requests that completed AND were not evicted from WebKit\'s resource buffer — large or binary bodies may fail with `-32000 No data found`.',
+    ].join(' '),
+    inputSchema: {
+        requestId: z.string().optional().describe('Exact requestId returned by `list_network_requests` (e.g. `loader-id.123`).'),
+        index: z.number().int().optional().describe('0-based buffer index. Negative counts from the end. Mutually exclusive with requestId.'),
+        withBody: z.boolean().optional().describe('Also fetch response body via `Network.getResponseBody`. Default false.'),
+        bodyMaxLen: z.number().int().min(100).max(200_000).optional().describe('Response body truncation cap (default 20000).'),
+    },
+    handler: async ({ requestId, index, withBody = false, bodyMaxLen = 20_000, }) => {
+        let ps;
+        try {
+            ps = await PageSession.get();
+        }
+        catch (e) {
+            return errorResult(`Unable to attach to a WKWebView page: ${describe(e)}`);
+        }
+        const buf = ps.networkBuffer;
+        if (buf.length === 0) {
+            return errorResult('Network buffer is empty. Trigger page activity and call again.');
+        }
+        if (requestId === undefined && index === undefined) {
+            return errorResult('Provide either `requestId` or `index`.');
+        }
+        if (requestId !== undefined && index !== undefined) {
+            return errorResult('Provide only one of `requestId` / `index`.');
+        }
+        let entry;
+        if (requestId !== undefined) {
+            entry = ps.networkById.get(requestId);
+            if (!entry) {
+                return errorResult(`requestId ${JSON.stringify(requestId)} not in buffer (${buf.length} entries). Use \`list_network_requests\` to enumerate.`);
+            }
+        }
+        else {
+            let i = index;
+            if (i < 0)
+                i = buf.length + i;
+            if (i < 0 || i >= buf.length) {
+                return errorResult(`Index ${index} out of range (buffer has ${buf.length} entries).`);
+            }
+            entry = buf[i];
+        }
+        const lines = [];
+        lines.push(`# network[${entry.requestId}] · ${entry.state} · ${entry.method ?? '?'} ${entry.url}`);
+        lines.push('');
+        lines.push(`Status: ${entry.status ?? '(no status)'} ${entry.statusText ?? ''}`);
+        lines.push(`MIME type: ${entry.mimeType ?? '(unknown)'}`);
+        lines.push(`Resource type: ${entry.type ?? '(unknown)'}${entry.initiatorType ? ` · initiator=${entry.initiatorType}` : ''}`);
+        if (entry.startedAt != null)
+            lines.push(`Started at (proxy clock): ${entry.startedAt}`);
+        if (entry.endedAt != null)
+            lines.push(`Ended at (proxy clock): ${entry.endedAt}`);
+        if (entry.encodedDataLength != null)
+            lines.push(`Encoded data length: ${entry.encodedDataLength}`);
+        if (entry.errorText)
+            lines.push(`Error: ${entry.errorText}`);
+        if (entry.requestHeaders && Object.keys(entry.requestHeaders).length > 0) {
+            lines.push('');
+            lines.push('## Request headers');
+            for (const [k, v] of Object.entries(entry.requestHeaders)) {
+                lines.push(`- ${k}: ${truncate(String(v), 500)}`);
+            }
+        }
+        if (entry.postData) {
+            lines.push('');
+            lines.push('## Request body (postData)');
+            lines.push('```');
+            lines.push(truncate(entry.postData, 2_000));
+            lines.push('```');
+        }
+        if (entry.responseHeaders && Object.keys(entry.responseHeaders).length > 0) {
+            lines.push('');
+            lines.push('## Response headers');
+            for (const [k, v] of Object.entries(entry.responseHeaders)) {
+                lines.push(`- ${k}: ${truncate(String(v), 500)}`);
+            }
+        }
+        if (withBody) {
+            if (entry.state === 'pending') {
+                lines.push('');
+                lines.push('⚠ Response body unavailable: request still pending.');
+            }
+            else {
+                try {
+                    const r = await ps.session.send('Network.getResponseBody', { requestId: entry.requestId }, 10_000);
+                    lines.push('');
+                    lines.push(`## Response body${r.base64Encoded ? ' (base64)' : ''}`);
+                    lines.push('```');
+                    lines.push(truncate(r.body ?? '', bodyMaxLen));
+                    lines.push('```');
+                }
+                catch (e) {
+                    lines.push('');
+                    lines.push(`⚠ Network.getResponseBody failed: ${describe(e)}`);
+                }
+            }
+        }
+        return textResult(lines.join('\n'));
+    },
+};
+function truncate(s, max) {
+    return s.length > max ? s.slice(0, max) + `\n… (truncated, full length ${s.length})` : s;
+}
+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=get_network_request.js.map

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

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

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

@@ -0,0 +1,27 @@
+import { z } from 'zod';
+/**
+ * WIP has no `Tracing.*` / `Performance.getMetrics` domain, so chrome-devtools-mcp's
+ * `performance_start_trace` / `performance_analyze_insight` are unimplementable.
+ * However the JavaScript `PerformanceObserver` + `performance.getEntriesByType` APIs
+ * are available inside the WebView. This tool reads them via `Runtime.evaluate`
+ * and returns structured metrics — a JS-side approximation that covers the
+ * majority of the chrome-devtools-mcp Performance use cases (navigation timing,
+ * paint timing, LCP, CLS, slow resources).
+ */
+export declare const getPerformanceMetricsTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        slowResourceMs: z.ZodOptional<z.ZodNumber>;
+        resourceLimit: z.ZodOptional<z.ZodNumber>;
+    };
+    handler: ({ slowResourceMs, resourceLimit, }: {
+        slowResourceMs?: number;
+        resourceLimit?: number;
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};

package/build/src/tools/get_performance_metrics.js

@@ -0,0 +1,185 @@
+import { z } from 'zod';
+import { PageSession } from '../page-session.js';
+/**
+ * WIP has no `Tracing.*` / `Performance.getMetrics` domain, so chrome-devtools-mcp's
+ * `performance_start_trace` / `performance_analyze_insight` are unimplementable.
+ * However the JavaScript `PerformanceObserver` + `performance.getEntriesByType` APIs
+ * are available inside the WebView. This tool reads them via `Runtime.evaluate`
+ * and returns structured metrics — a JS-side approximation that covers the
+ * majority of the chrome-devtools-mcp Performance use cases (navigation timing,
+ * paint timing, LCP, CLS, slow resources).
+ */
+export const getPerformanceMetricsTool = {
+    name: 'get_performance_metrics',
+    description: [
+        'Read JavaScript-side performance metrics from the inspected iOS WebView page.',
+        'NOTE: WIP has no `Tracing.*` or `Performance.getMetrics` domain (chrome-devtools-mcp\'s `performance_*` tools are unimplementable on iOS). This tool wraps `performance.getEntriesByType` for: navigation timing, paint (FP/FCP), Largest Contentful Paint, Cumulative Layout Shift, and slow resources.',
+        'All values come from W3C Performance APIs — they reflect the current page state, not a freshly recorded trace. To capture metrics after an interaction, reload + interact + call again.',
+    ].join(' '),
+    inputSchema: {
+        slowResourceMs: z
+            .number()
+            .int()
+            .min(0)
+            .max(60_000)
+            .optional()
+            .describe('Resource entries with `duration` ≥ this many ms are flagged as slow (default 500). Set 0 to include all.'),
+        resourceLimit: z
+            .number()
+            .int()
+            .min(1)
+            .max(500)
+            .optional()
+            .describe('Cap slow-resource entries returned (default 30).'),
+    },
+    handler: async ({ slowResourceMs = 500, resourceLimit = 30, }) => {
+        let ps;
+        try {
+            ps = await PageSession.get();
+        }
+        catch (e) {
+            return errorResult(`Unable to attach to a WKWebView page: ${describe(e)}`);
+        }
+        const expression = `
+      (() => {
+        const out = { navigation: null, paint: [], lcp: null, cls: null, layoutShifts: 0, slowResources: [], counts: {} };
+        try {
+          const nav = performance.getEntriesByType('navigation')[0];
+          if (nav) {
+            out.navigation = {
+              type: nav.type,
+              startTime: nav.startTime,
+              fetchStart: nav.fetchStart,
+              domainLookup: { start: nav.domainLookupStart, end: nav.domainLookupEnd, ms: nav.domainLookupEnd - nav.domainLookupStart },
+              connect: { start: nav.connectStart, end: nav.connectEnd, ms: nav.connectEnd - nav.connectStart },
+              tls: nav.secureConnectionStart > 0 ? { start: nav.secureConnectionStart, end: nav.connectEnd, ms: nav.connectEnd - nav.secureConnectionStart } : null,
+              request: { start: nav.requestStart, ms: nav.responseStart - nav.requestStart },
+              response: { start: nav.responseStart, end: nav.responseEnd, ms: nav.responseEnd - nav.responseStart },
+              dom: { interactive: nav.domInteractive, contentLoaded: nav.domContentLoadedEventEnd, complete: nav.domComplete },
+              loadEvent: { start: nav.loadEventStart, end: nav.loadEventEnd, ms: nav.loadEventEnd - nav.loadEventStart },
+              transferSize: nav.transferSize,
+              encodedBodySize: nav.encodedBodySize,
+              decodedBodySize: nav.decodedBodySize,
+            };
+          }
+        } catch (e) { out.navigation = { error: String(e) }; }
+        try {
+          out.paint = performance.getEntriesByType('paint').map(p => ({ name: p.name, startTime: p.startTime }));
+        } catch (e) {}
+        try {
+          const lcps = performance.getEntriesByType('largest-contentful-paint');
+          if (lcps.length) {
+            const last = lcps[lcps.length - 1];
+            out.lcp = { startTime: last.startTime, renderTime: last.renderTime, size: last.size, url: last.url, element: last.element && last.element.tagName };
+          }
+        } catch (e) {}
+        try {
+          const shifts = performance.getEntriesByType('layout-shift') || [];
+          let sum = 0; for (const s of shifts) if (!s.hadRecentInput) sum += s.value;
+          out.cls = sum; out.layoutShifts = shifts.length;
+        } catch (e) {}
+        try {
+          const res = performance.getEntriesByType('resource');
+          out.counts.resources = res.length;
+          const slow = res.filter(r => r.duration >= ${slowResourceMs}).sort((a, b) => b.duration - a.duration).slice(0, ${resourceLimit});
+          out.slowResources = slow.map(r => ({
+            name: r.name, initiator: r.initiatorType, duration: r.duration, startTime: r.startTime,
+            transferSize: r.transferSize, encodedBodySize: r.encodedBodySize, nextHopProtocol: r.nextHopProtocol,
+          }));
+        } catch (e) {}
+        try { out.counts.measures = performance.getEntriesByType('measure').length; } catch (e) {}
+        try { out.counts.marks = performance.getEntriesByType('mark').length; } catch (e) {}
+        return out;
+      })()
+    `;
+        let result;
+        try {
+            result = await ps.session.send('Runtime.evaluate', { expression, returnByValue: true, awaitPromise: false }, 15_000);
+        }
+        catch (e) {
+            return errorResult(`Runtime.evaluate (get_performance_metrics) failed: ${describe(e)}`);
+        }
+        const v = result?.result?.value;
+        if (!v || typeof v !== 'object') {
+            return errorResult(`# get_performance_metrics: unexpected return\n\n${JSON.stringify(result?.result)}`);
+        }
+        const lines = [`# get_performance_metrics`, ''];
+        const nav = v.navigation;
+        if (nav && !nav.error) {
+            lines.push('## navigation timing');
+            lines.push(`- type: ${nav.type}`);
+            const fmt = (g, label) => g ? `- ${label}: ${g.ms.toFixed(1)} ms` : null;
+            const segs = [
+                fmt(nav.domainLookup, 'DNS'),
+                fmt(nav.connect, 'TCP connect'),
+                fmt(nav.tls, 'TLS'),
+                fmt(nav.request, 'request (TTFB)'),
+                fmt(nav.response, 'response download'),
+                fmt(nav.loadEvent, 'load event'),
+            ].filter(Boolean);
+            lines.push(...segs);
+            const dom = nav.dom;
+            lines.push(`- DOM interactive: ${dom.interactive.toFixed(1)} ms · contentLoaded: ${dom.contentLoaded.toFixed(1)} ms · complete: ${dom.complete.toFixed(1)} ms`);
+            lines.push(`- transfer: encoded ${nav.encodedBodySize} B / decoded ${nav.decodedBodySize} B / transfer ${nav.transferSize} B`);
+        }
+        else if (nav && nav.error) {
+            lines.push('## navigation timing');
+            lines.push(`⚠ ${nav.error}`);
+        }
+        else {
+            lines.push('## navigation timing');
+            lines.push('(no navigation entry — page may not have a full navigation, e.g. SPA route change)');
+        }
+        const paint = v.paint;
+        if (paint?.length) {
+            lines.push('');
+            lines.push('## paint');
+            paint.forEach(p => lines.push(`- ${p.name}: ${p.startTime.toFixed(1)} ms`));
+        }
+        const lcp = v.lcp;
+        if (lcp) {
+            lines.push('');
+            lines.push('## Largest Contentful Paint');
+            lines.push(`- startTime: ${lcp.startTime.toFixed(1)} ms${lcp.renderTime ? ` (render ${lcp.renderTime.toFixed(1)} ms)` : ''}`);
+            if (lcp.element)
+                lines.push(`- element: <${lcp.element}>`);
+            if (lcp.url)
+                lines.push(`- url: ${lcp.url}`);
+            if (lcp.size != null)
+                lines.push(`- size (px²): ${lcp.size}`);
+        }
+        if (v.cls != null) {
+            lines.push('');
+            lines.push(`## Cumulative Layout Shift: ${v.cls.toFixed(4)} (${v.layoutShifts} shift entries)`);
+        }
+        const counts = v.counts;
+        lines.push('');
+        lines.push(`## counts: ${counts.resources ?? 0} resources · ${counts.marks ?? 0} marks · ${counts.measures ?? 0} measures`);
+        const slow = v.slowResources;
+        if (slow?.length) {
+            lines.push('');
+            lines.push(`## slow resources (≥ ${slowResourceMs}ms, top ${slow.length})`);
+            lines.push('| duration | initiator | size | url |');
+            lines.push('|---|---|---|---|');
+            for (const r of slow) {
+                lines.push(`| ${r.duration.toFixed(0)} ms | ${r.initiator ?? '?'} | ${r.transferSize ?? '?'} B | ${r.name.slice(0, 80)} |`);
+            }
+        }
+        else {
+            lines.push(`(no resources with duration ≥ ${slowResourceMs}ms)`);
+        }
+        lines.push('');
+        lines.push('⚠ JS-side approximation — no CPU sampling, no flame-graph, no rendering pipeline breakdown (would need `Tracing.*` which WIP lacks). For CPU profiles consider `take_memory_snapshot` (heap) or run a Safari Web Inspector Timeline session via the macOS UI.');
+        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=get_performance_metrics.js.map

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

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

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

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

package/build/src/tools/get_resource_tree.js

@@ -0,0 +1,82 @@
+import { z } from 'zod';
+import { PageSession } from '../page-session.js';
+export const getResourceTreeTool = {
+    name: 'get_resource_tree',
+    description: [
+        'Return the frame + resource tree of the inspected iOS WebView page via WIP `Page.getResourceTree`.',
+        'Useful for multi-frame pages (iframes) — see exactly which frame loaded which resources, their URLs, mime types, sizes, and load failures.',
+        'Probe-confirmed (2026-05-16): `Page.getResourceTree` is one of the rare `Page.*` methods present on WIP. Returns the full frame hierarchy in one call.',
+    ].join(' '),
+    inputSchema: {
+        resourceUrlSubstring: z
+            .string()
+            .optional()
+            .describe('Case-insensitive substring filter on resource URLs (default: include all).'),
+        maxResourcesPerFrame: z
+            .number()
+            .int()
+            .min(1)
+            .max(500)
+            .optional()
+            .describe('Cap resources rendered per frame (default 50).'),
+    },
+    handler: async ({ resourceUrlSubstring, maxResourcesPerFrame = 50, }) => {
+        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('Page.getResourceTree', undefined, 10_000);
+        }
+        catch (e) {
+            return errorResult(`Page.getResourceTree failed: ${describe(e)}`);
+        }
+        const lines = [];
+        let totalFrames = 0;
+        let totalResources = 0;
+        const needle = resourceUrlSubstring?.toLowerCase();
+        const renderFrame = (node, depth) => {
+            totalFrames++;
+            const indent = '  '.repeat(depth);
+            const f = node.frame;
+            lines.push(`${indent}- frame \`${f.id}\`${f.name ? ` (name=${f.name})` : ''} · ${f.mimeType ?? '?'}`);
+            lines.push(`${indent}  URL: ${f.url ?? '(no url)'}`);
+            if (f.securityOrigin)
+                lines.push(`${indent}  origin: ${f.securityOrigin}`);
+            let resources = node.resources ?? [];
+            if (needle)
+                resources = resources.filter(r => r.url.toLowerCase().includes(needle));
+            const shown = resources.slice(0, maxResourcesPerFrame);
+            totalResources += resources.length;
+            if (shown.length > 0) {
+                lines.push(`${indent}  resources (${shown.length}${resources.length > shown.length ? `/${resources.length} shown` : ''}):`);
+                for (const r of shown) {
+                    const tag = r.failed ? '✗ failed' : '✓';
+                    lines.push(`${indent}    ${tag} ${r.type}${r.mimeType ? '/' + r.mimeType : ''}${r.contentSize != null ? ` · ${r.contentSize}B` : ''} · ${r.url}`);
+                }
+            }
+            for (const child of node.childFrames ?? [])
+                renderFrame(child, depth + 1);
+        };
+        lines.push(`# get_resource_tree`);
+        lines.push('');
+        renderFrame(result.frameTree, 0);
+        lines.unshift(`Total frames: ${totalFrames}  ·  resources${needle ? ` (filtered "${resourceUrlSubstring}")` : ''}: ${totalResources}`);
+        lines.unshift('');
+        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=get_resource_tree.js.map

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

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