@memlab/mcp-server 2.0.0

package/dist/tools/reports.js

@@ -0,0 +1,540 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @format
+ * @oncall memory_lab
+ */
+import { z } from 'zod';
+import { getSnapshot } from '../heap-state.js';
+import { formatBytes, formatNumber, markdownTable, isNodeWorthInspecting, filterLargestObjects, serializeNodeSummary, formatNodeSummaryTable, queryNodes, formatQueryNodesResult, errorResult, textResult, } from '../utils.js';
+// --- Detached DOM analysis ---
+function isDetachedDOMNode(node) {
+    if (node.id <= 3)
+        return false;
+    if (node.is_detached)
+        return true;
+    return node.name.startsWith('Detached ');
+}
+function runDetachedDom(limit) {
+    const snapshot = getSnapshot();
+    const result = queryNodes(snapshot, isDetachedDOMNode, {
+        limit,
+        offset: 0,
+        outputMode: 'full',
+    });
+    return `## Detached DOM Nodes\n\n${formatQueryNodesResult(result)}`;
+}
+// --- Duplicated Strings analysis ---
+function runDuplicatedStrings(limit) {
+    const snapshot = getSnapshot();
+    const stringMap = new Map();
+    snapshot.nodes.forEach(node => {
+        if (node.type !== 'string')
+            return;
+        if (node.name === 'system / SlicedString')
+            return;
+        const strNode = node.toStringNode();
+        if (!strNode)
+            return;
+        const value = strNode.stringValue;
+        const entry = stringMap.get(value);
+        if (entry) {
+            entry.count++;
+            entry.total_size += node.retainedSize;
+            if (entry.example_node_ids.length < 3) {
+                entry.example_node_ids.push(node.id);
+            }
+        }
+        else {
+            stringMap.set(value, {
+                count: 1,
+                total_size: node.retainedSize,
+                example_node_ids: [node.id],
+            });
+        }
+    });
+    const duplicated = Array.from(stringMap.entries())
+        .filter(([, stats]) => stats.count > 1)
+        .sort((a, b) => b[1].total_size - a[1].total_size)
+        .slice(0, limit)
+        .map(([value, stats]) => ({
+        value: value.length > 80 ? value.slice(0, 80) + '...' : value,
+        count: stats.count,
+        total_size_formatted: formatBytes(stats.total_size),
+        example_node_ids: stats.example_node_ids,
+    }));
+    if (duplicated.length === 0) {
+        return '## Duplicated Strings\n\nNo duplicated strings found.';
+    }
+    const lines = duplicated.map((d, i) => {
+        const nodeIds = d.example_node_ids.map(id => `@${id}`).join(', ');
+        return `${i + 1}. "${d.value}" x ${d.count} copies, ${d.total_size_formatted} total (nodes: ${nodeIds})`;
+    });
+    return `## Duplicated Strings\n\n${duplicated.length} entries:\n\n${lines.join('\n')}`;
+}
+// --- Stale Collections analysis ---
+const COLLECTION_NAMES = new Set(['Map', 'Set', 'WeakMap', 'WeakSet', 'Array']);
+function isCollectionNode(node) {
+    return node.type === 'object' && COLLECTION_NAMES.has(node.name);
+}
+function isStaleNode(node) {
+    return node.is_detached || node.name.startsWith('Detached ');
+}
+function getCollectionChildren(node) {
+    if (node.name === 'Map' || node.name === 'Set') {
+        const tableEdge = node.references.find(e => e.name_or_index === 'table');
+        if (tableEdge) {
+            return tableEdge.toNode.references;
+        }
+    }
+    return node.references;
+}
+function runStaleCollections(limit) {
+    const snapshot = getSnapshot();
+    const results = [];
+    snapshot.nodes.forEach(node => {
+        if (!isCollectionNode(node))
+            return;
+        const children = getCollectionChildren(node);
+        let staleCount = 0;
+        let staleRetainedSize = 0;
+        let totalChildren = 0;
+        for (const edge of children) {
+            totalChildren++;
+            if (isStaleNode(edge.toNode)) {
+                staleCount++;
+                staleRetainedSize += edge.toNode.retainedSize;
+            }
+        }
+        if (staleCount > 0) {
+            results.push({
+                collection: node,
+                stale_item_count: staleCount,
+                stale_retained_size: staleRetainedSize,
+                total_children: totalChildren,
+            });
+        }
+    });
+    results.sort((a, b) => b.stale_retained_size - a.stale_retained_size);
+    const topResults = results.slice(0, limit);
+    if (topResults.length === 0) {
+        return '## Stale Collections\n\nNo stale collections found.';
+    }
+    const headers = ['Collection ID', 'Name', 'Stale / Total', 'Stale Retained'];
+    const rightCols = new Set([2, 3]);
+    const rows = topResults.map(r => [
+        `@${r.collection.id}`,
+        r.collection.name,
+        `${formatNumber(r.stale_item_count)} / ${formatNumber(r.total_children)}`,
+        formatBytes(r.stale_retained_size),
+    ]);
+    return `## Stale Collections\n\n${topResults.length} found\n\n${markdownTable(headers, rows, rightCols)}`;
+}
+// --- Global Variables analysis ---
+const BUILTIN_GLOBALS = new Set([
+    'undefined',
+    'NaN',
+    'Infinity',
+    'globalThis',
+    'self',
+    'window',
+    'document',
+    'navigator',
+    'location',
+    'history',
+    'screen',
+    'performance',
+    'localStorage',
+    'sessionStorage',
+    'caches',
+    'crypto',
+    'indexedDB',
+    'console',
+    'alert',
+    'confirm',
+    'prompt',
+    'close',
+    'open',
+    'print',
+    'top',
+    'parent',
+    'frames',
+    'frameElement',
+    'opener',
+    'devicePixelRatio',
+    'innerHeight',
+    'innerWidth',
+    'outerHeight',
+    'outerWidth',
+    'scrollX',
+    'scrollY',
+    'pageXOffset',
+    'pageYOffset',
+    'screenX',
+    'screenY',
+    'screenLeft',
+    'screenTop',
+    'visualViewport',
+    'styleMedia',
+    'addEventListener',
+    'removeEventListener',
+    'dispatchEvent',
+    'onclick',
+    'onload',
+    'onerror',
+    'onmessage',
+    'onresize',
+    'onscroll',
+    'onbeforeunload',
+    'onunload',
+    'onhashchange',
+    'onpopstate',
+    'onfocus',
+    'onblur',
+    'onkeydown',
+    'onkeyup',
+    'onkeypress',
+    'onmousedown',
+    'onmouseup',
+    'onmousemove',
+    'onmouseenter',
+    'onmouseleave',
+    'ontouchstart',
+    'ontouchend',
+    'ontouchmove',
+    'ontouchcancel',
+    'onanimationend',
+    'onanimationstart',
+    'onanimationiteration',
+    'ontransitionend',
+    'onpointerdown',
+    'onpointerup',
+    'onpointermove',
+    'setTimeout',
+    'clearTimeout',
+    'setInterval',
+    'clearInterval',
+    'requestAnimationFrame',
+    'cancelAnimationFrame',
+    'requestIdleCallback',
+    'cancelIdleCallback',
+    'fetch',
+    'XMLHttpRequest',
+    'WebSocket',
+    'EventSource',
+    'Request',
+    'Response',
+    'Headers',
+    'URL',
+    'URLSearchParams',
+    'AbortController',
+    'AbortSignal',
+    'Worker',
+    'SharedWorker',
+    'ServiceWorker',
+    'BroadcastChannel',
+    'MessageChannel',
+    'Image',
+    'Audio',
+    'MediaSource',
+    'MediaStream',
+    'MediaRecorder',
+    'AudioContext',
+    'OfflineAudioContext',
+    'SpeechSynthesis',
+    'Object',
+    'Function',
+    'Array',
+    'Number',
+    'String',
+    'Boolean',
+    'Symbol',
+    'Date',
+    'RegExp',
+    'Error',
+    'TypeError',
+    'RangeError',
+    'SyntaxError',
+    'ReferenceError',
+    'URIError',
+    'EvalError',
+    'Map',
+    'Set',
+    'WeakMap',
+    'WeakSet',
+    'WeakRef',
+    'FinalizationRegistry',
+    'Promise',
+    'Proxy',
+    'Reflect',
+    'ArrayBuffer',
+    'SharedArrayBuffer',
+    'DataView',
+    'Int8Array',
+    'Uint8Array',
+    'Uint8ClampedArray',
+    'Int16Array',
+    'Uint16Array',
+    'Int32Array',
+    'Uint32Array',
+    'Float32Array',
+    'Float64Array',
+    'BigInt64Array',
+    'BigUint64Array',
+    'JSON',
+    'Math',
+    'Intl',
+    'Atomics',
+    'BigInt',
+    'TextEncoder',
+    'TextDecoder',
+    'Blob',
+    'File',
+    'FileReader',
+    'FileList',
+    'FormData',
+    'ReadableStream',
+    'WritableStream',
+    'TransformStream',
+    'CompressionStream',
+    'DecompressionStream',
+    'MutationObserver',
+    'IntersectionObserver',
+    'ResizeObserver',
+    'PerformanceObserver',
+    'CustomEvent',
+    'Event',
+    'EventTarget',
+    'Element',
+    'HTMLElement',
+    'HTMLDivElement',
+    'HTMLSpanElement',
+    'HTMLInputElement',
+    'HTMLButtonElement',
+    'HTMLFormElement',
+    'HTMLAnchorElement',
+    'HTMLImageElement',
+    'HTMLCanvasElement',
+    'HTMLVideoElement',
+    'HTMLAudioElement',
+    'HTMLScriptElement',
+    'HTMLStyleElement',
+    'HTMLLinkElement',
+    'HTMLMetaElement',
+    'HTMLHeadElement',
+    'HTMLBodyElement',
+    'HTMLIFrameElement',
+    'HTMLSelectElement',
+    'HTMLOptionElement',
+    'HTMLTextAreaElement',
+    'HTMLTableElement',
+    'HTMLTableRowElement',
+    'HTMLTableCellElement',
+    'Document',
+    'DocumentFragment',
+    'Node',
+    'NodeList',
+    'NamedNodeMap',
+    'DOMParser',
+    'XMLSerializer',
+    'Range',
+    'Selection',
+    'TreeWalker',
+    'SVGElement',
+    'SVGSVGElement',
+    'CSS',
+    'CSSStyleSheet',
+    'CSSRule',
+    'CSSStyleDeclaration',
+    'getComputedStyle',
+    'matchMedia',
+    'atob',
+    'btoa',
+    'encodeURI',
+    'decodeURI',
+    'encodeURIComponent',
+    'decodeURIComponent',
+    'escape',
+    'unescape',
+    'eval',
+    'isFinite',
+    'isNaN',
+    'parseInt',
+    'parseFloat',
+    'queueMicrotask',
+    'structuredClone',
+    'reportError',
+    'createImageBitmap',
+    'postMessage',
+]);
+function runGlobalVariables(limit) {
+    const snapshot = getSnapshot();
+    const globals = [];
+    snapshot.nodes.forEach(node => {
+        if (!node.name.startsWith('Window '))
+            return;
+        for (const edge of node.references) {
+            const edgeName = String(edge.name_or_index);
+            if (BUILTIN_GLOBALS.has(edgeName))
+                continue;
+            if (edge.type === 'hidden' || edge.type === 'internal')
+                continue;
+            if (edgeName.startsWith('<symbol>'))
+                continue;
+            const target = edge.toNode;
+            if (target.type === 'hidden' ||
+                target.type === 'array' ||
+                target.type === 'number')
+                continue;
+            globals.push({
+                name: edgeName,
+                target_id: target.id,
+                target_name: target.name,
+                target_type: target.type,
+                retained_size: target.retainedSize,
+            });
+        }
+    });
+    globals.sort((a, b) => b.retained_size - a.retained_size);
+    const topGlobals = globals.slice(0, limit);
+    if (topGlobals.length === 0) {
+        return '## Global Variables\n\nNo non-built-in global variables found.';
+    }
+    const headers = ['Variable', 'Target ID', 'Target Name', 'Type', 'Retained'];
+    const rightCols = new Set([4]);
+    const rows = topGlobals.map(g => [
+        g.name,
+        `@${g.target_id}`,
+        g.target_name,
+        g.target_type,
+        formatBytes(g.retained_size),
+    ]);
+    return `## Global Variables\n\n${topGlobals.length} found\n\n${markdownTable(headers, rows, rightCols)}`;
+}
+// --- Class Histogram analysis ---
+function runClassHistogram(limit) {
+    const snapshot = getSnapshot();
+    const classMap = new Map();
+    snapshot.nodes.forEach(node => {
+        if (node.id <= 3)
+            return;
+        const key = `${node.type}::${node.name}`;
+        const entry = classMap.get(key);
+        if (entry) {
+            entry.count++;
+            entry.total_self_size += node.self_size;
+        }
+        else {
+            classMap.set(key, {
+                count: 1,
+                total_self_size: node.self_size,
+                type: node.type,
+            });
+        }
+    });
+    // Sort by total self size (avoids expensive dominator computation in the report)
+    const sorted = [...classMap.entries()]
+        .sort((a, b) => b[1].total_self_size - a[1].total_self_size)
+        .slice(0, limit);
+    const headers = ['Class', 'Type', 'Count', 'Self Size'];
+    const rightCols = new Set([2, 3]);
+    const rows = sorted.map(([key, v]) => {
+        const name = key.split('::').slice(1).join('::');
+        return [
+            name,
+            v.type,
+            formatNumber(v.count),
+            formatBytes(v.total_self_size),
+        ];
+    });
+    return `## Class Histogram\n\n${formatNumber(classMap.size)} total classes, showing ${rows.length}\n\n${markdownTable(headers, rows, rightCols)}`;
+}
+// --- Largest Objects analysis ---
+function runLargestObjects(limit) {
+    const snapshot = getSnapshot();
+    const nodes = filterLargestObjects(snapshot, isNodeWorthInspecting, limit);
+    const summaries = nodes.map(serializeNodeSummary);
+    return `## Largest Objects\n\nTop ${summaries.length} by retained size\n\n${formatNodeSummaryTable(summaries)}`;
+}
+const REPORTS = [
+    {
+        name: 'detached_dom',
+        description: 'Find detached DOM elements still retained in memory — common source of leaks',
+        run: runDetachedDom,
+    },
+    {
+        name: 'duplicated_strings',
+        description: 'Find duplicated string instances ranked by total size — common source of waste',
+        run: runDuplicatedStrings,
+    },
+    {
+        name: 'stale_collections',
+        description: 'Find Map/Set/Array collections holding references to detached or unmounted nodes',
+        run: runStaleCollections,
+    },
+    {
+        name: 'global_variables',
+        description: 'Find non-built-in global variables on Window, sorted by retained size',
+        run: runGlobalVariables,
+    },
+    {
+        name: 'class_histogram',
+        description: 'Show instance count and total self size per class/constructor name',
+        run: runClassHistogram,
+    },
+    {
+        name: 'largest_objects',
+        description: 'Find the top objects by retained size in the heap',
+        run: runLargestObjects,
+    },
+];
+const REPORT_NAMES = REPORTS.map(r => r.name);
+function runList() {
+    const lines = REPORTS.map(r => `- **${r.name}**: ${r.description}`);
+    return `# Available Memory Reports\n\n${lines.join('\n')}\n\nUse \`report: "full_analysis"\` to run all reports at once, or pick an individual report by name.`;
+}
+export function registerReports(server) {
+    server.tool('memlab_reports', 'Run curated memory analysis reports — like Chrome DevTools Memory panel views. Use "list" to see available reports, pick one by name, or use "full_analysis" to run all reports for a comprehensive triage.', {
+        report: z
+            .enum(['list', 'full_analysis', ...REPORT_NAMES])
+            .optional()
+            .default('list')
+            .describe('Which report to run: "list" shows available reports, "full_analysis" runs all, or pick one by name'),
+        limit: z
+            .number()
+            .optional()
+            .default(10)
+            .describe('Maximum items per report section (default 10)'),
+    }, async ({ report, limit }) => {
+        try {
+            if (report === 'list') {
+                return textResult(runList());
+            }
+            if (report === 'full_analysis') {
+                const sections = REPORTS.map(r => {
+                    try {
+                        return r.run(limit);
+                    }
+                    catch (err) {
+                        const msg = err instanceof Error ? err.message : String(err);
+                        return `## ${r.name}\n\nError: ${msg}`;
+                    }
+                });
+                return textResult(`# Full Memory Analysis\n\n${sections.join('\n\n---\n\n')}`);
+            }
+            // Individual report
+            const def = REPORTS.find(r => r.name === report);
+            if (!def) {
+                return textResult(`Unknown report "${report}". Use report: "list" to see available reports.`);
+            }
+            return textResult(def.run(limit));
+        }
+        catch (err) {
+            return errorResult(err);
+        }
+    });
+}
+//# sourceMappingURL=reports.js.map

