ios-webkit-mcp 0.18.3

package/build/src/tools/take_memory_snapshot.js

@@ -0,0 +1,88 @@
+import { z } from 'zod';
+import { PageSession } from '../page-session.js';
+export const takeMemorySnapshotTool = {
+    name: 'take_memory_snapshot',
+    description: [
+        'Capture a JavaScript heap snapshot from the inspected iOS WebView page using WIP `Heap.snapshot`.',
+        'IMPORTANT: The snapshot is in **Apple Inspector heap format** (`{version, type, nodes, edges, …}`), NOT the V8 / Chrome `.heapsnapshot` format. Tools that ingest CDP `HeapProfiler.takeHeapSnapshot` output will not understand this directly.',
+        'Returns a summary (node count, edge count, root count) plus optionally the raw JSON.',
+    ].join(' '),
+    inputSchema: {
+        includeRaw: z
+            .boolean()
+            .optional()
+            .describe('Include the full raw `snapshotData` JSON in output (large; default false — only summary).'),
+        maxRawChars: z
+            .number()
+            .int()
+            .min(1_000)
+            .max(2_000_000)
+            .optional()
+            .describe('Cap raw JSON output length when includeRaw=true (default 50_000, truncated with "…" marker).'),
+    },
+    handler: async ({ includeRaw = false, maxRawChars = 50_000, }) => {
+        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('Heap.snapshot', {}, 60_000);
+        }
+        catch (e) {
+            return errorResult(`Heap.snapshot failed: ${describe(e)}`);
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(result.snapshotData);
+        }
+        catch {
+            // raw output may not be JSON in some unforeseen cases
+        }
+        const lines = [];
+        lines.push(`# take_memory_snapshot`);
+        lines.push('');
+        if (ps.attachInfo) {
+            lines.push(`Target: page id ${ps.attachInfo.pageId} (${ps.attachInfo.pageTitle || ps.attachInfo.pageUrl})`);
+        }
+        lines.push(`Timestamp (WIP): ${result.timestamp}`);
+        lines.push(`Raw size: ${result.snapshotData.length} chars`);
+        if (parsed) {
+            const nodes = Array.isArray(parsed['nodes']) ? parsed['nodes'].length : '(unknown)';
+            const edges = Array.isArray(parsed['edges']) ? parsed['edges'].length : '(unknown)';
+            const roots = Array.isArray(parsed['roots']) ? parsed['roots'].length : '(unknown)';
+            const version = parsed['version'];
+            const type = parsed['type'];
+            lines.push(`Format: ${type ?? '(unknown type)'} v${version ?? '?'}`);
+            lines.push(`Nodes: ${nodes} · Edges: ${edges} · Roots: ${roots}`);
+        }
+        else {
+            lines.push('(snapshotData was not parseable JSON — content shown below as-is)');
+        }
+        lines.push('');
+        lines.push('⚠ Apple Inspector heap format — NOT V8 `.heapsnapshot`. Chrome DevTools cannot load this directly.');
+        if (includeRaw) {
+            lines.push('');
+            lines.push('## Raw snapshotData');
+            lines.push('```json');
+            lines.push(result.snapshotData.length > maxRawChars
+                ? result.snapshotData.slice(0, maxRawChars) + `…\n(truncated, ${result.snapshotData.length - maxRawChars} more chars)`
+                : result.snapshotData);
+            lines.push('```');
+        }
+        return textResult(lines.join('\n'));
+    },
+};
+function textResult(text) {
+    return { content: [{ type: 'text', text }] };
+}
+function errorResult(text) {
+    return { content: [{ type: 'text', text }], isError: true };
+}
+function describe(e) {
+    return e instanceof Error ? e.message : String(e);
+}
+//# sourceMappingURL=take_memory_snapshot.js.map

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

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

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

@@ -0,0 +1,29 @@
+import { z } from 'zod';
+export declare const takeNodeScreenshotTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        selector: z.ZodString;
+    };
+    handler: ({ selector }: {
+        selector: string;
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+        isError: boolean;
+    } | {
+        content: ({
+            type: "image";
+            data: string;
+            mimeType: string;
+            text?: undefined;
+        } | {
+            type: "text";
+            text: string;
+            data?: undefined;
+            mimeType?: undefined;
+        })[];
+    }>;
+};

package/build/src/tools/take_node_screenshot.js

