ios-webkit-mcp 0.18.3

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

@@ -0,0 +1,39 @@
+import { z } from 'zod';
+/**
+ * WIP has neither `Page.javascriptDialogOpening` events nor
+ * `Page.handleJavaScriptDialog` method — verified `-32601` for both. The iOS
+ * WebView surfaces `window.alert/confirm/prompt` as native UI handled by the
+ * host app's WKUIDelegate, completely outside WIP's reach.
+ *
+ * This tool overrides `window.alert/confirm/prompt` from JS land:
+ *   - `install` mode: monkey-patches the three globals to record each call in
+ *     `window.__wdm_dialogs` and short-circuit return preset responses
+ *   - `list` mode: returns the captured queue
+ *   - `set_response` mode: updates the preset response for subsequent confirm/prompt
+ *   - `uninstall` mode: restores the natives
+ *
+ * Because the override returns synchronously, no native iOS dialog UI appears.
+ * Pages that depend on the actual dialog blocking (e.g. "wait for user to dismiss
+ * the alert") may behave differently than in a real user session.
+ */
+export declare const handleDialogTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        mode: z.ZodEnum<["install", "list", "set_response", "uninstall"]>;
+        confirmResponse: z.ZodOptional<z.ZodBoolean>;
+        promptResponse: z.ZodOptional<z.ZodString>;
+        clearQueue: z.ZodOptional<z.ZodBoolean>;
+    };
+    handler: ({ mode, confirmResponse, promptResponse, clearQueue, }: {
+        mode: "install" | "list" | "set_response" | "uninstall";
+        confirmResponse?: boolean;
+        promptResponse?: string;
+        clearQueue?: boolean;
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};

package/build/src/tools/handle_dialog.js

@@ -0,0 +1,182 @@
+import { z } from 'zod';
+import { PageSession } from '../page-session.js';
+/**
+ * WIP has neither `Page.javascriptDialogOpening` events nor
+ * `Page.handleJavaScriptDialog` method — verified `-32601` for both. The iOS
+ * WebView surfaces `window.alert/confirm/prompt` as native UI handled by the
+ * host app's WKUIDelegate, completely outside WIP's reach.
+ *
+ * This tool overrides `window.alert/confirm/prompt` from JS land:
+ *   - `install` mode: monkey-patches the three globals to record each call in
+ *     `window.__wdm_dialogs` and short-circuit return preset responses
+ *   - `list` mode: returns the captured queue
+ *   - `set_response` mode: updates the preset response for subsequent confirm/prompt
+ *   - `uninstall` mode: restores the natives
+ *
+ * Because the override returns synchronously, no native iOS dialog UI appears.
+ * Pages that depend on the actual dialog blocking (e.g. "wait for user to dismiss
+ * the alert") may behave differently than in a real user session.
+ */
+export const handleDialogTool = {
+    name: 'handle_dialog',
+    description: [
+        'Manage `window.alert` / `confirm` / `prompt` interception on the inspected iOS WebView page.',
+        'NOTE: WIP has no `Page.javascriptDialogOpening` event or `Page.handleJavaScriptDialog` method (verified `-32601`). This tool monkey-patches the three globals from JS — synthetic, no real iOS dialog UI fires after install. Use this to capture dialog text the page would have shown and to pre-set the return value for `confirm` / `prompt`.',
+        'Modes: `install` (overrides + start recording), `list` (read captured queue), `set_response` (update default return), `uninstall` (restore natives).',
+    ].join(' '),
+    inputSchema: {
+        mode: z
+            .enum(['install', 'list', 'set_response', 'uninstall'])
+            .describe('install | list | set_response | uninstall.'),
+        confirmResponse: z
+            .boolean()
+            .optional()
+            .describe('install / set_response: value returned to `confirm()`. Default true.'),
+        promptResponse: z
+            .string()
+            .optional()
+            .describe('install / set_response: value returned to `prompt()`. Default "".'),
+        clearQueue: z
+            .boolean()
+            .optional()
+            .describe('list: also clear the queue after reading. Default false.'),
+    },
+    handler: async ({ mode, confirmResponse, promptResponse, clearQueue = false, }) => {
+        let ps;
+        try {
+            ps = await PageSession.get();
+        }
+        catch (e) {
+            return errorResult(`Unable to attach to a WKWebView page: ${describe(e)}`);
+        }
+        let expression;
+        if (mode === 'install') {
+            const cr = confirmResponse === undefined ? 'true' : String(confirmResponse);
+            const pr = JSON.stringify(promptResponse ?? '');
+            expression = `
+        (() => {
+          const state = window.__wdm_dialog_state = window.__wdm_dialog_state || {
+            installed: false, alert: null, confirm: null, prompt: null,
+            response: { confirm: true, prompt: '' },
+          };
+          state.response.confirm = ${cr};
+          state.response.prompt = ${pr};
+          if (state.installed) return { ok: true, alreadyInstalled: true, response: state.response };
+          state.alert = window.alert; state.confirm = window.confirm; state.prompt = window.prompt;
+          window.__wdm_dialogs = window.__wdm_dialogs || [];
+          window.alert = function (msg) {
+            window.__wdm_dialogs.push({ type: 'alert', text: String(msg ?? ''), ts: Date.now() });
+          };
+          window.confirm = function (msg) {
+            window.__wdm_dialogs.push({ type: 'confirm', text: String(msg ?? ''), ts: Date.now() });
+            return state.response.confirm;
+          };
+          window.prompt = function (msg, defaultValue) {
+            window.__wdm_dialogs.push({ type: 'prompt', text: String(msg ?? ''), defaultValue: defaultValue == null ? null : String(defaultValue), ts: Date.now() });
+            return state.response.prompt;
+          };
+          state.installed = true;
+          return { ok: true, installed: true, response: state.response };
+        })()
+      `;
+        }
+        else if (mode === 'list') {
+            expression = `
+        (() => {
+          const queue = (window.__wdm_dialogs || []).slice();
+          if (${clearQueue}) window.__wdm_dialogs = [];
+          return { ok: true, queue, installed: (window.__wdm_dialog_state || {}).installed === true };
+        })()
+      `;
+        }
+        else if (mode === 'set_response') {
+            const cr = confirmResponse === undefined ? 'undefined' : String(confirmResponse);
+            const pr = promptResponse === undefined ? 'undefined' : JSON.stringify(promptResponse);
+            expression = `
+        (() => {
+          const state = window.__wdm_dialog_state;
+          if (!state || !state.installed) return { ok: false, reason: 'not_installed' };
+          if (${cr} !== undefined) state.response.confirm = ${cr};
+          if (${pr} !== undefined) state.response.prompt = ${pr};
+          return { ok: true, response: state.response };
+        })()
+      `;
+        }
+        else {
+            expression = `
+        (() => {
+          const state = window.__wdm_dialog_state;
+          if (!state || !state.installed) return { ok: true, alreadyUninstalled: true };
+          if (state.alert) window.alert = state.alert;
+          if (state.confirm) window.confirm = state.confirm;
+          if (state.prompt) window.prompt = state.prompt;
+          state.installed = false;
+          return { ok: true, uninstalled: true };
+        })()
+      `;
+        }
+        let result;
+        try {
+            result = await ps.session.send('Runtime.evaluate', { expression, returnByValue: true, awaitPromise: false }, 10_000);
+        }
+        catch (e) {
+            return errorResult(`Runtime.evaluate (handle_dialog ${mode}) failed: ${describe(e)}`);
+        }
+        const v = result?.result?.value;
+        if (!v || v.ok !== true) {
+            return errorResult(`# handle_dialog (${mode}): failed\n\n${JSON.stringify(v)}`);
+        }
+        if (mode === 'list') {
+            const queue = v.queue ?? [];
+            const lines = [
+                `# handle_dialog list — ${queue.length} captured · installed: ${v.installed}`,
+                '',
+            ];
+            if (queue.length === 0) {
+                lines.push('(No dialogs intercepted. Either install first or page hasn\'t triggered one.)');
+            }
+            else {
+                queue.forEach((d, i) => {
+                    const ts = typeof d.ts === 'number' ? new Date(d.ts).toISOString() : '';
+                    lines.push(`## [${i + 1}] ${d.type}${ts ? ` · ${ts}` : ''}`);
+                    lines.push(`text: ${JSON.stringify(d.text)}`);
+                    if (d.defaultValue != null)
+                        lines.push(`defaultValue: ${JSON.stringify(d.defaultValue)}`);
+                    lines.push('');
+                });
+            }
+            return textResult(lines.join('\n'));
+        }
+        if (mode === 'install') {
+            const resp = v.response;
+            return textResult([
+                `# handle_dialog install ✓${v.alreadyInstalled ? ' (already installed — response updated)' : ''}`,
+                '',
+                `confirm() default response: ${resp.confirm}`,
+                `prompt() default response: ${JSON.stringify(resp.prompt)}`,
+                '',
+                '⚠ Synthetic: alert/confirm/prompt return immediately, no native UI fires. Pages depending on real dialog blocking semantics may diverge.',
+            ].join('\n'));
+        }
+        if (mode === 'set_response') {
+            const resp = v.response;
+            return textResult([
+                `# handle_dialog set_response ✓`,
+                '',
+                `confirm() response: ${resp.confirm}`,
+                `prompt() response: ${JSON.stringify(resp.prompt)}`,
+            ].join('\n'));
+        }
+        return textResult([`# handle_dialog uninstall ✓${v.alreadyUninstalled ? ' (was already uninstalled)' : ''}`].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=handle_dialog.js.map

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

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

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

@@ -0,0 +1,41 @@
+/**
+ * `highlight_node` + `hide_highlight` (batch-13 Should) — visual feedback loop
+ * for AI agents picking DOM elements.
+ *
+ * Probe-confirmed (2026-05-17):
+ *   - DOM.highlightNode ✅ (needs valid nodeId)
+ *   - DOM.hideHighlight ✅
+ *
+ * The Apple WIP `DOM.highlightNode` schema differs from CDP — uses
+ * `highlightConfig: { contentColor: { r, g, b, a } }` etc. Default config draws
+ * a translucent blue overlay that's visible on screen + in screenshots.
+ */
+import { z } from 'zod';
+export declare const highlightNodeTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        selector: z.ZodString;
+        showInfo: z.ZodOptional<z.ZodBoolean>;
+    };
+    handler: ({ selector, showInfo }: {
+        selector: string;
+        showInfo?: boolean;
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};
+export declare const hideHighlightTool: {
+    name: string;
+    description: string;
+    inputSchema: {};
+    handler: () => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};

package/build/src/tools/highlight_node.js

@@ -0,0 +1,95 @@
+/**
+ * `highlight_node` + `hide_highlight` (batch-13 Should) — visual feedback loop
+ * for AI agents picking DOM elements.
+ *
+ * Probe-confirmed (2026-05-17):
+ *   - DOM.highlightNode ✅ (needs valid nodeId)
+ *   - DOM.hideHighlight ✅
+ *
+ * The Apple WIP `DOM.highlightNode` schema differs from CDP — uses
+ * `highlightConfig: { contentColor: { r, g, b, a } }` etc. Default config draws
+ * a translucent blue overlay that's visible on screen + in screenshots.
+ */
+import { z } from 'zod';
+import { PageSession } from '../page-session.js';
+const DEFAULT_HIGHLIGHT = {
+    showInfo: true,
+    contentColor: { r: 111, g: 168, b: 220, a: 0.4 },
+    paddingColor: { r: 147, g: 196, b: 125, a: 0.4 },
+    borderColor: { r: 255, g: 229, b: 153, a: 0.4 },
+    marginColor: { r: 246, g: 178, b: 107, a: 0.4 },
+};
+export const highlightNodeTool = {
+    name: 'highlight_node',
+    description: [
+        'Visually highlight a DOM element on the inspected iOS WebView page via WIP `DOM.highlightNode` (✅ probe 2026-05-17).',
+        'Useful for "AI selected this element — let me confirm visually" loops. The highlight overlay is visible both on the device screen and in subsequent `take_screenshot` results.',
+        'Pair with `hide_highlight` to clear, or call again with a different selector to switch target. Highlight clears automatically when the page navigates.',
+    ].join(' '),
+    inputSchema: {
+        selector: z.string().min(1).describe('CSS selector of the element to highlight (first match used).'),
+        showInfo: z
+            .boolean()
+            .optional()
+            .describe('Overlay show width × height + tag tooltip (default true).'),
+    },
+    handler: async ({ selector, showInfo = true }) => {
+        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(`# highlight_node — 0 nodes match \`${selector}\``);
+            nodeId = r.nodeId;
+        }
+        catch (e) {
+            return errorResult(`DOM.querySelector failed: ${describe(e)}`);
+        }
+        try {
+            await ps.session.send('DOM.highlightNode', { highlightConfig: { ...DEFAULT_HIGHLIGHT, showInfo }, nodeId }, 5_000);
+        }
+        catch (e) {
+            return errorResult(`DOM.highlightNode failed: ${describe(e)}`);
+        }
+        return textResult(`# highlight_node ✓ \`${selector}\` (nodeId=${nodeId})\n\nOverlay visible on device + screenshots. Call \`hide_highlight\` to clear.`);
+    },
+};
+export const hideHighlightTool = {
+    name: 'hide_highlight',
+    description: 'Clear any active DOM highlight overlay via WIP `DOM.hideHighlight` (✅ probe 2026-05-17). Safe to call unconditionally — no-op if nothing was highlighted.',
+    inputSchema: {},
+    handler: async () => {
+        let ps;
+        try {
+            ps = await PageSession.get();
+        }
+        catch (e) {
+            return errorResult(`Unable to attach: ${describe(e)}`);
+        }
+        try {
+            await ps.session.send('DOM.hideHighlight', {}, 5_000);
+        }
+        catch (e) {
+            return errorResult(`DOM.hideHighlight failed: ${describe(e)}`);
+        }
+        return textResult('# hide_highlight ✓');
+    },
+};
+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=highlight_node.js.map

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

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

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

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

package/build/src/tools/hover.js

@@ -0,0 +1,89 @@
+import { z } from 'zod';
+import { PageSession } from '../page-session.js';
+export const hoverTool = {
+    name: 'hover',
+    description: [
+        'Dispatch hover-style pointer events (`pointerover` + `mouseover` + `pointermove` + `mousemove` + `pointerenter` + `mouseenter`) on an element on the inspected iOS WebView page.',
+        'NOTE: WIP has no `Input.dispatchMouseEvent`. Synthetic Events via `Runtime.evaluate` — `isTrusted=false`, native :hover styles still apply because the events flow through normal DOM bubbling, but underlying iOS WebKit hit-testing is NOT involved (no real mouse cursor on touch devices).',
+        'Selector matches via `document.querySelectorAll(selector)[nth]`. Coordinates default to the element\'s center.',
+    ].join(' '),
+    inputSchema: {
+        selector: z.string().min(1).describe('CSS selector for the element to hover.'),
+        nth: z.number().int().min(0).optional().describe('Pick the Nth match. Default 0.'),
+        waitAfterMs: z.number().int().min(0).max(10_000).optional().describe('Block after hover for this long (default 100).'),
+    },
+    handler: async ({ selector, nth = 0, waitAfterMs = 100, }) => {
+        let ps;
+        try {
+            ps = await PageSession.get();
+        }
+        catch (e) {
+            return errorResult(`Unable to attach to a WKWebView page: ${describe(e)}`);
+        }
+        const selJson = 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', found: matches.length };
+        const el = matches[${nth}];
+        const rect = el.getBoundingClientRect();
+        const cx = rect.x + rect.width / 2;
+        const cy = rect.y + rect.height / 2;
+        const tag = el.tagName.toLowerCase();
+        const visible = rect.width > 0 && rect.height > 0;
+        const init = {
+          bubbles: true, cancelable: true,
+          clientX: cx, clientY: cy,
+          pointerType: 'mouse', pointerId: 1, isPrimary: true,
+          button: 0, buttons: 0,
+        };
+        try {
+          el.dispatchEvent(new PointerEvent('pointerover', init));
+          el.dispatchEvent(new MouseEvent('mouseover', init));
+          el.dispatchEvent(new PointerEvent('pointerenter', init));
+          el.dispatchEvent(new MouseEvent('mouseenter', init));
+          el.dispatchEvent(new PointerEvent('pointermove', init));
+          el.dispatchEvent(new MouseEvent('mousemove', init));
+        } catch (e) {
+          return { ok: false, reason: 'dispatch_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 (hover) 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(`# hover: failed\n\nselector: \`${selector}\`\n\n${JSON.stringify(v)}`);
+        }
+        return textResult([
+            `# hover ✓ ${selector}`,
+            '',
+            `tag: \`<${v.tag}>\``,
+            `match count: ${v.foundCount} (picked nth=${nth})`,
+            `visible: ${v.visible}`,
+            `rect: ${JSON.stringify(v.rect)}`,
+            '',
+            '⚠ Synthetic Pointer / Mouse events. iOS is a touch platform, so genuine `:hover` only persists until the next pointer cancel; long-lived hover UIs may rely on real mouse cursors and will not stick.',
+        ].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=hover.js.map

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

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

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

@@ -0,0 +1,81 @@
+/**
+ * batch-14 intercept full state machine — fulfills the contract frozen in
+ * cross-review v2.0.1 R3 + spec §"intercept 完整状态机 (batch-14 契约)":
+ *
+ *   - requestId 生命周期：`Network.requestIntercepted` → buffered in PageSession
+ *     → consumed by `intercept_continue` / `intercept_respond` → drained.
+ *   - 并发上限：16 pending. Overflow auto-continues the oldest.
+ *   - 超时：30s without consumption → auto-continue (page does NOT hang).
+ *   - 显式 abort 语义：`intercept_continue(reqId, abort=true)` blocks the
+ *     request via `Network.interceptContinue` with `errorReason=BlockedByClient`.
+ *
+ * Apple WIP methods (probe-confirmed 2026-05-17):
+ *   - Network.setInterceptionEnabled ✅ returns {}
+ *   - Network.addInterception ✅ returns {} for any url pattern
+ *   - Network.interceptContinue ✅ (probe shows method exists)
+ *   - Network.interceptWithResponse ✅ (probe shows method exists)
+ *
+ * ⚠ **iOS WKWebView limitation (2026-05-17 实测)**: Even though the methods
+ * above all return `{}` success, `Network.requestIntercepted` event is NEVER
+ * fired for matching requests on iOS 26.5.0 + Apple system WKWebView. The
+ * underlying WebKit interception machinery is a no-op on iOS. iwdp-mcp's
+ * fulfill/continue flow validated against macOS Safari, where it works.
+ *
+ * Tools below are coded correctly per the WIP spec — they will Just Work the
+ * day Apple ships interception runtime in iOS WKWebView (or when this MCP is
+ * pointed at macOS Safari via a different transport). For now, calling
+ * `set_request_interception` does nothing observable; `list_intercepted_requests`
+ * always returns 0.
+ */
+import { z } from 'zod';
+export declare const listInterceptedRequestsTool: {
+    name: string;
+    description: string;
+    inputSchema: {};
+    handler: () => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};
+export declare const interceptContinueTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        requestId: z.ZodString;
+        abort: z.ZodOptional<z.ZodBoolean>;
+    };
+    handler: ({ requestId, abort }: {
+        requestId: string;
+        abort?: boolean;
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};
+export declare const interceptRespondTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        requestId: z.ZodString;
+        statusCode: z.ZodOptional<z.ZodNumber>;
+        headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        body: z.ZodString;
+        base64: z.ZodOptional<z.ZodBoolean>;
+    };
+    handler: ({ requestId, statusCode, headers, body, base64 }: {
+        requestId: string;
+        statusCode?: number;
+        headers?: Record<string, string>;
+        body: string;
+        base64?: boolean;
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};