ios-webkit-mcp 0.18.3

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

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

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

@@ -0,0 +1,38 @@
+/**
+ * `record_cpu_profile` (batch-13 Must) — record an Apple WIP CPU profile.
+ *
+ * Composes WIP `CPUProfiler.startTracking` + `CPUProfiler.stopTracking` +
+ * `ScriptProfiler.startTracking(includeSamples=true)` + `ScriptProfiler.stopTracking`
+ * for `durationMs`, plus the lightweight `Runtime.evaluate` `performance.memory`
+ * delta as a coarse memory hint. Apple WIP does not return a single normalized
+ * profile blob — it streams `*.trackingUpdate` events ending with a `*.trackingComplete`
+ * payload that carries the actual samples.
+ *
+ * Probe-confirmed (capability matrix v2, 2026-05-17):
+ *   - CPUProfiler.startTracking / stopTracking ✅
+ *   - ScriptProfiler.startTracking({includeSamples:true}) / stopTracking ✅
+ *
+ * The output summarizes hottest call sites by sample count + samples/total
+ * ratio. We don't ship a full v8-style flamegraph yet (Apple's sample format
+ * is union-typed); batch-14 will compose with `analyze_performance`.
+ */
+import { z } from 'zod';
+export declare const recordCpuProfileTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        durationMs: z.ZodOptional<z.ZodNumber>;
+        topN: z.ZodOptional<z.ZodNumber>;
+        includeAnonymous: z.ZodOptional<z.ZodBoolean>;
+    };
+    handler: ({ durationMs, topN, includeAnonymous, }: {
+        durationMs?: number;
+        topN?: number;
+        includeAnonymous?: boolean;
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};

package/build/src/tools/record_cpu_profile.js

@@ -0,0 +1,174 @@
+/**
+ * `record_cpu_profile` (batch-13 Must) — record an Apple WIP CPU profile.
+ *
+ * Composes WIP `CPUProfiler.startTracking` + `CPUProfiler.stopTracking` +
+ * `ScriptProfiler.startTracking(includeSamples=true)` + `ScriptProfiler.stopTracking`
+ * for `durationMs`, plus the lightweight `Runtime.evaluate` `performance.memory`
+ * delta as a coarse memory hint. Apple WIP does not return a single normalized
+ * profile blob — it streams `*.trackingUpdate` events ending with a `*.trackingComplete`
+ * payload that carries the actual samples.
+ *
+ * Probe-confirmed (capability matrix v2, 2026-05-17):
+ *   - CPUProfiler.startTracking / stopTracking ✅
+ *   - ScriptProfiler.startTracking({includeSamples:true}) / stopTracking ✅
+ *
+ * The output summarizes hottest call sites by sample count + samples/total
+ * ratio. We don't ship a full v8-style flamegraph yet (Apple's sample format
+ * is union-typed); batch-14 will compose with `analyze_performance`.
+ */
+import { z } from 'zod';
+import { PageSession } from '../page-session.js';
+export const recordCpuProfileTool = {
+    name: 'record_cpu_profile',
+    description: [
+        'Record a CPU profile for a fixed duration on the inspected iOS WebView page using Apple WIP `CPUProfiler.startTracking` + `ScriptProfiler.startTracking({includeSamples:true})` (✅ probe 2026-05-17).',
+        'WIP does NOT expose CDP `Profiler.takePreciseCoverage` — instead samples stream as `ScriptProfiler.trackingUpdate` events. The tool subscribes, runs for `durationMs`, then aggregates samples into hottest call-frame summary.',
+        'Pair with `record_timeline` for cross-axis timing breakdown (timeline = wall-clock events; cpu profile = stack-sampled hot paths).',
+    ].join(' '),
+    inputSchema: {
+        durationMs: z
+            .number()
+            .int()
+            .min(200)
+            .max(60_000)
+            .optional()
+            .describe('How long to record (default 3000).'),
+        topN: z
+            .number()
+            .int()
+            .min(1)
+            .max(200)
+            .optional()
+            .describe('Top-N hottest call frames returned (default 20).'),
+        includeAnonymous: z
+            .boolean()
+            .optional()
+            .describe('Include frames with empty functionName (anonymous closures). Default true.'),
+    },
+    handler: async ({ durationMs = 3_000, topN = 20, includeAnonymous = true, }) => {
+        let ps;
+        try {
+            ps = await PageSession.get();
+        }
+        catch (e) {
+            return errorResult(`Unable to attach: ${describe(e)}`);
+        }
+        const samples = [];
+        const unsubscribers = [];
+        unsubscribers.push(ps.session.on('ScriptProfiler.trackingUpdate', (p) => {
+            const params = p;
+            const stacks = params?.event?.samples?.stackTraces ?? params?.samples;
+            if (Array.isArray(stacks))
+                for (const s of stacks)
+                    samples.push(s);
+        }));
+        unsubscribers.push(ps.session.on('ScriptProfiler.trackingComplete', (p) => {
+            const params = p;
+            const stacks = params?.samples ?? params?.event?.samples?.stackTraces;
+            if (Array.isArray(stacks))
+                for (const s of stacks)
+                    samples.push(s);
+        }));
+        let memBefore;
+        try {
+            const r = await ps.session.send('Runtime.evaluate', { expression: '({jsHeapSizeUsed: performance.memory?.usedJSHeapSize, jsHeapSizeLimit: performance.memory?.jsHeapSizeLimit})', returnByValue: true }, 5_000);
+            memBefore = r.result?.value;
+        }
+        catch { /* not all WebKits expose performance.memory */ }
+        try {
+            await ps.session.send('CPUProfiler.startTracking', undefined, 5_000);
+        }
+        catch (e) {
+            unsubscribers.forEach(u => u());
+            return errorResult(`CPUProfiler.startTracking failed: ${describe(e)}`);
+        }
+        try {
+            await ps.session.send('ScriptProfiler.startTracking', { includeSamples: true }, 5_000);
+        }
+        catch (e) {
+            try {
+                await ps.session.send('CPUProfiler.stopTracking', undefined, 5_000);
+            }
+            catch { /* best-effort */ }
+            unsubscribers.forEach(u => u());
+            return errorResult(`ScriptProfiler.startTracking failed: ${describe(e)}`);
+        }
+        await new Promise(r => setTimeout(r, durationMs));
+        try {
+            await ps.session.send('ScriptProfiler.stopTracking', undefined, 10_000);
+        }
+        catch (e) {
+            unsubscribers.forEach(u => u());
+            return errorResult(`ScriptProfiler.stopTracking failed: ${describe(e)}`);
+        }
+        try {
+            await ps.session.send('CPUProfiler.stopTracking', undefined, 10_000);
+        }
+        catch { /* best-effort tail */ }
+        // Allow tail trackingComplete events to drain.
+        await new Promise(r => setTimeout(r, 200));
+        unsubscribers.forEach(u => u());
+        let memAfter;
+        try {
+            const r = await ps.session.send('Runtime.evaluate', { expression: '({jsHeapSizeUsed: performance.memory?.usedJSHeapSize, jsHeapSizeLimit: performance.memory?.jsHeapSizeLimit})', returnByValue: true }, 5_000);
+            memAfter = r.result?.value;
+        }
+        catch { /* skip */ }
+        // Aggregate frames.
+        const frameCount = new Map();
+        for (const sample of samples) {
+            const top = sample.stackTrace?.callFrames?.[0];
+            if (!top)
+                continue;
+            const key = `${top.functionName ?? '<anon>'} ${top.url ?? ''}:${top.lineNumber ?? '?'}`;
+            if (!includeAnonymous && (!top.functionName || top.functionName === ''))
+                continue;
+            const cur = frameCount.get(key) ?? { count: 0, topSample: top };
+            cur.count += 1;
+            frameCount.set(key, cur);
+        }
+        const totalSamples = samples.length;
+        const top = [...frameCount.entries()]
+            .sort((a, b) => b[1].count - a[1].count)
+            .slice(0, topN);
+        const lines = [
+            `# record_cpu_profile ✓ ${durationMs}ms`,
+            '',
+            `Samples captured: ${totalSamples}`,
+            `Unique top-of-stack frames: ${frameCount.size}`,
+        ];
+        if (memBefore && memAfter && typeof memBefore.jsHeapSizeUsed === 'number' && typeof memAfter.jsHeapSizeUsed === 'number') {
+            const delta = memAfter.jsHeapSizeUsed - memBefore.jsHeapSizeUsed;
+            lines.push(`JS heap delta: ${(delta / 1024 / 1024).toFixed(2)} MB (${memBefore.jsHeapSizeUsed} → ${memAfter.jsHeapSizeUsed} bytes)`);
+        }
+        if (totalSamples === 0) {
+            lines.push('');
+            lines.push('⚠ No samples captured. Possible causes:');
+            lines.push('- Page idle during recording — interact with it (scroll / tap) and re-record.');
+            lines.push('- ScriptProfiler.trackingUpdate event schema differs on this iOS build — file a probe issue.');
+            lines.push('- includeSamples=true unsupported (rare, capability matrix says ✅).');
+        }
+        else if (top.length > 0) {
+            lines.push('');
+            lines.push(`## Top ${top.length} hottest frames`);
+            lines.push('| samples | % | function | source |');
+            lines.push('|---|---|---|---|');
+            for (const [key, { count, topSample }] of top) {
+                const pct = ((count / totalSamples) * 100).toFixed(1);
+                const fn = topSample?.functionName || '<anonymous>';
+                const src = topSample?.url
+                    ? `${topSample.url}:${topSample.lineNumber ?? '?'}:${topSample.columnNumber ?? '?'}`
+                    : '(no source)';
+                lines.push(`| ${count} | ${pct}% | \`${fn}\` | ${src.replace(/\|/g, '\\|')} |`);
+                void key;
+            }
+        }
+        lines.push('');
+        lines.push('⚠ Apple WIP CPU sample format is union-typed across iOS builds. If samples look empty or mis-attributed, set `WDM_WS_DEBUG=1` to dump raw `ScriptProfiler.trackingUpdate` payloads to stderr for schema inspection.');
+        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=record_cpu_profile.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"record_cpu_profile.js","sourceRoot":"","sources":["../../../src/tools/record_cpu_profile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAqBjD,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EAAE;QACX,uMAAuM;QACvM,iOAAiO;QACjO,oIAAoI;KACrI,CAAC,IAAI,CAAC,GAAG,CAAC;IAEX,WAAW,EAAE;QACX,UAAU,EAAE,CAAC;aACV,MAAM,EAAE;aACR,GAAG,EAAE;aACL,GAAG,CAAC,GAAG,CAAC;aACR,GAAG,CAAC,MAAM,CAAC;aACX,QAAQ,EAAE;aACV,QAAQ,CAAC,oCAAoC,CAAC;QACjD,IAAI,EAAE,CAAC;aACJ,MAAM,EAAE;aACR,GAAG,EAAE;aACL,GAAG,CAAC,CAAC,CAAC;aACN,GAAG,CAAC,GAAG,CAAC;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,kDAAkD,CAAC;QAC/D,gBAAgB,EAAE,CAAC;aAChB,OAAO,EAAE;aACT,QAAQ,EAAE;aACV,QAAQ,CAAC,4EAA4E,CAAC;KAC1F;IAED,OAAO,EAAE,KAAK,EAAE,EACd,UAAU,GAAG,KAAK,EAClB,IAAI,GAAG,EAAE,EACT,gBAAgB,GAAG,IAAI,GAC4C,EAAE,EAAE;QACvE,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;QAE3G,MAAM,OAAO,GAAmB,EAAE,CAAC;QACnC,MAAM,aAAa,GAAsB,EAAE,CAAC;QAE5C,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,+BAA+B,EAAE,CAAC,CAAU,EAAE,EAAE;YAC/E,MAAM,MAAM,GAAG,CAAyB,CAAC;YACzC,MAAM,MAAM,GAAG,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,IAAI,MAAM,EAAE,OAAO,CAAC;YACtE,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;gBAAE,KAAK,MAAM,CAAC,IAAI,MAAM;oBAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACrE,CAAC,CAAC,CAAC,CAAC;QACJ,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,iCAAiC,EAAE,CAAC,CAAU,EAAE,EAAE;YACjF,MAAM,MAAM,GAAG,CAAyB,CAAC;YACzC,MAAM,MAAM,GAAG,MAAM,EAAE,OAAO,IAAI,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,CAAC;YACtE,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;gBAAE,KAAK,MAAM,CAAC,IAAI,MAAM;oBAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACrE,CAAC,CAAC,CAAC,CAAC;QAEJ,IAAI,SAAoC,CAAC;QACzC,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAC7B,kBAAkB,EAClB,EAAE,UAAU,EAAE,8GAA8G,EAAE,aAAa,EAAE,IAAI,EAAE,EACnJ,KAAK,CACN,CAAC;YACF,SAAS,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC;QAC9B,CAAC;QAAC,MAAM,CAAC,CAAC,+CAA+C,CAAC,CAAC;QAE3D,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,2BAA2B,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;QACvE,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;YAChC,OAAO,WAAW,CAAC,qCAAqC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACzE,CAAC;QACD,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,8BAA8B,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC;QACzF,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC;gBAAC,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,0BAA0B,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,iBAAiB,CAAC,CAAC;YACxG,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;YAChC,OAAO,WAAW,CAAC,wCAAwC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC5E,CAAC;QAED,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC;QAElD,IAAI,CAAC;YAAC,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,6BAA6B,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;QAAC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YAC1F,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;YAChC,OAAO,WAAW,CAAC,uCAAuC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC3E,CAAC;QACD,IAAI,CAAC;YAAC,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,0BAA0B,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,sBAAsB,CAAC,CAAC;QAE9G,+CAA+C;QAC/C,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;QAC3C,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QAEhC,IAAI,QAAmC,CAAC;QACxC,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAC7B,kBAAkB,EAClB,EAAE,UAAU,EAAE,8GAA8G,EAAE,aAAa,EAAE,IAAI,EAAE,EACnJ,KAAK,CACN,CAAC;YACF,QAAQ,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC;QAC7B,CAAC;QAAC,MAAM,CAAC,CAAC,UAAU,CAAC,CAAC;QAEtB,oBAAoB;QACpB,MAAM,UAAU,GAAG,IAAI,GAAG,EAAoD,CAAC;QAC/E,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC;YAC/C,IAAI,CAAC,GAAG;gBAAE,SAAS;YACnB,MAAM,GAAG,GAAG,GAAG,GAAG,CAAC,YAAY,IAAI,QAAQ,IAAI,GAAG,CAAC,GAAG,IAAI,EAAE,IAAI,GAAG,CAAC,UAAU,IAAI,GAAG,EAAE,CAAC;YACxF,IAAI,CAAC,gBAAgB,IAAI,CAAC,CAAC,GAAG,CAAC,YAAY,IAAI,GAAG,CAAC,YAAY,KAAK,EAAE,CAAC;gBAAE,SAAS;YAClF,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC;YAChE,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC;YACf,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAC3B,CAAC;QACD,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;QACpC,MAAM,GAAG,GAAG,CAAC,GAAG,UAAU,CAAC,OAAO,EAAE,CAAC;aAClC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;aACvC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QAElB,MAAM,KAAK,GAAa;YACtB,0BAA0B,UAAU,IAAI;YACxC,EAAE;YACF,qBAAqB,YAAY,EAAE;YACnC,+BAA+B,UAAU,CAAC,IAAI,EAAE;SACjD,CAAC;QACF,IAAI,SAAS,IAAI,QAAQ,IAAI,OAAO,SAAS,CAAC,cAAc,KAAK,QAAQ,IAAI,OAAO,QAAQ,CAAC,cAAc,KAAK,QAAQ,EAAE,CAAC;YACzH,MAAM,KAAK,GAAG,QAAQ,CAAC,cAAc,GAAG,SAAS,CAAC,cAAc,CAAC;YACjE,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,KAAK,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,SAAS,CAAC,cAAc,MAAM,QAAQ,CAAC,cAAc,SAAS,CAAC,CAAC;QACvI,CAAC;QAED,IAAI,YAAY,KAAK,CAAC,EAAE,CAAC;YACvB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;YACtD,KAAK,CAAC,IAAI,CAAC,+EAA+E,CAAC,CAAC;YAC5F,KAAK,CAAC,IAAI,CAAC,8FAA8F,CAAC,CAAC;YAC3G,KAAK,CAAC,IAAI,CAAC,qEAAqE,CAAC,CAAC;QACpF,CAAC;aAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,UAAU,GAAG,CAAC,MAAM,iBAAiB,CAAC,CAAC;YAClD,KAAK,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;YAClD,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;YAChC,KAAK,MAAM,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC;gBAC9C,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,GAAG,YAAY,CAAC,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;gBACtD,MAAM,EAAE,GAAG,SAAS,EAAE,YAAY,IAAI,aAAa,CAAC;gBACpD,MAAM,GAAG,GAAG,SAAS,EAAE,GAAG;oBACxB,CAAC,CAAC,GAAG,SAAS,CAAC,GAAG,IAAI,SAAS,CAAC,UAAU,IAAI,GAAG,IAAI,SAAS,CAAC,YAAY,IAAI,GAAG,EAAE;oBACpF,CAAC,CAAC,aAAa,CAAC;gBAClB,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,MAAM,GAAG,SAAS,EAAE,QAAQ,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;gBAChF,KAAK,GAAG,CAAC;YACX,CAAC;QACH,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,qNAAqN,CAAC,CAAC;QAClO,OAAO,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACtC,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/record_memory_tracking.d.ts

@@ -0,0 +1,32 @@
+/**
+ * `record_memory_tracking` (batch-14, soft-promoted from "推到 batch-14 nice")
+ *
+ * Pairs with `record_cpu_profile` to form the "性能三件套路线图" foundation
+ * (cross-review v2.0.1 codex). Different signal:
+ *   - `record_cpu_profile` → who (which JS function) is hot
+ *   - `record_memory_tracking` → what (jsHeap / images / layers) is using memory
+ *   - `record_timeline` → when (frame events) on the wall clock
+ *
+ * WIP: `Memory.startTracking` + `Memory.stopTracking` + `Memory.trackingUpdate`
+ * events (probe-confirmed 2026-05-17).
+ *
+ * Apple's `Memory.trackingUpdate` payload contains a `categories` array
+ * carrying per-bucket sizes (JavaScript / Images / Layers / Page / Other).
+ * We sample the latest per category, then return delta vs initial sample.
+ */
+import { z } from 'zod';
+export declare const recordMemoryTrackingTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        durationMs: z.ZodOptional<z.ZodNumber>;
+    };
+    handler: ({ durationMs }: {
+        durationMs?: number;
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};

package/build/src/tools/record_memory_tracking.js

@@ -0,0 +1,103 @@
+/**
+ * `record_memory_tracking` (batch-14, soft-promoted from "推到 batch-14 nice")
+ *
+ * Pairs with `record_cpu_profile` to form the "性能三件套路线图" foundation
+ * (cross-review v2.0.1 codex). Different signal:
+ *   - `record_cpu_profile` → who (which JS function) is hot
+ *   - `record_memory_tracking` → what (jsHeap / images / layers) is using memory
+ *   - `record_timeline` → when (frame events) on the wall clock
+ *
+ * WIP: `Memory.startTracking` + `Memory.stopTracking` + `Memory.trackingUpdate`
+ * events (probe-confirmed 2026-05-17).
+ *
+ * Apple's `Memory.trackingUpdate` payload contains a `categories` array
+ * carrying per-bucket sizes (JavaScript / Images / Layers / Page / Other).
+ * We sample the latest per category, then return delta vs initial sample.
+ */
+import { z } from 'zod';
+import { PageSession } from '../page-session.js';
+export const recordMemoryTrackingTool = {
+    name: 'record_memory_tracking',
+    description: [
+        'Record an Apple WIP Memory tracking sample for a fixed duration on the inspected iOS WebView page.',
+        'Subscribes to `Memory.trackingUpdate` events between `Memory.startTracking` and `Memory.stopTracking` (probe-confirmed 2026-05-17).',
+        'Returns per-category memory size delta (JavaScript / Images / Layers / Page / Other) so the AI can answer "which bucket grew during this interaction?".',
+        'Pair with `record_cpu_profile` (hot functions) and `record_timeline` (frame events) for the performance三件套.',
+    ].join(' '),
+    inputSchema: {
+        durationMs: z
+            .number()
+            .int()
+            .min(200)
+            .max(60_000)
+            .optional()
+            .describe('How long to track (default 3000).'),
+    },
+    handler: async ({ durationMs = 3_000 }) => {
+        let ps;
+        try {
+            ps = await PageSession.get();
+        }
+        catch (e) {
+            return errorResult(`Unable to attach: ${describe(e)}`);
+        }
+        const samples = [];
+        const unsubscribers = [];
+        unsubscribers.push(ps.session.on('Memory.trackingUpdate', (p) => {
+            const params = p;
+            const evt = params?.event ?? params?.sample ?? params;
+            if (evt && Array.isArray(evt.categories))
+                samples.push(evt);
+        }));
+        unsubscribers.push(ps.session.on('Memory.trackingComplete', () => { }));
+        try {
+            await ps.session.send('Memory.startTracking', undefined, 5_000);
+        }
+        catch (e) {
+            unsubscribers.forEach(u => u());
+            return errorResult(`Memory.startTracking failed: ${describe(e)}`);
+        }
+        await new Promise(r => setTimeout(r, durationMs));
+        try {
+            await ps.session.send('Memory.stopTracking', undefined, 10_000);
+        }
+        catch { /* best-effort */ }
+        await new Promise(r => setTimeout(r, 200)); // let trackingComplete drain
+        unsubscribers.forEach(u => u());
+        if (samples.length === 0) {
+            return textResult(`# record_memory_tracking ✓ ${durationMs}ms\n\n` +
+                'No `Memory.trackingUpdate` events received. The page may have produced no allocation deltas during the window — interact with it (scroll / load images / open detail view) and re-record. Schema may also differ on this iOS build; set WDM_WS_DEBUG=1 to see raw event payloads.');
+        }
+        const first = samples[0];
+        const last = samples[samples.length - 1];
+        const lookup = (s, type) => s.categories?.find(c => c.type === type)?.size ?? 0;
+        const cats = new Set();
+        for (const s of samples)
+            for (const c of s.categories ?? [])
+                if (c.type)
+                    cats.add(c.type);
+        const lines = [
+            `# record_memory_tracking ✓ ${durationMs}ms`,
+            '',
+            `Samples: ${samples.length}`,
+            `First @ ${first.timestamp ?? 'unknown'} → Last @ ${last.timestamp ?? 'unknown'}`,
+            '',
+            '| category | first (MB) | last (MB) | delta (MB) | delta % |',
+            '|---|---|---|---|---|',
+        ];
+        for (const t of [...cats].sort()) {
+            const a = lookup(first, t);
+            const b = lookup(last, t);
+            const delta = b - a;
+            const pct = a > 0 ? `${((delta / a) * 100).toFixed(1)}%` : '—';
+            lines.push(`| ${t} | ${(a / 1024 / 1024).toFixed(2)} | ${(b / 1024 / 1024).toFixed(2)} | ${(delta / 1024 / 1024).toFixed(2)} | ${pct} |`);
+        }
+        lines.push('');
+        lines.push('⚠ Apple WIP `Memory.trackingUpdate` event schema is union-typed across iOS builds. If categories look empty or mis-attributed, dump raw with WDM_WS_DEBUG=1 and file a probe.');
+        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=record_memory_tracking.js.map

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

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

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

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

package/build/src/tools/record_timeline.js

@@ -0,0 +1,110 @@
+import { z } from 'zod';
+import { PageSession } from '../page-session.js';
+export const recordTimelineTool = {
+    name: 'record_timeline',
+    description: [
+        'Record an Apple WIP Timeline trace for a fixed duration on the inspected iOS WebView page.',
+        'WIP exposes `Timeline.start` / `Timeline.stop` + `Timeline.eventRecorded` events (probe-confirmed 2026-05-16). This is the Apple equivalent of CDP `Tracing.*` — captures rendering / scripting / layout / paint events while the timeline is active.',
+        'The tool subscribes to events, calls `Timeline.start`, waits `durationMs`, then `Timeline.stop` and returns aggregated event counts + top-N hottest entries by duration.',
+    ].join(' '),
+    inputSchema: {
+        durationMs: z
+            .number()
+            .int()
+            .min(100)
+            .max(60_000)
+            .optional()
+            .describe('How long to record (default 3000).'),
+        topN: z
+            .number()
+            .int()
+            .min(1)
+            .max(200)
+            .optional()
+            .describe('Top-N hottest events (by duration) returned (default 20).'),
+        eventTypeFilter: z
+            .string()
+            .optional()
+            .describe('Case-insensitive substring filter on event type (e.g. "script", "layout", "paint").'),
+    },
+    handler: async ({ durationMs = 3_000, topN = 20, eventTypeFilter, }) => {
+        let ps;
+        try {
+            ps = await PageSession.get();
+        }
+        catch (e) {
+            return errorResult(`Unable to attach: ${describe(e)}`);
+        }
+        const events = [];
+        const unsubscribe = ps.session.on('Timeline.eventRecorded', (p) => {
+            const params = p;
+            if (params?.record)
+                events.push(params.record);
+        });
+        try {
+            await ps.session.send('Timeline.start', undefined, 10_000);
+        }
+        catch (e) {
+            unsubscribe();
+            return errorResult(`Timeline.start failed: ${describe(e)}`);
+        }
+        await new Promise(r => setTimeout(r, durationMs));
+        try {
+            await ps.session.send('Timeline.stop', undefined, 10_000);
+        }
+        catch (e) {
+            unsubscribe();
+            return errorResult(`Timeline.stop failed: ${describe(e)}`);
+        }
+        // Allow tail events to drain.
+        await new Promise(r => setTimeout(r, 100));
+        unsubscribe();
+        let kept = events;
+        if (eventTypeFilter) {
+            const n = eventTypeFilter.toLowerCase();
+            kept = kept.filter(e => (e.type || '').toLowerCase().includes(n));
+        }
+        const byType = new Map();
+        for (const e of kept)
+            byType.set(e.type, (byType.get(e.type) ?? 0) + 1);
+        const typeRows = [...byType.entries()].sort((a, b) => b[1] - a[1]);
+        const withDuration = kept
+            .filter(e => typeof e.startTime === 'number' && typeof e.endTime === 'number')
+            .map(e => ({ ...e, _dur: e.endTime - e.startTime }))
+            .sort((a, b) => b._dur - a._dur)
+            .slice(0, topN);
+        const lines = [
+            `# record_timeline ✓ ${durationMs}ms recorded`,
+            '',
+            `Total events: ${events.length}${eventTypeFilter ? ` (${kept.length} after filter "${eventTypeFilter}")` : ''}`,
+            '',
+        ];
+        if (typeRows.length > 0) {
+            lines.push('## events by type');
+            typeRows.slice(0, 30).forEach(([t, n]) => lines.push(`- ${t}: ${n}`));
+            if (typeRows.length > 30)
+                lines.push(`- … ${typeRows.length - 30} more types`);
+        }
+        if (withDuration.length > 0) {
+            lines.push('');
+            lines.push(`## top ${withDuration.length} hottest events`);
+            lines.push('| dur (ms) | type | startTime | data |');
+            lines.push('|---|---|---|---|');
+            for (const e of withDuration) {
+                const data = e.data ? JSON.stringify(e.data).slice(0, 80) : '';
+                lines.push(`| ${e._dur.toFixed(2)} | ${e.type} | ${e.startTime.toFixed(2)} | ${data.replace(/\|/g, '\\|')} |`);
+            }
+        }
+        else if (kept.length > 0) {
+            lines.push('');
+            lines.push('(no events with start/end timestamps for hottest ranking)');
+        }
+        lines.push('');
+        lines.push('⚠ Apple WIP `Timeline` semantically maps to CDP `Tracing` but the event schema differs. Common types: `RenderingFrame` / `ScheduleStyleRecalculation` / `Paint` / `Layout` / `EvaluateScript` / `FunctionCall` / `TimerFire`.');
+        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=record_timeline.js.map

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

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

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

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

package/build/src/tools/reload_page.js

@@ -0,0 +1,59 @@
+import { z } from 'zod';
+import { PageSession } from '../page-session.js';
+export const reloadPageTool = {
+    name: 'reload_page',
+    description: [
+        'Reload the inspected iOS WebView page via WIP `Page.reload`.',
+        '`Page.reload` is one of the few `Page.*` methods present on WIP (verified 2026-05-16 probe). Cache mode is honored by WebKit.',
+        'Side effect: console + network buffers are NOT cleared automatically (they\'re per-attach not per-navigation). Call `select_page` to do that explicitly.',
+    ].join(' '),
+    inputSchema: {
+        ignoreCache: z
+            .boolean()
+            .optional()
+            .describe('Bypass cache (equivalent to hard reload). Default false.'),
+        waitAfterMs: z
+            .number()
+            .int()
+            .min(0)
+            .max(60_000)
+            .optional()
+            .describe('Block after issuing reload for this long (default 500). Use `wait_for` for stronger sync to a specific selector.'),
+    },
+    handler: async ({ ignoreCache = false, waitAfterMs = 500, }) => {
+        let ps;
+        try {
+            ps = await PageSession.get();
+        }
+        catch (e) {
+            return errorResult(`Unable to attach to a WKWebView page: ${describe(e)}`);
+        }
+        try {
+            await ps.session.send('Page.reload', { ignoreCache }, 10_000);
+        }
+        catch (e) {
+            return errorResult(`Page.reload failed: ${describe(e)}`);
+        }
+        if (waitAfterMs > 0) {
+            await new Promise(r => setTimeout(r, waitAfterMs));
+        }
+        return textResult([
+            `# reload_page ✓`,
+            '',
+            `ignoreCache: ${ignoreCache}`,
+            `Waited ${waitAfterMs}ms after issuing reload.`,
+            '',
+            '⚠ Console/Network buffers retain pre-reload entries. Use `select_page` (same pageId) to reattach + reset, or filter by timestamp on the next read.',
+        ].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=reload_page.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reload_page.js","sourceRoot":"","sources":["../../../src/tools/reload_page.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE;QACX,8DAA8D;QAC9D,+HAA+H;QAC/H,0JAA0J;KAC3J,CAAC,IAAI,CAAC,GAAG,CAAC;IAEX,WAAW,EAAE;QACX,WAAW,EAAE,CAAC;aACX,OAAO,EAAE;aACT,QAAQ,EAAE;aACV,QAAQ,CAAC,0DAA0D,CAAC;QACvE,WAAW,EAAE,CAAC;aACX,MAAM,EAAE;aACR,GAAG,EAAE;aACL,GAAG,CAAC,CAAC,CAAC;aACN,GAAG,CAAC,MAAM,CAAC;aACX,QAAQ,EAAE;aACV,QAAQ,CAAC,kHAAkH,CAAC;KAChI;IAED,OAAO,EAAE,KAAK,EAAE,EACd,WAAW,GAAG,KAAK,EACnB,WAAW,GAAG,GAAG,GAC+B,EAAE,EAAE;QACpD,IAAI,EAAe,CAAC;QACpB,IAAI,CAAC;YACH,EAAE,GAAG,MAAM,WAAW,CAAC,GAAG,EAAE,CAAC;QAC/B,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,WAAW,CAAC,yCAAyC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC7E,CAAC;QAED,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,WAAW,EAAE,EAAE,MAAM,CAAC,CAAC;QAChE,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,WAAW,CAAC,uBAAuB,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC3D,CAAC;QAED,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;YACpB,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC;QACrD,CAAC;QAED,OAAO,UAAU,CACf;YACE,iBAAiB;YACjB,EAAE;YACF,gBAAgB,WAAW,EAAE;YAC7B,UAAU,WAAW,0BAA0B;YAC/C,EAAE;YACF,oJAAoJ;SACrJ,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,SAAS,UAAU,CAAC,IAAY;IAC9B,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AACxD,CAAC;AACD,SAAS,WAAW,CAAC,IAAY;IAC/B,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AACvE,CAAC;AACD,SAAS,QAAQ,CAAC,CAAU;IAC1B,OAAO,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AACpD,CAAC"}

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

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