@@ -0,0 +1,57 @@
+import { z } from 'zod';
+import { PageSession } from '../page-session.js';
+export const takeNodeScreenshotTool = {
+    name: 'take_node_screenshot',
+    description: [
+        'Capture a screenshot of a specific element on the inspected iOS WebView page via WIP `Page.snapshotNode` (Apple-specific, probe-confirmed 2026-05-16).',
+        'Resolves selector → nodeId via `DOM.getDocument` + `DOM.querySelector`, then snapshots the element only (not the surrounding viewport).',
+        'Returns base64 PNG. More context-efficient than `take_screenshot` when AI only needs to see one widget.',
+    ].join(' '),
+    inputSchema: {
+        selector: z.string().min(1).describe('CSS selector for the element to screenshot.'),
+    },
+    handler: async ({ selector }) => {
+        let ps;
+        try {
+            ps = await PageSession.get();
+        }
+        catch (e) {
+            return errorResult(`Unable to attach: ${describe(e)}`);
+        }
+        let nodeId;
+        try {
+            const doc = await ps.session.send('DOM.getDocument', { depth: 0 }, 10_000);
+            const qs = await ps.session.send('DOM.querySelector', { nodeId: doc.root.nodeId, selector }, 10_000);
+            if (qs.nodeId === 0)
+                return errorResult(`# take_node_screenshot — no match for \`${selector}\``);
+            nodeId = qs.nodeId;
+        }
+        catch (e) {
+            return errorResult(`DOM resolve failed: ${describe(e)}`);
+        }
+        let r;
+        try {
+            r = await ps.session.send('Page.snapshotNode', { nodeId }, 30_000);
+        }
+        catch (e) {
+            return errorResult(`Page.snapshotNode failed: ${describe(e)}`);
+        }
+        if (!r.dataURL?.startsWith('data:image/'))
+            return errorResult(`Unexpected dataURL: ${String(r.dataURL).slice(0, 60)}`);
+        const m = r.dataURL.match(/^data:(image\/[^;]+);base64,(.+)$/);
+        if (!m)
+            return errorResult('Unrecognized dataURL format.');
+        const mimeType = m[1];
+        const base64 = m[2];
+        const sizeKb = Math.round((base64.length * 3) / 4 / 1024);
+        return {
+            content: [
+                { type: 'image', data: base64, mimeType },
+                { type: 'text', text: `# take_node_screenshot · ${mimeType} (~${sizeKb} KB)\n\nselector: \`${selector}\` · nodeId: ${nodeId}` },
+            ],
+        };
+    },
+};
+function errorResult(text) { return { content: [{ type: 'text', text }], isError: true }; }
+function describe(e) { return e instanceof Error ? e.message : String(e); }
+//# sourceMappingURL=take_node_screenshot.js.map

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

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

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

@@ -0,0 +1,51 @@
+import { z } from 'zod';
+export declare const takeScreenshotTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        rect: z.ZodOptional<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        }, {
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        }>>;
+        coordinateSystem: z.ZodOptional<z.ZodEnum<["Viewport", "Page"]>>;
+    };
+    handler: ({ rect, coordinateSystem, }: {
+        rect?: {
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        };
+        coordinateSystem?: "Viewport" | "Page";
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+        isError: boolean;
+    } | {
+        content: ({
+            type: "image";
+            data: string;
+            mimeType: string;
+            text?: undefined;
+        } | {
+            type: "text";
+            text: string;
+            data?: undefined;
+            mimeType?: undefined;
+        })[];
+    }>;
+};

package/build/src/tools/take_screenshot.js

