flutter-devtools-mcp 0.3.1

package/dist/tools/rebuild-tracker.js

@@ -0,0 +1,228 @@
+import { z } from "zod";
+import { mergeLocationMap } from "../services/rebuild-tracker-service.js";
+export function registerRebuildTrackerTools(server, client) {
+    let tracking = false;
+    let rebuildCounts = new Map();
+    let locationMap = {};
+    let trackingStartTime = 0;
+    const rebuildListener = (event) => {
+        if (event?.extensionKind === "Flutter.RebuiltWidgets") {
+            const data = event.extensionData;
+            if (data?.locations)
+                mergeLocationMap(locationMap, data.locations);
+            if (data?.newLocations)
+                mergeLocationMap(locationMap, data.newLocations);
+            if (data?.events && Array.isArray(data.events)) {
+                for (let i = 0; i < data.events.length; i += 2) {
+                    const locationId = data.events[i];
+                    const count = data.events[i + 1];
+                    rebuildCounts.set(locationId, (rebuildCounts.get(locationId) ?? 0) + count);
+                }
+            }
+        }
+    };
+    server.tool("start_tracking_rebuilds", "Start tracking which widgets are rebuilding and how often. After starting, interact with the app, then call stop_tracking_rebuilds to see exactly which widgets rebuilt, how many times, and where they are in your code. This is the most effective way to find unnecessary rebuilds.", {}, async () => {
+        if (!client.connected) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "Not connected. Use the `connect` tool first.",
+                    },
+                ],
+                isError: true,
+            };
+        }
+        if (tracking) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "Already tracking rebuilds. Call stop_tracking_rebuilds first.",
+                    },
+                ],
+                isError: true,
+            };
+        }
+        try {
+            rebuildCounts = new Map();
+            locationMap = {};
+            try {
+                mergeLocationMap(locationMap, await client.getWidgetLocationMap());
+            }
+            catch {
+                // Location map may not be available yet
+            }
+            client.on("stream:Extension", rebuildListener);
+            await client.startTrackingRebuilds();
+            tracking = true;
+            trackingStartTime = Date.now();
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "✅ Rebuild tracking started. Interact with the app now (scroll, tap, navigate between screens), then call `stop_tracking_rebuilds` to see which widgets rebuilt and how many times.",
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Failed to start rebuild tracking: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    server.tool("stop_tracking_rebuilds", "Stop tracking widget rebuilds and get a detailed report showing exactly which widgets rebuilt, how many times, and their source file locations. Sorted by rebuild count to highlight the most problematic widgets.", {
+        topN: z
+            .number()
+            .min(5)
+            .max(100)
+            .default(30)
+            .describe("Number of top rebuilding widgets to show"),
+    }, async ({ topN }) => {
+        if (!client.connected) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "Not connected. Use the `connect` tool first.",
+                    },
+                ],
+                isError: true,
+            };
+        }
+        if (!tracking) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "Not tracking rebuilds. Call start_tracking_rebuilds first.",
+                    },
+                ],
+                isError: true,
+            };
+        }
+        try {
+            await client.stopTrackingRebuilds();
+            client.off("stream:Extension", rebuildListener);
+            tracking = false;
+            const durationMs = Date.now() - trackingStartTime;
+            try {
+                mergeLocationMap(locationMap, await client.getWidgetLocationMap());
+            }
+            catch {
+                // Best effort
+            }
+            const entries = [];
+            let totalRebuilds = 0;
+            for (const [locationId, count] of rebuildCounts) {
+                totalRebuilds += count;
+                const loc = locationMap[String(locationId)];
+                if (loc) {
+                    const file = loc.file
+                        .replace(/^file:\/\//, "")
+                        .split("/lib/")
+                        .pop() ?? loc.file.split("/").pop() ?? loc.file;
+                    entries.push({
+                        widgetName: loc.name,
+                        file,
+                        line: loc.line,
+                        rebuildCount: count,
+                    });
+                }
+                else {
+                    entries.push({
+                        widgetName: `Unknown (location ${locationId})`,
+                        file: "unknown",
+                        line: 0,
+                        rebuildCount: count,
+                    });
+                }
+            }
+            entries.sort((a, b) => b.rebuildCount - a.rebuildCount);
+            const uniqueWidgets = entries.length;
+            const durationSec = (durationMs / 1000).toFixed(1);
+            const output = [
+                "═══════════════════════════════════════════════════════════",
+                "  WIDGET REBUILD REPORT",
+                "═══════════════════════════════════════════════════════════",
+                "",
+                "📊 SUMMARY",
+                "───────────────────────────────────────────────────────────",
+                `Tracked for ${durationSec}s`,
+                `Total rebuilds: ${totalRebuilds.toLocaleString()}`,
+                `Unique widgets rebuilt: ${uniqueWidgets}`,
+                `Average rebuilds per widget: ${uniqueWidgets > 0 ? (totalRebuilds / uniqueWidgets).toFixed(1) : "0"}`,
+                "",
+            ];
+            if (entries.length === 0) {
+                output.push("No rebuilds captured. Make sure you interacted with the app while tracking.");
+            }
+            else {
+                output.push(`🔥 TOP ${Math.min(topN, entries.length)} REBUILDING WIDGETS`);
+                output.push("───────────────────────────────────────────────────────────");
+                for (const entry of entries.slice(0, topN)) {
+                    const severity = entry.rebuildCount > 100
+                        ? "🔴"
+                        : entry.rebuildCount > 30
+                            ? "🟠"
+                            : entry.rebuildCount > 10
+                                ? "🟡"
+                                : "🟢";
+                    output.push(`${severity} ${entry.rebuildCount.toLocaleString().padStart(6)}x | ${entry.widgetName} [${entry.file}:${entry.line}]`);
+                }
+                const excessiveRebuilds = entries.filter((e) => e.rebuildCount > 50);
+                if (excessiveRebuilds.length > 0) {
+                    output.push("");
+                    output.push("💡 RECOMMENDATIONS");
+                    output.push("───────────────────────────────────────────────────────────");
+                    for (const entry of excessiveRebuilds.slice(0, 5)) {
+                        output.push(`• ${entry.widgetName} rebuilt ${entry.rebuildCount}x [${entry.file}:${entry.line}]`);
+                        if (entry.rebuildCount > 100) {
+                            output.push(`  → This widget is rebuilding excessively. Check if it depends on a`);
+                            output.push(`    Provider/InheritedWidget that changes too frequently. Consider`);
+                            output.push(`    using context.select() instead of context.watch() or adding`);
+                            output.push(`    a const constructor.`);
+                        }
+                        else {
+                            output.push(`  → Consider wrapping in a const constructor or extracting into`);
+                            output.push(`    a separate widget to limit rebuild scope.`);
+                        }
+                    }
+                }
+                if (excessiveRebuilds.length === 0) {
+                    output.push("");
+                    output.push("✅ No excessive rebuilds detected. Widget rebuild counts look healthy.");
+                }
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: output.join("\n"),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            tracking = false;
+            client.off("stream:Extension", rebuildListener);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Failed to stop rebuild tracking: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=rebuild-tracker.js.map

package/dist/tools/rebuild-tracker.js.map

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

package/dist/tools/snapshot-diff.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { FlutterVmServiceClient } from "../services/vm-service-client.js";
+export declare function registerSnapshotDiffTools(server: McpServer, client: FlutterVmServiceClient): void;
+//# sourceMappingURL=snapshot-diff.d.ts.map

package/dist/tools/snapshot-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-diff.d.ts","sourceRoot":"","sources":["../../src/tools/snapshot-diff.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAqB,MAAM,kCAAkC,CAAC;AAkC7F,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,sBAAsB,QAoS/B"}

package/dist/tools/snapshot-diff.js

@@ -0,0 +1,235 @@
+import { z } from "zod";
+function formatBytes(bytes) {
+    if (bytes === 0)
+        return "0 B";
+    const sign = bytes < 0 ? "-" : "";
+    const abs = Math.abs(bytes);
+    const units = ["B", "KB", "MB", "GB"];
+    const k = 1024;
+    const i = Math.floor(Math.log(abs) / Math.log(k));
+    return `${sign}${(abs / Math.pow(k, i)).toFixed(2)} ${units[i]}`;
+}
+function pctChange(before, after) {
+    if (before === 0)
+        return after > 0 ? "+∞%" : "0%";
+    const pct = ((after - before) / before) * 100;
+    const sign = pct > 0 ? "+" : "";
+    return `${sign}${pct.toFixed(1)}%`;
+}
+export function registerSnapshotDiffTools(server, client) {
+    const snapshots = new Map();
+    async function takeSnapshot(name, gc) {
+        const profile = await client.getAllocationProfile(undefined, gc);
+        const validMembers = profile.members.filter((m) => m.class?.name);
+        const sorted = [...validMembers]
+            .sort((a, b) => b.bytesCurrent - a.bytesCurrent)
+            .filter((m) => m.bytesCurrent > 0)
+            .slice(0, 50);
+        return {
+            name,
+            timestamp: Date.now(),
+            memory: {
+                heapUsage: profile.memoryUsage.heapUsage,
+                heapCapacity: profile.memoryUsage.heapCapacity,
+                externalUsage: profile.memoryUsage.externalUsage,
+                topClasses: sorted.map((m) => ({
+                    name: m.class.name,
+                    bytes: m.bytesCurrent,
+                    instances: m.instancesCurrent,
+                })),
+            },
+        };
+    }
+    server.tool("save_snapshot", "Save a named memory snapshot for later comparison. Take a snapshot before making a code change, then take another after to see the impact. Use compare_snapshots to see the diff.", {
+        name: z
+            .string()
+            .describe('A name for this snapshot (e.g., "before-fix", "after-optimization")'),
+        forceGC: z
+            .boolean()
+            .default(true)
+            .describe("Force garbage collection before snapshot (default: true)"),
+    }, async ({ name, forceGC }) => {
+        if (!client.connected) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "Not connected. Use the `connect` tool first.",
+                    },
+                ],
+                isError: true,
+            };
+        }
+        try {
+            const snapshot = await takeSnapshot(name, forceGC);
+            snapshots.set(name, snapshot);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: [
+                            `✅ Snapshot "${name}" saved.`,
+                            "",
+                            `  Heap: ${formatBytes(snapshot.memory.heapUsage)} / ${formatBytes(snapshot.memory.heapCapacity)}`,
+                            `  Classes tracked: ${snapshot.memory.topClasses.length}`,
+                            `  Time: ${new Date(snapshot.timestamp).toLocaleTimeString()}`,
+                            "",
+                            `Saved snapshots: ${Array.from(snapshots.keys()).join(", ")}`,
+                            "",
+                            'Take another snapshot after your change, then use `compare_snapshots` to see the diff.',
+                        ].join("\n"),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Failed to save snapshot: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    server.tool("compare_snapshots", "Compare two previously saved memory snapshots to see what changed. Shows heap usage diff, which classes grew or shrank, new allocations, and freed memory. Perfect for validating that a fix actually reduced memory usage.", {
+        before: z
+            .string()
+            .describe('Name of the "before" snapshot'),
+        after: z
+            .string()
+            .describe('Name of the "after" snapshot'),
+    }, async ({ before, after }) => {
+        const snap1 = snapshots.get(before);
+        const snap2 = snapshots.get(after);
+        if (!snap1) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Snapshot "${before}" not found. Available: ${Array.from(snapshots.keys()).join(", ") || "none"}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        if (!snap2) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Snapshot "${after}" not found. Available: ${Array.from(snapshots.keys()).join(", ") || "none"}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const heapDiff = snap2.memory.heapUsage - snap1.memory.heapUsage;
+        const capacityDiff = snap2.memory.heapCapacity - snap1.memory.heapCapacity;
+        const beforeMap = new Map(snap1.memory.topClasses.map((c) => [c.name, c]));
+        const afterMap = new Map(snap2.memory.topClasses.map((c) => [c.name, c]));
+        const allClassNames = new Set([
+            ...beforeMap.keys(),
+            ...afterMap.keys(),
+        ]);
+        const diffs = [];
+        for (const name of allClassNames) {
+            const b = beforeMap.get(name);
+            const a = afterMap.get(name);
+            diffs.push({
+                name,
+                bytesBefore: b?.bytes ?? 0,
+                bytesAfter: a?.bytes ?? 0,
+                bytesDiff: (a?.bytes ?? 0) - (b?.bytes ?? 0),
+                instancesBefore: b?.instances ?? 0,
+                instancesAfter: a?.instances ?? 0,
+                instancesDiff: (a?.instances ?? 0) - (b?.instances ?? 0),
+            });
+        }
+        const grew = diffs
+            .filter((d) => d.bytesDiff > 0)
+            .sort((a, b) => b.bytesDiff - a.bytesDiff);
+        const shrank = diffs
+            .filter((d) => d.bytesDiff < 0)
+            .sort((a, b) => a.bytesDiff - b.bytesDiff);
+        const heapIcon = heapDiff <= 0 ? "🟢" : heapDiff > 10_000_000 ? "🔴" : "🟡";
+        const output = [
+            "═══════════════════════════════════════════════════════════",
+            "  SNAPSHOT COMPARISON",
+            `  "${before}" → "${after}"`,
+            "═══════════════════════════════════════════════════════════",
+            "",
+            "📊 HEAP OVERVIEW",
+            "───────────────────────────────────────────────────────────",
+            `${heapIcon} Heap usage: ${formatBytes(snap1.memory.heapUsage)} → ${formatBytes(snap2.memory.heapUsage)} (${heapDiff <= 0 ? "" : "+"}${formatBytes(heapDiff)}, ${pctChange(snap1.memory.heapUsage, snap2.memory.heapUsage)})`,
+            `  Capacity:   ${formatBytes(snap1.memory.heapCapacity)} → ${formatBytes(snap2.memory.heapCapacity)} (${capacityDiff <= 0 ? "" : "+"}${formatBytes(capacityDiff)})`,
+            `  Time between snapshots: ${((snap2.timestamp - snap1.timestamp) / 1000).toFixed(1)}s`,
+            "",
+        ];
+        if (grew.length > 0) {
+            output.push("📈 GREW (top 10)");
+            output.push("───────────────────────────────────────────────────────────");
+            for (const d of grew.slice(0, 10)) {
+                const instDiff = d.instancesDiff > 0
+                    ? `+${d.instancesDiff.toLocaleString()}`
+                    : d.instancesDiff.toLocaleString();
+                output.push(`  🔺 +${formatBytes(d.bytesDiff).padStart(10)} | ${instDiff.padStart(8)} inst | ${d.name}`);
+            }
+            output.push("");
+        }
+        if (shrank.length > 0) {
+            output.push("📉 SHRANK (top 10)");
+            output.push("───────────────────────────────────────────────────────────");
+            for (const d of shrank.slice(0, 10)) {
+                const instDiff = d.instancesDiff > 0
+                    ? `+${d.instancesDiff.toLocaleString()}`
+                    : d.instancesDiff.toLocaleString();
+                output.push(`  🔻 ${formatBytes(d.bytesDiff).padStart(11)} | ${instDiff.padStart(8)} inst | ${d.name}`);
+            }
+            output.push("");
+        }
+        output.push("💡 VERDICT");
+        output.push("───────────────────────────────────────────────────────────");
+        if (heapDiff < -1_000_000) {
+            output.push(`✅ Memory improved by ${formatBytes(Math.abs(heapDiff))} (${pctChange(snap1.memory.heapUsage, snap2.memory.heapUsage)}). Nice work!`);
+        }
+        else if (heapDiff > 1_000_000) {
+            output.push(`⚠️ Memory increased by ${formatBytes(heapDiff)} (${pctChange(snap1.memory.heapUsage, snap2.memory.heapUsage)}). Check the classes that grew above.`);
+        }
+        else {
+            output.push("➡️ No significant change in memory usage between snapshots.");
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: output.join("\n"),
+                },
+            ],
+        };
+    });
+    server.tool("list_snapshots", "List all saved memory snapshots available for comparison.", {}, async () => {
+        if (snapshots.size === 0) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "No snapshots saved yet. Use `save_snapshot` to create one.",
+                    },
+                ],
+            };
+        }
+        const lines = ["Saved snapshots:", ""];
+        for (const [name, snap] of snapshots) {
+            lines.push(`  • "${name}" — ${formatBytes(snap.memory.heapUsage)} heap, ${new Date(snap.timestamp).toLocaleTimeString()}`);
+        }
+        return {
+            content: [
+                { type: "text", text: lines.join("\n") },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=snapshot-diff.js.map

package/dist/tools/snapshot-diff.js.map

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

package/dist/tools/widget-tree.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { FlutterVmServiceClient } from "../services/vm-service-client.js";
+export declare function registerWidgetTreeTools(server: McpServer, client: FlutterVmServiceClient): void;
+//# sourceMappingURL=widget-tree.d.ts.map

package/dist/tools/widget-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"widget-tree.d.ts","sourceRoot":"","sources":["../../src/tools/widget-tree.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAqH1E,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,sBAAsB,QA6G/B"}