ios-webkit-mcp 0.18.3

package/build/src/server.js

@@ -0,0 +1,144 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { listPagesTool } from './tools/list_pages.js';
+import { evaluateScriptTool } from './tools/evaluate_script.js';
+import { listConsoleMessagesTool } from './tools/list_console_messages.js';
+import { listNetworkRequestsTool } from './tools/list_network_requests.js';
+import { takeSnapshotTool } from './tools/take_snapshot.js';
+import { navigatePageTool } from './tools/navigate_page.js';
+import { takeScreenshotTool } from './tools/take_screenshot.js';
+import { takeMemorySnapshotTool } from './tools/take_memory_snapshot.js';
+import { clickTool } from './tools/click.js';
+import { waitForTool } from './tools/wait_for.js';
+import { fillTool } from './tools/fill.js';
+import { typeTextTool } from './tools/type_text.js';
+import { pressKeyTool } from './tools/press_key.js';
+import { hoverTool } from './tools/hover.js';
+import { dragTool } from './tools/drag.js';
+import { getConsoleMessageTool } from './tools/get_console_message.js';
+import { getNetworkRequestTool } from './tools/get_network_request.js';
+import { fillFormTool } from './tools/fill_form.js';
+import { handleDialogTool } from './tools/handle_dialog.js';
+import { selectPageTool } from './tools/select_page.js';
+import { wipSendTool } from './tools/wip_send.js';
+import { reloadPageTool } from './tools/reload_page.js';
+import { setExtraHttpHeadersTool } from './tools/set_extra_http_headers.js';
+import { queryDomNodeTool } from './tools/query_dom_node.js';
+import { getResourceTreeTool } from './tools/get_resource_tree.js';
+import { getPerformanceMetricsTool } from './tools/get_performance_metrics.js';
+import { takeNodeScreenshotTool } from './tools/take_node_screenshot.js';
+import { getCookiesTool } from './tools/get_cookies.js';
+import { deleteCookieTool } from './tools/delete_cookie.js';
+import { gcHeapTool } from './tools/gc_heap.js';
+import { clearConsoleTool } from './tools/clear_console.js';
+import { setInitScriptTool } from './tools/set_init_script.js';
+import { listIndexeddbTool } from './tools/list_indexeddb.js';
+import { setOuterHtmlTool } from './tools/set_outer_html.js';
+import { recordTimelineTool } from './tools/record_timeline.js';
+import { pauseDebuggerTool, resumeDebuggerTool, setBreakpointByUrlTool } from './tools/debugger.js';
+import { setPauseOnExceptionsTool, setEventBreakpointTool, setUrlBreakpointTool, setBlackboxUrlTool } from './tools/breakpoints.js';
+import { getEventListenersTool } from './tools/get_event_listeners.js';
+import { recordCpuProfileTool } from './tools/record_cpu_profile.js';
+import { highlightNodeTool, hideHighlightTool } from './tools/highlight_node.js';
+import { setResourceCachingDisabledTool, setRequestInterceptionTool } from './tools/network_runtime.js';
+import { getCapabilitySnapshotTool } from './tools/get_capability_snapshot.js';
+import { recordMemoryTrackingTool } from './tools/record_memory_tracking.js';
+import { listInterceptedRequestsTool, interceptContinueTool, interceptRespondTool } from './tools/intercept.js';
+import { analyzePerformanceTool } from './tools/analyze_performance.js';
+import { debugElementTool } from './tools/debug_element.js';
+import { summarizeConsoleErrorsTool } from './tools/summarize_console_errors.js';
+import { setUserAgentTool } from './tools/set_user_agent.js';
+const PKG = { name: 'ios-webkit-mcp', version: '0.18.3' };
+/**
+ * Parse `WDM_DISABLE_TOOLS` env var (comma-separated tool name list) — runtime
+ * kill switch for individual tools, per spec batch-13 DoD §"回滚开关".
+ *
+ *   WDM_DISABLE_TOOLS=set_init_script,record_timeline node …
+ *
+ * Exported for tests; underscore prefix signals "internal but reachable".
+ */
+export function _parseDisabledTools(value = process.env['WDM_DISABLE_TOOLS']) {
+    if (!value)
+        return new Set();
+    return new Set(value
+        .split(',')
+        .map(s => s.trim())
+        .filter(Boolean));
+}
+export function createServer() {
+    const server = new McpServer(PKG);
+    const disabled = _parseDisabledTools();
+    const ALL_TOOLS = [
+        listPagesTool,
+        evaluateScriptTool,
+        listConsoleMessagesTool,
+        listNetworkRequestsTool,
+        takeSnapshotTool,
+        navigatePageTool,
+        takeScreenshotTool,
+        takeMemorySnapshotTool,
+        clickTool,
+        waitForTool,
+        fillTool,
+        typeTextTool,
+        pressKeyTool,
+        hoverTool,
+        dragTool,
+        getConsoleMessageTool,
+        getNetworkRequestTool,
+        fillFormTool,
+        handleDialogTool,
+        selectPageTool,
+        wipSendTool,
+        reloadPageTool,
+        setExtraHttpHeadersTool,
+        queryDomNodeTool,
+        getResourceTreeTool,
+        getPerformanceMetricsTool,
+        takeNodeScreenshotTool,
+        getCookiesTool,
+        deleteCookieTool,
+        gcHeapTool,
+        clearConsoleTool,
+        setInitScriptTool,
+        listIndexeddbTool,
+        setOuterHtmlTool,
+        recordTimelineTool,
+        pauseDebuggerTool,
+        resumeDebuggerTool,
+        setBreakpointByUrlTool,
+        // batch-13 Must (cross-review v2.0.1):
+        setPauseOnExceptionsTool,
+        setEventBreakpointTool,
+        setUrlBreakpointTool,
+        getEventListenersTool,
+        recordCpuProfileTool,
+        // batch-13 Should (cross-review v2.0.1):
+        highlightNodeTool,
+        hideHighlightTool,
+        setResourceCachingDisabledTool,
+        setRequestInterceptionTool,
+        // batch-14 (cross-review v2.0.1, soft-promoted):
+        getCapabilitySnapshotTool,
+        recordMemoryTrackingTool,
+        setBlackboxUrlTool,
+        // batch-14 intercept full state machine:
+        listInterceptedRequestsTool,
+        interceptContinueTool,
+        interceptRespondTool,
+        // batch-14 composite (cross-review v2.0.1 演进锚点):
+        analyzePerformanceTool,
+        debugElementTool,
+        summarizeConsoleErrorsTool,
+        // batch-14 page emulation:
+        setUserAgentTool,
+    ];
+    for (const tool of ALL_TOOLS) {
+        if (disabled.has(tool.name)) {
+            process.stderr.write(`[wdm] tool '${tool.name}' disabled via WDM_DISABLE_TOOLS\n`);
+            continue;
+        }
+        server.tool(tool.name, tool.description, tool.inputSchema, tool.handler);
+    }
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/build/src/server.js.map

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

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

@@ -0,0 +1,40 @@
+/**
+ * `analyze_performance` (batch-14 composite tool, cross-review v2.0.1)
+ *
+ * Runs the "性能三件套" concurrently for a single duration window and emits
+ * a cross-correlated report:
+ *
+ *   - `record_timeline`        → wall-clock event types + hottest entries
+ *   - `record_cpu_profile`     → hot JS functions + heap delta
+ *   - `record_memory_tracking` → category memory deltas
+ *
+ * Apple WIP per-target message processing is serialized, but the three
+ * tracking domains operate independently — `Timeline.start` / `CPUProfiler.startTracking`
+ * / `Memory.startTracking` can coexist on one ws session and their event
+ * streams are tagged by domain so the buffers don't collide.
+ *
+ * The composite output is one markdown document with three sections + a
+ * cross-correlation hint footer.
+ */
+import { z } from 'zod';
+export declare const analyzePerformanceTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        durationMs: z.ZodOptional<z.ZodNumber>;
+        timelineTopN: z.ZodOptional<z.ZodNumber>;
+        cpuTopN: z.ZodOptional<z.ZodNumber>;
+        interactionHint: z.ZodOptional<z.ZodString>;
+    };
+    handler: ({ durationMs, timelineTopN, cpuTopN, interactionHint, }: {
+        durationMs?: number;
+        timelineTopN?: number;
+        cpuTopN?: number;
+        interactionHint?: string;
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};

package/build/src/tools/analyze_performance.js

@@ -0,0 +1,112 @@
+/**
+ * `analyze_performance` (batch-14 composite tool, cross-review v2.0.1)
+ *
+ * Runs the "性能三件套" concurrently for a single duration window and emits
+ * a cross-correlated report:
+ *
+ *   - `record_timeline`        → wall-clock event types + hottest entries
+ *   - `record_cpu_profile`     → hot JS functions + heap delta
+ *   - `record_memory_tracking` → category memory deltas
+ *
+ * Apple WIP per-target message processing is serialized, but the three
+ * tracking domains operate independently — `Timeline.start` / `CPUProfiler.startTracking`
+ * / `Memory.startTracking` can coexist on one ws session and their event
+ * streams are tagged by domain so the buffers don't collide.
+ *
+ * The composite output is one markdown document with three sections + a
+ * cross-correlation hint footer.
+ */
+import { z } from 'zod';
+import { recordTimelineTool } from './record_timeline.js';
+import { recordCpuProfileTool } from './record_cpu_profile.js';
+import { recordMemoryTrackingTool } from './record_memory_tracking.js';
+export const analyzePerformanceTool = {
+    name: 'analyze_performance',
+    description: [
+        'Run the performance 三件套 (Timeline + CPU profile + Memory tracking) concurrently for a single duration window and return a cross-correlated report.',
+        'Composes `record_timeline` + `record_cpu_profile` + `record_memory_tracking`. The 3 domains run independently on the same ws session — their event streams are tagged by domain so buffers do not collide.',
+        'Use when the AI needs a one-shot "what happened during this window" answer rather than 3 separate tool calls. For deeper one-axis dives, call the underlying tools directly.',
+    ].join(' '),
+    inputSchema: {
+        durationMs: z
+            .number()
+            .int()
+            .min(500)
+            .max(60_000)
+            .optional()
+            .describe('Recording window across all three sub-tools (default 3000).'),
+        timelineTopN: z.number().int().min(1).max(100).optional().describe('Top-N timeline events (default 10).'),
+        cpuTopN: z.number().int().min(1).max(100).optional().describe('Top-N CPU frames (default 10).'),
+        interactionHint: z
+            .string()
+            .optional()
+            .describe('Free-text hint shown in the report header — useful for AI memory ("during this window the user scrolled feed for 3s").'),
+    },
+    handler: async ({ durationMs = 3_000, timelineTopN = 10, cpuTopN = 10, interactionHint, }) => {
+        const t0 = Date.now();
+        const [tl, cpu, mem] = await Promise.all([
+            recordTimelineTool.handler({ durationMs, topN: timelineTopN }),
+            recordCpuProfileTool.handler({ durationMs, topN: cpuTopN }),
+            recordMemoryTrackingTool.handler({ durationMs }),
+        ]);
+        const elapsed = Date.now() - t0;
+        const tlText = tl.content[0]?.text ?? '(no timeline output)';
+        const cpuText = cpu.content[0]?.text ?? '(no cpu output)';
+        const memText = mem.content[0]?.text ?? '(no memory output)';
+        const lines = [
+            `# analyze_performance ✓ ${durationMs}ms (wall ${elapsed}ms)`,
+            '',
+        ];
+        if (interactionHint)
+            lines.push(`User interaction during window: ${interactionHint}`, '');
+        lines.push('## Timeline');
+        lines.push(stripTitle(tlText));
+        lines.push('');
+        lines.push('## CPU Profile');
+        lines.push(stripTitle(cpuText));
+        lines.push('');
+        lines.push('## Memory Tracking');
+        lines.push(stripTitle(memText));
+        lines.push('');
+        lines.push('---');
+        lines.push('## Cross-correlation hints');
+        lines.push(crossCorrelate(tl, cpu, mem));
+        return { content: [{ type: 'text', text: lines.join('\n') }] };
+    },
+};
+function stripTitle(text) {
+    // Remove the leading `# tool_name ✓ ...` line so the composite has only one H1.
+    return text.replace(/^# [^\n]*\n+/, '');
+}
+function crossCorrelate(tl, cpu, mem) {
+    const hints = [];
+    // Try to extract a few signals.
+    const tlMatch = tl.content[0]?.text.match(/Total events: (\d+)/);
+    const cpuMatch = cpu.content[0]?.text.match(/Samples captured: (\d+)/);
+    const memMatch = mem.content[0]?.text.match(/Samples: (\d+)/);
+    const heapDelta = cpu.content[0]?.text.match(/JS heap delta: (-?[\d.]+) MB/);
+    const memJs = mem.content[0]?.text.match(/^\| javascript \| ([\d.]+) \| ([\d.]+) \| (-?[\d.]+) \| ([-\d.]+%) \|/m);
+    if (tlMatch)
+        hints.push(`- ${tlMatch[1]} timeline events captured`);
+    if (cpuMatch)
+        hints.push(`- ${cpuMatch[1]} CPU samples captured`);
+    if (memMatch)
+        hints.push(`- ${memMatch[1]} memory samples captured`);
+    if (heapDelta)
+        hints.push(`- JS heap delta (Runtime.evaluate snapshot): ${heapDelta[1]} MB`);
+    if (memJs)
+        hints.push(`- Memory.javascript bucket: ${memJs[1]} MB → ${memJs[2]} MB (Δ ${memJs[3]} MB / ${memJs[4]})`);
+    if (heapDelta && memJs) {
+        const a = Number(heapDelta[1]);
+        const b = Number(memJs[3]);
+        if (Number.isFinite(a) && Number.isFinite(b)) {
+            const skew = Math.abs(a - b);
+            hints.push(`- CPU profile heap delta vs Memory.javascript bucket: |Δ| = ${skew.toFixed(2)} MB${skew > 5 ? ' (notable divergence — investigate timing)' : ' (consistent)'}`);
+        }
+    }
+    if (hints.length === 0) {
+        hints.push('No quantitative signals captured — the page may have been idle. Re-run while interacting.');
+    }
+    return hints.join('\n');
+}
+//# sourceMappingURL=analyze_performance.js.map

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

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

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

@@ -0,0 +1,80 @@
+/**
+ * Advanced breakpoint controls for batch-13 (cross-review v2.0.1 Must).
+ *
+ *   - `set_pause_on_exceptions` — `Debugger.setPauseOnExceptions`
+ *   - `set_event_breakpoint`     — `DOMDebugger.setEventBreakpoint`
+ *   - `set_url_breakpoint`       — `DOMDebugger.setURLBreakpoint`
+ *
+ * `Debugger.setBreakpointByUrl` (JS source-URL breakpoint, ≠ network URL
+ * breakpoint here) lives in `debugger.ts` since batch-12.
+ *
+ * Capability matrix v2 (2026-05-17 fresh-ws probe) confirmed all three ✅
+ * on iOS 26.5.0 WKWebView. Receipts: docs/spec.md §"WIP capability matrix v2".
+ */
+import { z } from 'zod';
+export declare const setPauseOnExceptionsTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        state: z.ZodEnum<["none", "uncaught", "all"]>;
+    };
+    handler: ({ state }: {
+        state: "none" | "uncaught" | "all";
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};
+export declare const setEventBreakpointTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        eventName: z.ZodString;
+        breakpointType: z.ZodOptional<z.ZodEnum<["listener", "timer", "animation-frame", "interval"]>>;
+    };
+    handler: ({ eventName, breakpointType }: {
+        eventName: string;
+        breakpointType?: "listener" | "timer" | "animation-frame" | "interval";
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};
+export declare const setUrlBreakpointTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        url: z.ZodString;
+        isRegex: z.ZodOptional<z.ZodBoolean>;
+    };
+    handler: ({ url, isRegex }: {
+        url: string;
+        isRegex?: boolean;
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};
+export declare const setBlackboxUrlTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        url: z.ZodString;
+        shouldBlackbox: z.ZodOptional<z.ZodBoolean>;
+    };
+    handler: ({ url, shouldBlackbox }: {
+        url: string;
+        shouldBlackbox?: boolean;
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};

package/build/src/tools/breakpoints.js

@@ -0,0 +1,167 @@
+/**
+ * Advanced breakpoint controls for batch-13 (cross-review v2.0.1 Must).
+ *
+ *   - `set_pause_on_exceptions` — `Debugger.setPauseOnExceptions`
+ *   - `set_event_breakpoint`     — `DOMDebugger.setEventBreakpoint`
+ *   - `set_url_breakpoint`       — `DOMDebugger.setURLBreakpoint`
+ *
+ * `Debugger.setBreakpointByUrl` (JS source-URL breakpoint, ≠ network URL
+ * breakpoint here) lives in `debugger.ts` since batch-12.
+ *
+ * Capability matrix v2 (2026-05-17 fresh-ws probe) confirmed all three ✅
+ * on iOS 26.5.0 WKWebView. Receipts: docs/spec.md §"WIP capability matrix v2".
+ */
+import { z } from 'zod';
+import { PageSession } from '../page-session.js';
+const ensureDebuggerEnabled = async (ps) => {
+    try {
+        await ps.session.send('Debugger.enable', undefined, 5_000);
+    }
+    catch { /* idempotent */ }
+};
+export const setPauseOnExceptionsTool = {
+    name: 'set_pause_on_exceptions',
+    description: [
+        'Set pause-on-exceptions mode via WIP `Debugger.setPauseOnExceptions` (✅ probe 2026-05-17).',
+        'Equivalent to Safari Web Inspector "Pause on Exceptions" toggle. Persists across resume_debugger calls until cleared.',
+        'States: `none` (default; never pause), `uncaught` (pause only on uncaught), `all` (pause on every throw — noisy but useful for tracing).',
+    ].join(' '),
+    inputSchema: {
+        state: z
+            .enum(['none', 'uncaught', 'all'])
+            .describe('`none` clears the pause-on-exceptions mode; `uncaught` pauses only on uncaught throws; `all` pauses on every throw.'),
+    },
+    handler: async ({ state }) => {
+        let ps;
+        try {
+            ps = await PageSession.get();
+        }
+        catch (e) {
+            return errorResult(`Unable to attach: ${describe(e)}`);
+        }
+        await ensureDebuggerEnabled(ps);
+        try {
+            await ps.session.send('Debugger.setPauseOnExceptions', { state }, 5_000);
+        }
+        catch (e) {
+            return errorResult(`Debugger.setPauseOnExceptions failed: ${describe(e)}`);
+        }
+        return textResult(`# set_pause_on_exceptions ✓ \`${state}\`\n\n${describeMode(state)}`);
+    },
+};
+function describeMode(state) {
+    if (state === 'none')
+        return 'Cleared. Page no longer auto-pauses on exceptions.';
+    if (state === 'uncaught')
+        return 'Page will pause when an uncaught exception is thrown. Use `resume_debugger` to continue.';
+    return 'Page will pause on EVERY thrown exception (caught or not). Noisy but powerful for tracing throw sites. Use `resume_debugger` to continue.';
+}
+export const setEventBreakpointTool = {
+    name: 'set_event_breakpoint',
+    description: [
+        'Break when a specified DOM/JS event fires, via WIP `DOMDebugger.setEventBreakpoint` (✅ probe 2026-05-17).',
+        'breakpointType=`listener` covers DOM events (click, scroll, keydown…). breakpointType=`timer` covers setTimeout/setInterval/requestAnimationFrame. breakpointType=`animation-frame` for rAF specifically. breakpointType=`interval` for setInterval.',
+        'Use this to catch the moment an event fires without knowing the handler\'s file:line. Pair with `pause_debugger` mental model: when the event triggers, the page stops at the listener entry.',
+    ].join(' '),
+    inputSchema: {
+        eventName: z.string().min(1).describe('Event name without prefix, e.g. `click`, `keydown`, `setTimeout`, `requestAnimationFrame`.'),
+        breakpointType: z
+            .enum(['listener', 'timer', 'animation-frame', 'interval'])
+            .optional()
+            .describe('Breakpoint category. Default `listener` (DOM events). Use `timer` for setTimeout, `animation-frame` for rAF, `interval` for setInterval.'),
+    },
+    handler: async ({ eventName, breakpointType = 'listener' }) => {
+        let ps;
+        try {
+            ps = await PageSession.get();
+        }
+        catch (e) {
+            return errorResult(`Unable to attach: ${describe(e)}`);
+        }
+        await ensureDebuggerEnabled(ps);
+        try {
+            await ps.session.send('DOMDebugger.setEventBreakpoint', { breakpointType, eventName }, 5_000);
+        }
+        catch (e) {
+            return errorResult(`DOMDebugger.setEventBreakpoint failed: ${describe(e)}`);
+        }
+        return textResult(`# set_event_breakpoint ✓\n\n` +
+            `Event: \`${eventName}\` (type=${breakpointType})\n\n` +
+            `Page will pause when this event fires. Trigger the action manually (or via \`click\` / \`type_text\` etc.) — execution will halt at the listener entry. Call \`resume_debugger\` to continue.\n\n` +
+            `⚠ Removal not yet exposed (batch-14). Set the same event again to re-enable; restart MCP server to clear all event breakpoints.`);
+    },
+};
+export const setUrlBreakpointTool = {
+    name: 'set_url_breakpoint',
+    description: [
+        'Break when a network request URL matches a substring or regex, via WIP `DOMDebugger.setURLBreakpoint` (✅ probe 2026-05-17).',
+        'Distinct from `set_breakpoint_by_url` (which is `Debugger.setBreakpointByUrl` — JS source-URL line breakpoint). This one fires when XHR / fetch / script-src etc. requests match.',
+        'Use for "where in the code does this fetch get triggered" investigations.',
+    ].join(' '),
+    inputSchema: {
+        url: z.string().min(1).describe('URL substring (when isRegex=false) or regex pattern (when isRegex=true). Empty matches all requests.'),
+        isRegex: z
+            .boolean()
+            .optional()
+            .describe('Treat `url` as JS regex (default false → substring match).'),
+    },
+    handler: async ({ url, isRegex = false }) => {
+        let ps;
+        try {
+            ps = await PageSession.get();
+        }
+        catch (e) {
+            return errorResult(`Unable to attach: ${describe(e)}`);
+        }
+        await ensureDebuggerEnabled(ps);
+        try {
+            await ps.session.send('DOMDebugger.setURLBreakpoint', { url, isRegex }, 5_000);
+        }
+        catch (e) {
+            return errorResult(`DOMDebugger.setURLBreakpoint failed: ${describe(e)}`);
+        }
+        return textResult(`# set_url_breakpoint ✓\n\n` +
+            `URL: \`${url}\`${isRegex ? ' (regex)' : ' (substring)'}\n\n` +
+            `Page will pause when a request URL matches. Trigger network activity (navigation / XHR / fetch) — execution halts at the call site. Call \`resume_debugger\` to continue.\n\n` +
+            `⚠ Removal not yet exposed (batch-14). Restart MCP server to clear all URL breakpoints.`);
+    },
+};
+export const setBlackboxUrlTool = {
+    name: 'set_blackbox_url',
+    description: [
+        'Mark a script URL as blackboxed (or un-blackbox it) via WIP `Debugger.setShouldBlackboxURL` (✅ probe 2026-05-17).',
+        'Apple WIP uses per-URL booleans (NOT CDP-style `setBlackboxPatterns` — that one ❌ NOT_FOUND on iOS).',
+        'When blackboxed, the debugger steps OVER all frames in matching URLs instead of stepping in. Use to skip framework / library code (jquery, react-dom, polyfills etc.) when stepping through your own code.',
+    ].join(' '),
+    inputSchema: {
+        url: z.string().min(1).describe('Script URL pattern (Apple WIP treats this as a substring/glob — exact semantics build-specific).'),
+        shouldBlackbox: z
+            .boolean()
+            .optional()
+            .describe('`true` (default) blackboxes; `false` removes blackbox.'),
+    },
+    handler: async ({ url, shouldBlackbox = true }) => {
+        let ps;
+        try {
+            ps = await PageSession.get();
+        }
+        catch (e) {
+            return errorResult(`Unable to attach: ${describe(e)}`);
+        }
+        await ensureDebuggerEnabled(ps);
+        try {
+            await ps.session.send('Debugger.setShouldBlackboxURL', { url, shouldBlackbox }, 5_000);
+        }
+        catch (e) {
+            return errorResult(`Debugger.setShouldBlackboxURL failed: ${describe(e)}`);
+        }
+        return textResult(`# set_blackbox_url ✓ \`${url}\` → ${shouldBlackbox ? 'blackboxed' : 'cleared'}\n\n` +
+            (shouldBlackbox
+                ? `Debugger will step OVER frames whose script URL matches \`${url}\`. Useful for hiding framework/library noise.`
+                : `Blackbox cleared for \`${url}\`. Debugger will once again step into matching scripts.`));
+    },
+};
+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=breakpoints.js.map

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

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

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

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

package/build/src/tools/clear_console.js

@@ -0,0 +1,32 @@
+import { PageSession } from '../page-session.js';
+export const clearConsoleTool = {
+    name: 'clear_console',
+    description: [
+        'Clear the page console + the local PageSession buffer via WIP `Console.clearMessages` (probe-confirmed 2026-05-16).',
+        'Both sides are reset: the WebKit-side console (so re-attaching wouldn\'t replay these) AND the in-process rolling buffer fed by `Console.messageAdded`.',
+        'Useful before an interaction probe so subsequent `list_console_messages` only returns new entries.',
+    ].join(' '),
+    inputSchema: {},
+    handler: async () => {
+        let ps;
+        try {
+            ps = await PageSession.get();
+        }
+        catch (e) {
+            return errorResult(`Unable to attach: ${describe(e)}`);
+        }
+        const before = ps.consoleBuffer.length;
+        try {
+            await ps.session.send('Console.clearMessages', undefined, 5_000);
+        }
+        catch (e) {
+            return errorResult(`Console.clearMessages failed: ${describe(e)}`);
+        }
+        ps.consoleBuffer.length = 0;
+        return textResult(`# clear_console ✓\n\nCleared WebKit console + local buffer (was ${before} entries, now 0).`);
+    },
+};
+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=clear_console.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"clear_console.js","sourceRoot":"","sources":["../../../src/tools/clear_console.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE;QACX,qHAAqH;QACrH,yJAAyJ;QACzJ,oGAAoG;KACrG,CAAC,IAAI,CAAC,GAAG,CAAC;IAEX,WAAW,EAAE,EAAE;IAEf,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,MAAM,GAAG,EAAE,CAAC,aAAa,CAAC,MAAM,CAAC;QACvC,IAAI,CAAC;YAAC,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,uBAAuB,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;QAAC,CAAC;QACzE,OAAO,CAAC,EAAE,CAAC;YAAC,OAAO,WAAW,CAAC,iCAAiC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAAC,CAAC;QACjF,EAAE,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC;QAC5B,OAAO,UAAU,CAAC,mEAAmE,MAAM,mBAAmB,CAAC,CAAC;IAClH,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/click.d.ts

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+export declare const clickTool: {
+    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;
+        }[];
+    }>;
+};