package/dist/tools/reports.js.map

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

package/dist/tools/retainer-trace.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @format
+ * @oncall memory_lab
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerRetainerTrace(server: McpServer): void;
+//# sourceMappingURL=retainer-trace.d.ts.map

package/dist/tools/retainer-trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retainer-trace.d.ts","sourceRoot":"","sources":["../../src/tools/retainer-trace.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,yCAAyC,CAAC;AAMvE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAwE7D"}

package/dist/tools/retainer-trace.js

@@ -0,0 +1,68 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @format
+ * @oncall memory_lab
+ */
+import { z } from 'zod';
+import { getSnapshot } from '../heap-state.js';
+import { formatNodeInline, errorResult, textResult } from '../utils.js';
+export function registerRetainerTrace(server) {
+    server.tool('memlab_retainer_trace', 'Get the shortest path from a GC root to a specific heap node. This shows why the object is retained in memory by walking the pathEdge chain.', {
+        node_id: z.number().describe('The numeric ID of the heap node'),
+    }, async ({ node_id }) => {
+        try {
+            const snapshot = getSnapshot();
+            const node = snapshot.getNodeById(node_id);
+            if (!node) {
+                return errorResult(`Node with id ${node_id} not found`);
+            }
+            if (!node.hasPathEdge) {
+                return textResult('No retainer path available for this node. It may be a root node or unreachable.');
+            }
+            const visited = new Set([node.id]);
+            let curNode = node;
+            // Collect path from target to root
+            const reverseItems = [{ node: curNode }];
+            while (curNode && curNode.hasPathEdge) {
+                const edge = curNode.pathEdge;
+                if (!edge)
+                    break;
+                const fromNode = edge.fromNode;
+                if (visited.has(fromNode.id))
+                    break; // cycle detection
+                visited.add(fromNode.id);
+                reverseItems.push({
+                    node: fromNode,
+                    edgeName: String(edge.name_or_index),
+                    edgeType: edge.type,
+                });
+                curNode = fromNode;
+            }
+            // Reverse to get root-first order
+            reverseItems.reverse();
+            // Build visual chain
+            const parts = [];
+            for (let i = 0; i < reverseItems.length; i++) {
+                const item = reverseItems[i];
+                parts.push(formatNodeInline(item.node.id, item.node.name, item.node.type));
+                if (item.edgeName != null && i < reverseItems.length - 1) {
+                    parts.push(` --${item.edgeName}--> `);
+                }
+            }
+            const lines = [
+                `Retainer trace for @${node_id} (${reverseItems.length} nodes):`,
+                '',
+                parts.join(''),
+            ];
+            return textResult(lines.join('\n'));
+        }
+        catch (err) {
+            return errorResult(err);
+        }
+    });
+}
+//# sourceMappingURL=retainer-trace.js.map

package/dist/tools/retainer-trace.js.map

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

package/dist/tools/search-nodes.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @format
+ * @oncall memory_lab
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerSearchNodes(server: McpServer): void;
+//# sourceMappingURL=search-nodes.d.ts.map

package/dist/tools/search-nodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-nodes.d.ts","sourceRoot":"","sources":["../../src/tools/search-nodes.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,yCAAyC,CAAC;AAYvE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA0F3D"}