@@ -0,0 +1,108 @@
+import { z } from 'zod';
+import { PageSession } from '../page-session.js';
+export const takeScreenshotTool = {
+    name: 'take_screenshot',
+    description: [
+        'Capture a screenshot of the inspected iOS WebView page using WIP `Page.snapshotRect` (Apple-specific; the CDP-style `Page.captureScreenshot` is NOT implemented on iOS — verified `-32601 not found`).',
+        'Returns a base64 PNG image. By default captures the current viewport at the device DPR; pass an explicit `rect` for a sub-region.',
+        'Note: WIP only captures the rect you specify — there is no built-in "full page" mode like Chrome\'s. To screenshot a region you can see, leave rect empty and accept the current viewport.',
+    ].join(' '),
+    inputSchema: {
+        rect: z
+            .object({
+            x: z.number().int().min(0),
+            y: z.number().int().min(0),
+            width: z.number().int().min(1),
+            height: z.number().int().min(1),
+        })
+            .optional()
+            .describe('Optional viewport rect (CSS pixels). Defaults to (0,0, viewportW, viewportH).'),
+        coordinateSystem: z
+            .enum(['Viewport', 'Page'])
+            .optional()
+            .describe('WIP coordinate system. `Viewport` (default) treats rect as CSS-pixel offsets within the visible viewport; `Page` is full-page coords.'),
+    },
+    handler: async ({ rect, coordinateSystem = 'Viewport', }) => {
+        let ps;
+        try {
+            ps = await PageSession.get();
+        }
+        catch (e) {
+            return errorResult(`Unable to attach to a WKWebView page: ${describe(e)}`);
+        }
+        // If no rect supplied, query viewport dimensions via Runtime.evaluate.
+        let useRect = rect;
+        let viewport;
+        if (!useRect) {
+            try {
+                const r = await ps.session.send('Runtime.evaluate', {
+                    expression: 'JSON.stringify({innerWidth: window.innerWidth, innerHeight: window.innerHeight, scrollX: window.scrollX, scrollY: window.scrollY, dpr: window.devicePixelRatio})',
+                    returnByValue: false,
+                });
+                // The string value comes back as JSON-of-JSON; with returnByValue:false we get description; flip approach
+            }
+            catch {
+                // ignore
+            }
+            try {
+                const r2 = await ps.session.send('Runtime.evaluate', {
+                    expression: 'JSON.stringify({innerWidth: window.innerWidth, innerHeight: window.innerHeight, scrollX: window.scrollX, scrollY: window.scrollY, dpr: window.devicePixelRatio})',
+                    returnByValue: true,
+                });
+                if (r2?.result?.value) {
+                    viewport = JSON.parse(r2.result.value);
+                    useRect = { x: viewport.scrollX, y: viewport.scrollY, width: viewport.innerWidth, height: viewport.innerHeight };
+                }
+            }
+            catch {
+                // fallback
+            }
+            if (!useRect) {
+                useRect = { x: 0, y: 0, width: 390, height: 844 }; // iPhone 14/15-ish default
+            }
+        }
+        let result;
+        try {
+            result = await ps.session.send('Page.snapshotRect', {
+                x: useRect.x,
+                y: useRect.y,
+                width: useRect.width,
+                height: useRect.height,
+                coordinateSystem,
+            }, 30_000);
+        }
+        catch (e) {
+            return errorResult(`Page.snapshotRect failed: ${describe(e)}`);
+        }
+        if (!result.dataURL || !result.dataURL.startsWith('data:image/')) {
+            return errorResult(`Page.snapshotRect returned no valid dataURL (got: ${String(result.dataURL).slice(0, 80)})`);
+        }
+        const m = result.dataURL.match(/^data:(image\/[^;]+);base64,(.+)$/);
+        if (!m) {
+            return errorResult('Unrecognized dataURL format from Page.snapshotRect.');
+        }
+        const mimeType = m[1];
+        const base64 = m[2];
+        const sizeKb = Math.round((base64.length * 3) / 4 / 1024);
+        return {
+            content: [
+                {
+                    type: 'image',
+                    data: base64,
+                    mimeType,
+                },
+                {
+                    type: 'text',
+                    text: `# take_screenshot · ${mimeType} (~${sizeKb} KB)\n\nRect: ${useRect.x},${useRect.y} ${useRect.width}×${useRect.height} (${coordinateSystem})${viewport ? ` · viewport ${viewport.innerWidth}×${viewport.innerHeight} dpr ${viewport.dpr}` : ''}`,
+                },
+            ],
+        };
+    },
+};
+function errorResult(text) {
+    return { content: [{ type: 'text', text }], isError: true };
+}
+function describe(e) {
+    return e instanceof Error ? e.message : String(e);
+}
+//# sourceMappingURL=take_screenshot.js.map

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

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

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

