chore(memory): sort nodes by size

Author: Lightning00Blade

src/McpResponse.ts

@@ -9,6 +9,7 @@ import type {WebMCPTool} from 'puppeteer-core';
 import type {ParsedArguments} from './bin/chrome-devtools-mcp-cli-options.js';
 import {ConsoleFormatter} from './formatters/ConsoleFormatter.js';
 import {HeapSnapshotFormatter} from './formatters/HeapSnapshotFormatter.js';
+import {isNodeLike} from './formatters/HeapSnapshotFormatter.js';
 import {IssueFormatter} from './formatters/IssueFormatter.js';
 import {NetworkFormatter} from './formatters/NetworkFormatter.js';
 import {SnapshotFormatter} from './formatters/SnapshotFormatter.js';
@@ -945,8 +946,14 @@ Call ${handleDialog.name} to handle it before continuing.`);
       }
       const nodes = this.#heapSnapshotOptions.nodes;
       if (nodes) {
+        // Sort nodes by retained size in descending order.
+        // We filter for nodes (ignoring edges if any) to satisfy TypeScript and ensure safe sorting.
+        const sortedItems = nodes.items
+          .filter(isNodeLike)
+          .sort((a, b) => b.selfSize - a.selfSize);
+
         const paginationData = this.#dataWithPagination(
-          nodes.items,
+          sortedItems,
           this.#heapSnapshotOptions.pagination,
         );
 

src/formatters/HeapSnapshotFormatter.ts

@@ -16,7 +16,7 @@ export interface FormattedSnapshotEntry {
   retainedSize: number;
 }
 
-function isNodeLike(
+export function isNodeLike(
   item: unknown,
 ): item is DevTools.HeapSnapshotModel.HeapSnapshotModel.Node {
   return (

tests/tools/memory.test.js.snapshot

@@ -167,11 +167,11 @@ id,name,type,distance,selfSize,retainedSize
 25307,"Array",object,2,192,2056
 33187,"Array",object,2,192,1664
 36255,"Array",object,2,192,1664
-45899,"Array",object,5,56,56
+46355,"Array",object,2,192,2056
 45901,"Array",object,5,88,88
-46149,"Array",object,5,56,56
 46151,"Array",object,5,88,88
-46355,"Array",object,2,192,2056
+45899,"Array",object,5,56,56
+46149,"Array",object,5,56,56
 Showing 1-8 of 8 (Page 1 of 1).
 `;