ios-webkit-mcp 0.18.3

package/build/src/tools/click.js

@@ -0,0 +1,88 @@
+import { z } from 'zod';
+import { PageSession } from '../page-session.js';
+export const clickTool = {
+    name: 'click',
+    description: [
+        'Click an element on the inspected iOS WebView page.',
+        'NOTE: WIP has no `Input.*` domain (verified `-32601` on Dialog/Input methods). This tool dispatches a synthetic click via `Runtime.evaluate("el.click()")` — it triggers the click handler but does NOT replay an authentic touch event sequence (touchstart/touchend/mousedown/mouseup). For interactions that require gesture-quality events (long press, drag, native scroll triggers), evaluate yourself with `dispatchEvent`.',
+        'Selector matches via `document.querySelector(selector)`. Returns whether the element was found + clicked.',
+    ].join(' '),
+    inputSchema: {
+        selector: z.string().min(1).describe('CSS selector for the element to click.'),
+        nth: z
+            .number()
+            .int()
+            .min(0)
+            .optional()
+            .describe('When the selector matches multiple, pick the Nth (0-indexed). Default 0.'),
+        waitAfterMs: z
+            .number()
+            .int()
+            .min(0)
+            .max(10_000)
+            .optional()
+            .describe('Block after the click for this long (default 200) so subsequent reads see post-click state.'),
+    },
+    handler: async ({ selector, nth = 0, waitAfterMs = 200, }) => {
+        let ps;
+        try {
+            ps = await PageSession.get();
+        }
+        catch (e) {
+            return errorResult(`Unable to attach to a WKWebView page: ${describe(e)}`);
+        }
+        const selJson = JSON.stringify(selector);
+        const expression = `
+      (() => {
+        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', selector: ${selJson}, found: matches.length };
+        const el = matches[${nth}];
+        const rect = el.getBoundingClientRect();
+        const tag = el.tagName.toLowerCase();
+        const visible = rect.width > 0 && rect.height > 0;
+        try {
+          el.click();
+        } catch (e) {
+          return { ok: false, reason: 'click_threw', error: String(e), tag };
+        }
+        return { ok: true, tag, rect: { x: rect.x, y: rect.y, w: rect.width, h: rect.height }, visible, foundCount: matches.length };
+      })()
+    `;
+        let result;
+        try {
+            result = await ps.session.send('Runtime.evaluate', { expression, returnByValue: true, awaitPromise: false }, 10_000);
+        }
+        catch (e) {
+            return errorResult(`Runtime.evaluate (click) failed: ${describe(e)}`);
+        }
+        if (waitAfterMs > 0) {
+            await new Promise(r => setTimeout(r, waitAfterMs));
+        }
+        const value = result?.result?.value;
+        const v = value;
+        if (!v || v.ok !== true) {
+            return errorResult(`# click: failed\n\nselector: \`${selector}\`\n\n${JSON.stringify(value)}`);
+        }
+        return textResult([
+            `# click ✓ ${selector}`,
+            '',
+            `tag: \`<${v.tag}>\``,
+            `match count: ${v.foundCount} (picked nth=${nth})`,
+            `visible: ${v.visible}`,
+            `rect: ${JSON.stringify(v.rect)}`,
+            '',
+            '⚠ This is a synthetic `el.click()` invocation, not a real touch event. Long-press / drag / gesture-only handlers will NOT fire.',
+        ].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=click.js.map

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

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

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

@@ -0,0 +1,36 @@
+/**
+ * `debug_element` (batch-14 composite) — one-call deep-dive on a DOM element.
+ *
+ * Combines:
+ *   - `query_dom_node` (selector → outerHTML)
+ *   - `get_event_listeners` (selector → bound handlers)
+ *   - `take_node_screenshot` (selector → PNG dataURL preview, optional)
+ *   - `highlight_node` (selector → visual overlay, optional)
+ *
+ * Useful when an AI agent says "what is this `.feed-item` doing?" and wants
+ * one consolidated answer instead of 4 round-trips.
+ */
+import { z } from 'zod';
+export declare const debugElementTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        selector: z.ZodString;
+        perNodeMaxLen: z.ZodOptional<z.ZodNumber>;
+        withScreenshot: z.ZodOptional<z.ZodBoolean>;
+        withHighlight: z.ZodOptional<z.ZodBoolean>;
+        includeAncestors: z.ZodOptional<z.ZodBoolean>;
+    };
+    handler: ({ selector, perNodeMaxLen, withScreenshot, withHighlight, includeAncestors, }: {
+        selector: string;
+        perNodeMaxLen?: number;
+        withScreenshot?: boolean;
+        withHighlight?: boolean;
+        includeAncestors?: boolean;
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};

package/build/src/tools/debug_element.js

@@ -0,0 +1,66 @@
+/**
+ * `debug_element` (batch-14 composite) — one-call deep-dive on a DOM element.
+ *
+ * Combines:
+ *   - `query_dom_node` (selector → outerHTML)
+ *   - `get_event_listeners` (selector → bound handlers)
+ *   - `take_node_screenshot` (selector → PNG dataURL preview, optional)
+ *   - `highlight_node` (selector → visual overlay, optional)
+ *
+ * Useful when an AI agent says "what is this `.feed-item` doing?" and wants
+ * one consolidated answer instead of 4 round-trips.
+ */
+import { z } from 'zod';
+import { queryDomNodeTool } from './query_dom_node.js';
+import { getEventListenersTool } from './get_event_listeners.js';
+import { takeNodeScreenshotTool } from './take_node_screenshot.js';
+import { highlightNodeTool } from './highlight_node.js';
+export const debugElementTool = {
+    name: 'debug_element',
+    description: [
+        'Run a one-shot deep-dive on a DOM element matching `selector`: outerHTML + event listeners + optional screenshot + optional highlight.',
+        'Composes `query_dom_node` + `get_event_listeners` (+ `take_node_screenshot`/`highlight_node` if requested) into a single markdown report — saves the AI 3-4 round-trips when investigating "what is this element doing?".',
+    ].join(' '),
+    inputSchema: {
+        selector: z.string().min(1).describe('CSS selector. First match used.'),
+        perNodeMaxLen: z.number().int().min(100).max(50_000).optional().describe('Truncation cap on outerHTML (default 4000).'),
+        withScreenshot: z.boolean().optional().describe('Capture node screenshot (default false — bandwidth heavy).'),
+        withHighlight: z.boolean().optional().describe('Apply visible highlight overlay so the user/AI can verify the picked element on screen (default false; remember to call hide_highlight later).'),
+        includeAncestors: z.boolean().optional().describe('Walk parent chain in event listener enumeration (default false).'),
+    },
+    handler: async ({ selector, perNodeMaxLen = 4_000, withScreenshot = false, withHighlight = false, includeAncestors = false, }) => {
+        // DOM-touching sub-tools must NOT run in parallel — Apple WIP `DOM.getDocument`
+        // bumps node generation, invalidating concurrent nodeId lookups. Serialize them.
+        const domR = (await queryDomNodeTool.handler({ selector, mode: 'first', perNodeMaxLen }));
+        const evtR = (await getEventListenersTool.handler({ selector, includeAncestors }));
+        const results = [domR, evtR];
+        if (withScreenshot)
+            results.push((await takeNodeScreenshotTool.handler({ selector })));
+        if (withHighlight)
+            results.push((await highlightNodeTool.handler({ selector })));
+        const lines = [`# debug_element ✓ \`${selector}\``, ''];
+        lines.push('## DOM');
+        lines.push(stripTitle(domR.content[0]?.text ?? '(no dom output)'));
+        lines.push('');
+        lines.push('## Event Listeners');
+        lines.push(stripTitle(evtR.content[0]?.text ?? '(no listeners output)'));
+        let next = 2;
+        if (withScreenshot) {
+            lines.push('');
+            lines.push('## Screenshot');
+            lines.push(stripTitle(results[next].content[0]?.text ?? '(no screenshot)'));
+            next += 1;
+        }
+        if (withHighlight) {
+            lines.push('');
+            lines.push('## Highlight');
+            lines.push(stripTitle(results[next].content[0]?.text ?? '(no highlight)'));
+            lines.push('⚠ Remember to call `hide_highlight` to clear the overlay when done.');
+        }
+        return { content: [{ type: 'text', text: lines.join('\n') }] };
+    },
+};
+function stripTitle(text) {
+    return text.replace(/^# [^\n]*\n+/, '');
+}
+//# sourceMappingURL=debug_element.js.map

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

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

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

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

package/build/src/tools/debugger.js

@@ -0,0 +1,117 @@
+import { z } from 'zod';
+import { PageSession } from '../page-session.js';
+/**
+ * Apple WIP `Debugger` domain is exposed on iOS (probe-confirmed 2026-05-16):
+ *   Debugger.{enable,disable,pause,resume,setBreakpointByUrl,setBreakpointsActive}
+ *
+ * Caveats:
+ *   - `Debugger.pause` marks "pause on next JS execution opportunity" — the
+ *     actual pause happens asynchronously when the page next runs script,
+ *     visible via `Debugger.paused` events. The tool returns immediately.
+ *   - While paused, subsequent `Runtime.evaluate` calls may block the WIP
+ *     event loop or execute in pause context (different scope). Use
+ *     `resume_debugger` before further work to be safe.
+ *   - `Debugger.enable` is idempotent on Apple WIP — we call it lazily.
+ */
+const ensureEnabled = async (ps) => {
+    try {
+        await ps.session.send('Debugger.enable', undefined, 5_000);
+    }
+    catch { /* idempotent */ }
+};
+export const pauseDebuggerTool = {
+    name: 'pause_debugger',
+    description: [
+        'Request a JavaScript execution pause on the inspected iOS WebView page via WIP `Debugger.pause` (probe-confirmed 2026-05-16).',
+        'NOTE: Pause is async — actual pause happens when the page next executes script. The tool returns immediately. While paused, other tools may behave unexpectedly. Call `resume_debugger` before further interaction.',
+        'Always re-enable Debugger lazily (idempotent on Apple WIP).',
+    ].join(' '),
+    inputSchema: {},
+    handler: async () => {
+        let ps;
+        try {
+            ps = await PageSession.get();
+        }
+        catch (e) {
+            return errorResult(`Unable to attach: ${describe(e)}`);
+        }
+        await ensureEnabled(ps);
+        try {
+            await ps.session.send('Debugger.pause', undefined, 5_000);
+        }
+        catch (e) {
+            return errorResult(`Debugger.pause failed: ${describe(e)}`);
+        }
+        return textResult('# pause_debugger ✓\n\nPause requested. The page will pause on its next JS execution (timer fire / event handler / promise tick). Call `resume_debugger` to unblock.');
+    },
+};
+export const resumeDebuggerTool = {
+    name: 'resume_debugger',
+    description: 'Resume JavaScript execution if paused, via WIP `Debugger.resume` (probe-confirmed 2026-05-16). Safe to call unconditionally — silently no-ops if not paused.',
+    inputSchema: {},
+    handler: async () => {
+        let ps;
+        try {
+            ps = await PageSession.get();
+        }
+        catch (e) {
+            return errorResult(`Unable to attach: ${describe(e)}`);
+        }
+        await ensureEnabled(ps);
+        try {
+            await ps.session.send('Debugger.resume', undefined, 5_000);
+        }
+        catch (e) {
+            const err = e;
+            if (err.message?.includes('Was not paused'))
+                return textResult('# resume_debugger ✓ (was not paused, no-op)');
+            return errorResult(`Debugger.resume failed: ${describe(e)}`);
+        }
+        return textResult('# resume_debugger ✓');
+    },
+};
+export const setBreakpointByUrlTool = {
+    name: 'set_breakpoint_by_url',
+    description: 'Set a JavaScript breakpoint by source URL + line via WIP `Debugger.setBreakpointByUrl` (probe-confirmed 2026-05-16). Returns breakpointId for later removal (not yet exposed) and resolved source locations.',
+    inputSchema: {
+        url: z.string().min(1).describe('Source URL pattern (exact match unless urlRegex used).'),
+        lineNumber: z.number().int().min(0).describe('0-based line number in source.'),
+        columnNumber: z.number().int().min(0).optional().describe('0-based column (default 0).'),
+        condition: z.string().optional().describe('JS expression — break only when expression evaluates truthy in scope.'),
+    },
+    handler: async ({ url, lineNumber, columnNumber = 0, condition }) => {
+        let ps;
+        try {
+            ps = await PageSession.get();
+        }
+        catch (e) {
+            return errorResult(`Unable to attach: ${describe(e)}`);
+        }
+        await ensureEnabled(ps);
+        let r;
+        try {
+            r = await ps.session.send('Debugger.setBreakpointByUrl', {
+                url, lineNumber, columnNumber, ...(condition ? { condition } : {}),
+            }, 10_000);
+        }
+        catch (e) {
+            return errorResult(`Debugger.setBreakpointByUrl failed: ${describe(e)}`);
+        }
+        const lines = [
+            `# set_breakpoint_by_url ✓ \`${r.breakpointId}\``,
+            '',
+            `URL: ${url}:${lineNumber}:${columnNumber}${condition ? ` (when: ${condition})` : ''}`,
+            `Resolved locations: ${r.locations?.length ?? 0}${(r.locations?.length ?? 0) === 0 ? ' (no script loaded matches yet — breakpoint will activate when matching script loads)' : ''}`,
+        ];
+        if (r.locations?.length) {
+            lines.push('');
+            for (const loc of r.locations)
+                lines.push(`- scriptId=${loc.scriptId} line=${loc.lineNumber} col=${loc.columnNumber}`);
+        }
+        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=debugger.js.map

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

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

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

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

package/build/src/tools/delete_cookie.js

@@ -0,0 +1,33 @@
+import { z } from 'zod';
+import { PageSession } from '../page-session.js';
+export const deleteCookieTool = {
+    name: 'delete_cookie',
+    description: [
+        'Delete a single cookie by name + URL via WIP `Page.deleteCookie` (Apple-specific, probe-confirmed 2026-05-16).',
+        'NOTE: WIP\'s `Network.deleteCookies` is NOT exposed on iOS — only `Page.deleteCookie` works, and it takes `cookieName` + `url` (not domain/path).',
+    ].join(' '),
+    inputSchema: {
+        cookieName: z.string().min(1).describe('Exact cookie name to delete.'),
+        url: z.string().url().describe('Origin URL the cookie is scoped to (e.g. https://example.com).'),
+    },
+    handler: async ({ cookieName, url }) => {
+        let ps;
+        try {
+            ps = await PageSession.get();
+        }
+        catch (e) {
+            return errorResult(`Unable to attach: ${describe(e)}`);
+        }
+        try {
+            await ps.session.send('Page.deleteCookie', { cookieName, url }, 10_000);
+        }
+        catch (e) {
+            return errorResult(`Page.deleteCookie failed: ${describe(e)}`);
+        }
+        return textResult(`# delete_cookie ✓\n\nname: \`${cookieName}\` · url: \`${url}\`\n\nRun \`get_cookies\` with \`nameSubstring=${cookieName}\` to verify removal.`);
+    },
+};
+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=delete_cookie.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delete_cookie.js","sourceRoot":"","sources":["../../../src/tools/delete_cookie.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE;QACX,gHAAgH;QAChH,mJAAmJ;KACpJ,CAAC,IAAI,CAAC,GAAG,CAAC;IAEX,WAAW,EAAE;QACX,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,8BAA8B,CAAC;QACtE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,gEAAgE,CAAC;KACjG;IAED,OAAO,EAAE,KAAK,EAAE,EAAE,UAAU,EAAE,GAAG,EAAuC,EAAE,EAAE;QAC1E,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,IAAI,CAAC;YAAC,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,EAAE,MAAM,CAAC,CAAC;QAAC,CAAC;QAChF,OAAO,CAAC,EAAE,CAAC;YAAC,OAAO,WAAW,CAAC,6BAA6B,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAAC,CAAC;QAC7E,OAAO,UAAU,CAAC,gCAAgC,UAAU,eAAe,GAAG,kDAAkD,UAAU,uBAAuB,CAAC,CAAC;IACrK,CAAC;CACF,CAAC;AAEF,SAAS,UAAU,CAAC,IAAY,IAAI,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAC5F,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/drag.d.ts

@@ -0,0 +1,40 @@
+import { z } from 'zod';
+/**
+ * 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 keeps the inner expression synchronous.
+ * Per-step delay is implemented by issuing one Runtime.evaluate per pointermove
+ * step from TS land when `stepDelayMs > 0`. When `stepDelayMs === 0`, the entire
+ * sequence runs in a single sync IIFE.
+ */
+export declare const dragTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        fromSelector: z.ZodString;
+        fromNth: z.ZodOptional<z.ZodNumber>;
+        toSelector: z.ZodOptional<z.ZodString>;
+        toNth: z.ZodOptional<z.ZodNumber>;
+        dx: z.ZodOptional<z.ZodNumber>;
+        dy: z.ZodOptional<z.ZodNumber>;
+        steps: z.ZodOptional<z.ZodNumber>;
+        stepDelayMs: z.ZodOptional<z.ZodNumber>;
+        waitAfterMs: z.ZodOptional<z.ZodNumber>;
+    };
+    handler: ({ fromSelector, fromNth, toSelector, toNth, dx, dy, steps, stepDelayMs, waitAfterMs, }: {
+        fromSelector: string;
+        fromNth?: number;
+        toSelector?: string;
+        toNth?: number;
+        dx?: number;
+        dy?: number;
+        steps?: number;
+        stepDelayMs?: number;
+        waitAfterMs?: number;
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};