@@ -0,0 +1,22 @@
+import { z } from 'zod';
+export declare const takeSnapshotTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        depth: z.ZodOptional<z.ZodNumber>;
+        pierce: z.ZodOptional<z.ZodBoolean>;
+        format: z.ZodOptional<z.ZodEnum<["outline", "raw_json"]>>;
+        maxNodes: z.ZodOptional<z.ZodNumber>;
+    };
+    handler: ({ depth, pierce, format, maxNodes, }: {
+        depth?: number;
+        pierce?: boolean;
+        format?: "outline" | "raw_json";
+        maxNodes?: number;
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};

package/build/src/tools/take_snapshot.js

@@ -0,0 +1,142 @@
+import { z } from 'zod';
+import { PageSession } from '../page-session.js';
+export const takeSnapshotTool = {
+    name: 'take_snapshot',
+    description: [
+        'Capture a DOM snapshot of the inspected iOS WebView page.',
+        'Wraps WIP `DOM.getDocument` with optional depth + pierce (shadow DOM / iframes).',
+        'Returns a compact markdown outline by default. Set `format=raw_json` to get the full DOM tree JSON.',
+    ].join(' '),
+    inputSchema: {
+        depth: z
+            .number()
+            .int()
+            .min(-1)
+            .max(20)
+            .optional()
+            .describe('Recursion depth. -1 = full tree (default), 1 = root only.'),
+        pierce: z
+            .boolean()
+            .optional()
+            .describe('Include shadow DOM and iframe content (default true).'),
+        format: z
+            .enum(['outline', 'raw_json'])
+            .optional()
+            .describe('Output format: `outline` (default, compact tree) or `raw_json` (full DOM.getDocument result).'),
+        maxNodes: z
+            .number()
+            .int()
+            .min(10)
+            .max(2_000)
+            .optional()
+            .describe('In outline mode, cap nodes rendered (default 200).'),
+    },
+    handler: async ({ depth = -1, pierce = true, format = 'outline', maxNodes = 200, }) => {
+        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('DOM.getDocument', { depth, pierce }, 20_000);
+        }
+        catch (e) {
+            return errorResult(`DOM.getDocument failed: ${describe(e)}`);
+        }
+        if (format === 'raw_json') {
+            return textResult('```json\n' + JSON.stringify(result, null, 2) + '\n```');
+        }
+        const lines = [];
+        lines.push(`# DOM snapshot`);
+        lines.push('');
+        if (ps.attachInfo) {
+            lines.push(`Page: \`${ps.attachInfo.pageTitle || ps.attachInfo.pageUrl}\` (page id ${ps.attachInfo.pageId})`);
+            lines.push('');
+        }
+        const outline = [];
+        const ctx = { count: 0, cap: maxNodes };
+        renderNode(result.root, 0, outline, ctx);
+        if (ctx.count >= ctx.cap) {
+            outline.push(`… (truncated at ${ctx.cap} nodes; use \`format: "raw_json"\` for full tree)`);
+        }
+        lines.push('```');
+        lines.push(...outline);
+        lines.push('```');
+        return textResult(lines.join('\n'));
+    },
+};
+function renderNode(node, indent, out, ctx) {
+    if (!node)
+        return;
+    if (ctx.count >= ctx.cap)
+        return;
+    ctx.count++;
+    const pad = '  '.repeat(indent);
+    if (node.nodeType === 3) {
+        // text
+        const text = (node.nodeValue ?? '').trim();
+        if (text) {
+            const truncated = text.length > 80 ? text.slice(0, 80) + '…' : text;
+            out.push(`${pad}"${truncated.replace(/"/g, '\\"')}"`);
+        }
+        return;
+    }
+    if (node.nodeType === 8) {
+        out.push(`${pad}<!-- ${(node.nodeValue ?? '').slice(0, 80)} -->`);
+        return;
+    }
+    const name = (node.localName ?? node.nodeName ?? '?').toLowerCase();
+    const attrs = renderAttrs(node.attributes);
+    out.push(`${pad}<${name}${attrs}>`);
+    if (node.children) {
+        for (const c of node.children) {
+            renderNode(c, indent + 1, out, ctx);
+        }
+    }
+    if (node.contentDocument)
+        renderNode(node.contentDocument, indent + 1, out, ctx);
+    if (node.shadowRoots) {
+        for (const r of node.shadowRoots) {
+            out.push(`${'  '.repeat(indent + 1)}#shadow-root`);
+            renderNode(r, indent + 2, out, ctx);
+        }
+    }
+}
+function renderAttrs(arr) {
+    if (!arr || arr.length === 0)
+        return '';
+    const pairs = [];
+    for (let i = 0; i < arr.length; i += 2) {
+        const k = arr[i];
+        const v = arr[i + 1];
+        if (k == null)
+            continue;
+        if (k === 'class' || k === 'id') {
+            pairs.push(`${k}="${(v ?? '').slice(0, 80)}"`);
+        }
+        else if (k === 'src' || k === 'href') {
+            const short = (v ?? '').slice(0, 60);
+            pairs.push(`${k}="${short}${(v?.length ?? 0) > 60 ? '…' : ''}"`);
+        }
+        else {
+            // Skip noisy attrs in outline mode (style/data-*); keep tag terse.
+            if (k.startsWith('data-') || k === 'style')
+                continue;
+            pairs.push(`${k}${v ? `="${(v ?? '').slice(0, 40)}"` : ''}`);
+        }
+    }
+    return pairs.length > 0 ? ' ' + pairs.join(' ') : '';
+}
+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=take_snapshot.js.map

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

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

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

@@ -0,0 +1,34 @@
+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 MUST keep the inner expression synchronous.
+ * Per-char delay is implemented by issuing one Runtime.evaluate per character
+ * from TS land when `delayMs > 0`. When `delayMs === 0`, a single sync IIFE
+ * types the whole string in one round-trip.
+ */
+export declare const typeTextTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        text: z.ZodString;
+        selector: z.ZodOptional<z.ZodString>;
+        nth: z.ZodOptional<z.ZodNumber>;
+        clearFirst: z.ZodOptional<z.ZodBoolean>;
+        delayMs: z.ZodOptional<z.ZodNumber>;
+        waitAfterMs: z.ZodOptional<z.ZodNumber>;
+    };
+    handler: ({ text, selector, nth, clearFirst, delayMs, waitAfterMs, }: {
+        text: string;
+        selector?: string;
+        nth?: number;
+        clearFirst?: boolean;
+        delayMs?: number;
+        waitAfterMs?: number;
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};