ios-webkit-mcp 0.18.3

package/build/src/tools/fill_form.js

@@ -0,0 +1,110 @@
+import { z } from 'zod';
+import { PageSession } from '../page-session.js';
+export const fillFormTool = {
+    name: 'fill_form',
+    description: [
+        'Fill multiple form fields in one round-trip on the inspected iOS WebView page.',
+        'Each entry mirrors the behavior of `fill`: native `value` setter (React `onChange` compatible) + synthetic `input` + `change` events. WIP has no `Input.*` domain so all events are `isTrusted=false`.',
+        'Selector matches via `document.querySelectorAll(selector)[nth]`. Per-field failures are reported but do NOT abort the rest of the batch.',
+    ].join(' '),
+    inputSchema: {
+        fields: z
+            .array(z.object({
+            selector: z.string().min(1).describe('CSS selector for the input/textarea/contenteditable.'),
+            value: z.string().describe('Text to fill (empty string clears).'),
+            nth: z.number().int().min(0).optional().describe('Nth match (default 0).'),
+        }))
+            .min(1)
+            .max(50)
+            .describe('Form fields to fill in order.'),
+        waitAfterMs: z
+            .number()
+            .int()
+            .min(0)
+            .max(10_000)
+            .optional()
+            .describe('Block after the whole batch for this long (default 150).'),
+    },
+    handler: async ({ fields, waitAfterMs = 150, }) => {
+        let ps;
+        try {
+            ps = await PageSession.get();
+        }
+        catch (e) {
+            return errorResult(`Unable to attach to a WKWebView page: ${describe(e)}`);
+        }
+        const fieldsJson = JSON.stringify(fields.map(f => ({ selector: f.selector, value: f.value, nth: f.nth ?? 0 })));
+        const expression = `
+      (() => {
+        const fields = ${fieldsJson};
+        const results = [];
+        for (const f of fields) {
+          const matches = document.querySelectorAll(f.selector);
+          if (matches.length === 0) { results.push({ selector: f.selector, ok: false, reason: 'no_match' }); continue; }
+          if (f.nth >= matches.length) { results.push({ selector: f.selector, ok: false, reason: 'nth_out_of_range', found: matches.length }); continue; }
+          const el = matches[f.nth];
+          const tag = el.tagName.toLowerCase();
+          const isInput = tag === 'input' || tag === 'textarea';
+          const isCE = el.isContentEditable === true;
+          if (!isInput && !isCE) { results.push({ selector: f.selector, ok: false, reason: 'not_fillable', tag }); continue; }
+          try {
+            el.focus();
+            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, f.value); else el.value = f.value;
+            } else {
+              el.textContent = f.value;
+            }
+            el.dispatchEvent(new Event('input', { bubbles: true }));
+            el.dispatchEvent(new Event('change', { bubbles: true }));
+          } catch (e) { results.push({ selector: f.selector, ok: false, reason: 'fill_threw', error: String(e), tag }); continue; }
+          results.push({ selector: f.selector, ok: true, tag, valueLen: f.value.length });
+        }
+        return results;
+      })()
+    `;
+        let result;
+        try {
+            result = await ps.session.send('Runtime.evaluate', { expression, returnByValue: true, awaitPromise: false }, 15_000);
+        }
+        catch (e) {
+            return errorResult(`Runtime.evaluate (fill_form) failed: ${describe(e)}`);
+        }
+        if (waitAfterMs > 0) {
+            await new Promise(r => setTimeout(r, waitAfterMs));
+        }
+        const results = result?.result?.value;
+        if (!Array.isArray(results)) {
+            return errorResult(`# fill_form: unexpected return\n\n${JSON.stringify(result?.result)}`);
+        }
+        const ok = results.filter(r => r.ok === true).length;
+        const failed = results.length - ok;
+        const lines = [`# fill_form ${failed === 0 ? '✓' : '⚠'} ${ok}/${results.length} fields filled`, ''];
+        results.forEach((r, i) => {
+            if (r.ok) {
+                lines.push(`- [${i + 1}] ✓ \`${r.selector}\` ← \`<${r.tag}>\` (len ${r.valueLen})`);
+            }
+            else {
+                lines.push(`- [${i + 1}] ✗ \`${r.selector}\` → ${r.reason}${r.tag ? ` (tag: ${r.tag})` : ''}${r.found != null ? ` (found ${r.found})` : ''}${r.error ? ` (${r.error})` : ''}`);
+            }
+        });
+        if (failed > 0) {
+            lines.push('');
+            lines.push('⚠ Per-field failures do not abort the batch. Re-run with corrected selectors.');
+        }
+        lines.push('');
+        lines.push('⚠ Synthetic `value=…` + `input`/`change` events (isTrusted=false). Use `type_text` per-field for per-keystroke listeners.');
+        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=fill_form.js.map

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

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

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

@@ -0,0 +1,16 @@
+import { z } from 'zod';
+export declare const gcHeapTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        measureDelta: z.ZodOptional<z.ZodBoolean>;
+    };
+    handler: ({ measureDelta }: {
+        measureDelta?: boolean;
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};

package/build/src/tools/gc_heap.js

@@ -0,0 +1,66 @@
+import { z } from 'zod';
+import { PageSession } from '../page-session.js';
+export const gcHeapTool = {
+    name: 'gc_heap',
+    description: [
+        'Force JavaScript garbage collection via WIP `Heap.gc` (Apple-specific, probe-confirmed 2026-05-16).',
+        'Useful before `take_memory_snapshot` to surface only "live" objects, or to confirm objects are eligible for GC after closing modals / unmounting components.',
+        'Optionally measure heap size delta via `Runtime.evaluate("performance.memory")` (Apple WebKit exposes a Chrome-compatible `performance.memory.usedJSHeapSize`).',
+    ].join(' '),
+    inputSchema: {
+        measureDelta: z.boolean().optional().describe('Read `performance.memory.usedJSHeapSize` before + after gc and report the delta. Default true.'),
+    },
+    handler: async ({ measureDelta = true }) => {
+        let ps;
+        try {
+            ps = await PageSession.get();
+        }
+        catch (e) {
+            return errorResult(`Unable to attach: ${describe(e)}`);
+        }
+        let before = null;
+        let after = null;
+        if (measureDelta) {
+            try {
+                const r = await ps.session.send('Runtime.evaluate', {
+                    expression: '(performance.memory && performance.memory.usedJSHeapSize) || -1',
+                    returnByValue: true,
+                }, 5_000);
+                before = r?.result?.value ?? null;
+            }
+            catch { }
+        }
+        try {
+            await ps.session.send('Heap.gc', undefined, 30_000);
+        }
+        catch (e) {
+            return errorResult(`Heap.gc failed: ${describe(e)}`);
+        }
+        if (measureDelta) {
+            try {
+                const r = await ps.session.send('Runtime.evaluate', {
+                    expression: '(performance.memory && performance.memory.usedJSHeapSize) || -1',
+                    returnByValue: true,
+                }, 5_000);
+                after = r?.result?.value ?? null;
+            }
+            catch { }
+        }
+        const lines = [`# gc_heap ✓`, ''];
+        if (before != null && after != null && before > 0 && after > 0) {
+            const fmt = (n) => `${(n / 1024 / 1024).toFixed(2)} MB`;
+            const delta = after - before;
+            lines.push(`heap usedJSHeapSize: ${fmt(before)} → ${fmt(after)} (Δ ${delta >= 0 ? '+' : ''}${fmt(Math.abs(delta))})`);
+        }
+        else if (measureDelta) {
+            lines.push('⚠ `performance.memory` unavailable on this WebView — delta not measured.');
+        }
+        lines.push('');
+        lines.push('Run `take_memory_snapshot` next for the post-GC heap distribution.');
+        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=gc_heap.js.map

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

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

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

@@ -0,0 +1,17 @@
+export declare const getCapabilitySnapshotTool: {
+    name: string;
+    description: string;
+    inputSchema: {};
+    handler: () => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+        isError: boolean;
+    } | {
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};

package/build/src/tools/get_capability_snapshot.js

@@ -0,0 +1,50 @@
+/**
+ * `get_capability_snapshot` — expose the WIP capability discovery snapshot to
+ * LLM agents. Useful when the agent's earlier tool call hits a domain timeout
+ * and it wants to know "is this method known to be unsupported on this device,
+ * or is it just a transient timeout?".
+ *
+ * Surface mirrors `CapabilitySnapshot` from src/capability.ts — see spec
+ * §"Capability discovery 架构 (v2.0.1)".
+ */
+import { PageSession } from '../page-session.js';
+export const getCapabilitySnapshotTool = {
+    name: 'get_capability_snapshot',
+    description: [
+        'Return the WIP capability discovery snapshot for the currently-attached page session.',
+        'Tells you which Apple WIP domains the connected WebKit build supports (when `Schema.getDomains` is available; many iOS builds do NOT expose Schema, in which case `supportedDomains` is null and tool calls fall back to optimistic + tool-level timeout).',
+        'Use to interpret prior `*_DOMAIN_UNAVAILABLE` errors or to plan whether to attempt CSS / Audit / Animation / Memory etc. methods.',
+    ].join(' '),
+    inputSchema: {},
+    handler: async () => {
+        let ps;
+        try {
+            ps = await PageSession.get();
+        }
+        catch (e) {
+            return errorResult(`Unable to attach: ${describe(e)}`);
+        }
+        const snap = await ps.capability();
+        const out = {
+            probedAt: snap.probedAt,
+            probeDurationMs: snap.probeDurationMs,
+            schemaProbeSucceeded: snap.schemaProbeSucceeded,
+            supportedDomains: snap.supportedDomains ? [...snap.supportedDomains].sort() : null,
+            sentinels: snap.sentinels,
+            notes: snap.notes,
+            attachInfo: ps.attachInfo
+                ? {
+                    deviceOSVersion: ps.attachInfo.deviceOSVersion,
+                    pageTitle: ps.attachInfo.pageTitle,
+                    pageUrl: ps.attachInfo.pageUrl,
+                    attachedAt: ps.attachInfo.attachedAt,
+                }
+                : null,
+        };
+        const text = '# get_capability_snapshot\n\n```json\n' + JSON.stringify(out, null, 2) + '\n```';
+        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_capability_snapshot.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get_capability_snapshot.js","sourceRoot":"","sources":["../../../src/tools/get_capability_snapshot.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,IAAI,EAAE,yBAAyB;IAC/B,WAAW,EAAE;QACX,uFAAuF;QACvF,4PAA4P;QAC5P,mIAAmI;KACpI,CAAC,IAAI,CAAC,GAAG,CAAC;IACX,WAAW,EAAE,EAAE;IACf,OAAO,EAAE,KAAK,IAAI,EAAE;QAClB,IAAI,EAAe,CAAC;QACpB,IAAI,CAAC;YAAC,EAAE,GAAG,MAAM,WAAW,CAAC,GAAG,EAAE,CAAC;QAAC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YAAC,OAAO,WAAW,CAAC,qBAAqB,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAAC,CAAC;QAC3G,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,UAAU,EAAE,CAAC;QACnC,MAAM,GAAG,GAAG;YACV,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,eAAe,EAAE,IAAI,CAAC,eAAe;YACrC,oBAAoB,EAAE,IAAI,CAAC,oBAAoB;YAC/C,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,gBAAgB,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI;YAClF,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,UAAU,EAAE,EAAE,CAAC,UAAU;gBACvB,CAAC,CAAC;oBACE,eAAe,EAAE,EAAE,CAAC,UAAU,CAAC,eAAe;oBAC9C,SAAS,EAAE,EAAE,CAAC,UAAU,CAAC,SAAS;oBAClC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO;oBAC9B,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,UAAU;iBACrC;gBACH,CAAC,CAAC,IAAI;SACT,CAAC;QACF,MAAM,IAAI,GAAG,wCAAwC,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC;QAC/F,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IACxD,CAAC;CACF,CAAC;AAEF,SAAS,WAAW,CAAC,IAAY,IAAI,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAC5G,SAAS,QAAQ,CAAC,CAAU,IAAI,OAAO,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC"}

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

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

package/build/src/tools/get_console_message.js

@@ -0,0 +1,92 @@
+import { z } from 'zod';
+import { PageSession } from '../page-session.js';
+export const getConsoleMessageTool = {
+    name: 'get_console_message',
+    description: [
+        'Return the full detail of a single console message from the rolling buffer (filled by `Console.messageAdded` + `Runtime.exceptionThrown`).',
+        'Indexing: `index` is 0-based against the current buffer ordering (oldest → newest). Negative values count from the end (`-1` = newest).',
+        'Returns level, source, text, url:line:col, full args (with truncation), and full stack trace if present.',
+    ].join(' '),
+    inputSchema: {
+        index: z
+            .number()
+            .int()
+            .describe('0-based index into the rolling console buffer. Negative counts from the end (-1 = newest).'),
+        argMaxLen: z
+            .number()
+            .int()
+            .min(50)
+            .max(20_000)
+            .optional()
+            .describe('Per-arg stringification cap (default 1000).'),
+    },
+    handler: async ({ index, argMaxLen = 1000, }) => {
+        let ps;
+        try {
+            ps = await PageSession.get();
+        }
+        catch (e) {
+            return errorResult(`Unable to attach to a WKWebView page: ${describe(e)}`);
+        }
+        const buf = ps.consoleBuffer;
+        if (buf.length === 0) {
+            return errorResult('Console buffer is empty. Trigger page activity and call again.');
+        }
+        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; valid: 0..${buf.length - 1} or -${buf.length}..-1).`);
+        }
+        const e = buf[i];
+        const lines = [];
+        const ts = typeof e.timestamp === 'number' ? new Date(e.timestamp * 1000).toISOString() : '(no timestamp)';
+        lines.push(`# console[${i}] / ${i + 1}-of-${buf.length} · ${e.level} · ${e.source}`);
+        lines.push('');
+        lines.push(`Time: ${ts}`);
+        if (e.url)
+            lines.push(`At: ${e.url}${e.line != null ? `:${e.line}` : ''}${e.column != null ? `:${e.column}` : ''}`);
+        lines.push('');
+        lines.push('## text');
+        lines.push('```');
+        lines.push(e.text);
+        lines.push('```');
+        if (e.args && e.args.length > 0) {
+            lines.push('');
+            lines.push(`## args (${e.args.length})`);
+            e.args.forEach((arg, idx) => {
+                lines.push(`### args[${idx}]`);
+                lines.push('```json');
+                lines.push(safeStringify(arg, argMaxLen));
+                lines.push('```');
+            });
+        }
+        if (e.stackTrace) {
+            lines.push('');
+            lines.push('## stackTrace');
+            lines.push('```json');
+            lines.push(safeStringify(e.stackTrace, 5_000));
+            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);
+}
+function safeStringify(o, maxLen) {
+    try {
+        const s = JSON.stringify(o, null, 2);
+        return s && s.length > maxLen ? s.slice(0, maxLen) + `\n… (truncated, full length ${s.length})` : (s ?? String(o));
+    }
+    catch {
+        return String(o);
+    }
+}
+//# sourceMappingURL=get_console_message.js.map

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

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

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

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

package/build/src/tools/get_cookies.js

@@ -0,0 +1,59 @@
+import { z } from 'zod';
+import { PageSession } from '../page-session.js';
+export const getCookiesTool = {
+    name: 'get_cookies',
+    description: [
+        'List cookies visible to the inspected iOS WebView page via WIP `Page.getCookies` (Apple-specific, probe-confirmed 2026-05-16).',
+        'NOTE: WIP\'s `Network.*Cookies` methods are NOT exposed on iOS — only the `Page.getCookies` / `Page.deleteCookie` pair works. Filter by URL substring or domain locally.',
+    ].join(' '),
+    inputSchema: {
+        urlSubstring: z.string().optional().describe('Case-insensitive substring filter on cookie URL/domain.'),
+        nameSubstring: z.string().optional().describe('Case-insensitive substring filter on cookie name.'),
+        limit: z.number().int().min(1).max(500).optional().describe('Max cookies returned (default 100).'),
+    },
+    handler: async ({ urlSubstring, nameSubstring, limit = 100, }) => {
+        let ps;
+        try {
+            ps = await PageSession.get();
+        }
+        catch (e) {
+            return errorResult(`Unable to attach: ${describe(e)}`);
+        }
+        let r;
+        try {
+            r = await ps.session.send('Page.getCookies', undefined, 10_000);
+        }
+        catch (e) {
+            return errorResult(`Page.getCookies failed: ${describe(e)}`);
+        }
+        let cookies = r.cookies ?? [];
+        if (urlSubstring) {
+            const n = urlSubstring.toLowerCase();
+            cookies = cookies.filter(c => (`${c.domain ?? ''}${c.path ?? ''}`).toLowerCase().includes(n));
+        }
+        if (nameSubstring) {
+            const n = nameSubstring.toLowerCase();
+            cookies = cookies.filter(c => String(c.name ?? '').toLowerCase().includes(n));
+        }
+        const total = cookies.length;
+        cookies = cookies.slice(0, limit);
+        const lines = [`# get_cookies — ${cookies.length} of ${total} total`, ''];
+        if (cookies.length === 0) {
+            lines.push('(no cookies match filters)');
+            return textResult(lines.join('\n'));
+        }
+        lines.push('| name | value | domain | path | expires | secure | httpOnly | session |');
+        lines.push('|---|---|---|---|---|---|---|---|');
+        for (const c of cookies) {
+            const value = String(c.value ?? '');
+            const v = value.length > 40 ? value.slice(0, 40) + '…' : value;
+            const exp = typeof c.expires === 'number' && c.expires > 0 ? new Date(c.expires * 1000).toISOString().slice(0, 19) : '-';
+            lines.push(`| ${c.name} | ${v.replace(/\|/g, '\\|')} | ${c.domain ?? ''} | ${c.path ?? '/'} | ${exp} | ${c.secure ? '✓' : ''} | ${c.httpOnly ? '✓' : ''} | ${c.session ? '✓' : ''} |`);
+        }
+        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_cookies.js.map

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

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

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

@@ -0,0 +1,29 @@
+/**
+ * `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';
+export declare const getEventListenersTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        selector: z.ZodString;
+        includeAncestors: z.ZodOptional<z.ZodBoolean>;
+    };
+    handler: ({ selector, includeAncestors }: {
+        selector: string;
+        includeAncestors?: boolean;
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};