@memlab/mcp-server 2.18.1 → 2.86.0

package/dist/tools/census-diff.js

@@ -0,0 +1,228 @@
+/**
+ * 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 { armScanBudgetFor, resolveRungs, scaledTimeoutMs, withSnapshotAt, } from '../snapshot-borrow.js';
+import { abbreviateBlinkTypeName, errorResult, formatNumber, markdownTable, pathsHeader, toolResult, } from '../utils.js';
+import { extractElementTag, isDetachedDOMNode, isPinned, } from './detached-dom.js';
+/**
+ * A census is a per-CLASS population at one point in the ladder; a census DIFF
+ * is the same census taken at two points and compared row by row.
+ *
+ * This exists because the diff, not the totals, is the evidence. Two totals that
+ * match ("777 detached at both ends") are consistent with a leak that swapped
+ * one population for another of equal size, which is a real and observed shape.
+ * The per-class rows are what turn "no leak" from a guess into a finding — and
+ * the negative result is the common case, so the cheap version of it has to be
+ * one call rather than a hand-written thirty-line eval per round.
+ */
+const CALLBACK_PROPS = new Set(['callback', 'fn', 'handler', 'listener']);
+const CONTEXT_PROPS = new Set(['context', 'ctx', 'this', 'target']);
+function emptyCensus() {
+    return { counts: new Map(), total: 0 };
+}
+function bump(census, key) {
+    census.counts.set(key, (census.counts.get(key) ?? 0) + 1);
+    census.total += 1;
+}
+/**
+ * Detached DOM, bucketed by element tag.
+ *
+ * Only PINNED nodes are counted, matching `memlab_detached_dom`. Detached nodes
+ * with no retainer path are GC-eligible rather than leaked, and their count
+ * swings with whatever the collector happened to have done before the capture —
+ * including them makes every diff look noisy and hides the rows that moved.
+ */
+export function censusDetached(snapshot) {
+    const census = emptyCensus();
+    snapshot.nodes.forEach((node) => {
+        if (!isDetachedDOMNode(node) || !isPinned(node))
+            return;
+        bump(census, extractElementTag(node.name));
+    });
+    return census;
+}
+/**
+ * Listener records — objects carrying both a callback-ish and a context-ish
+ * property — bucketed by callback function name.
+ *
+ * Bucketing by CALLBACK rather than by host is deliberate. A listener leak shows
+ * up as the same handler registered N times; the host is usually a single
+ * long-lived emitter whose count never moves, so a host-keyed census reports
+ * "1 → 1" for exactly the leak it was run to find.
+ */
+export function censusListeners(snapshot) {
+    const census = emptyCensus();
+    snapshot.nodes.forEach((node) => {
+        if (node.type !== 'object' || node.id <= 3)
+            return;
+        let callbackName = null;
+        let hasContext = false;
+        for (const edge of node.references) {
+            const name = String(edge.name_or_index);
+            if (CALLBACK_PROPS.has(name) && edge.toNode.type === 'closure') {
+                callbackName =
+                    edge.toNode.name.length > 0 ? edge.toNode.name : '(anonymous)';
+            }
+            else if (CONTEXT_PROPS.has(name)) {
+                hasContext = true;
+            }
+        }
+        if (callbackName != null && hasContext) {
+            bump(census, callbackName);
+        }
+    });
+    return census;
+}
+const MAX_KEY_LEN = 60;
+/**
+ * Keep a census row readable without losing which row it is.
+ *
+ * Blink's C++ template names (`blink::BasicHeapVector<...>`) run to hundreds of
+ * characters and a table of them costs more tokens than the counts it exists to
+ * show — one census eval blew the result cap on exactly this. Elide the type
+ * arguments first, since the head of the name is the identifying part, and only
+ * hard-truncate if it is still too long.
+ */
+export function clampKey(key) {
+    const abbreviated = abbreviateBlinkTypeName(key);
+    return abbreviated.length > MAX_KEY_LEN
+        ? `${abbreviated.slice(0, MAX_KEY_LEN - 1)}\u2026`
+        : abbreviated;
+}
+export function diffCensus(baseline, target) {
+    const keys = new Set([...baseline.counts.keys(), ...target.counts.keys()]);
+    const rows = [];
+    for (const key of keys) {
+        const b = baseline.counts.get(key) ?? 0;
+        const t = target.counts.get(key) ?? 0;
+        rows.push({ key, baseline: b, target: t, delta: t - b });
+    }
+    // Largest movers first in both directions: a class that SHRANK by 200 is as
+    // informative as one that grew by 200, and sorting on the signed delta would
+    // bury it at the bottom.
+    rows.sort((a, b) => Math.abs(b.delta) - Math.abs(a.delta) || b.target - a.target);
+    return rows;
+}
+function renderKind(kind, baseline, target, topN) {
+    const rows = diffCensus(baseline, target);
+    const moved = rows.filter(r => r.delta !== 0);
+    const label = kind === 'detached' ? 'Detached DOM (pinned)' : 'Listener records';
+    const keyHeader = kind === 'detached' ? 'Element' : 'Callback';
+    const lines = [];
+    lines.push(`### ${label}`);
+    lines.push('');
+    lines.push(`Totals: **${formatNumber(baseline.total)} → ${formatNumber(target.total)}** ` +
+        `(Δ ${target.total - baseline.total >= 0 ? '+' : ''}${formatNumber(target.total - baseline.total)}) ` +
+        `across ${formatNumber(rows.length)} distinct ${kind === 'detached' ? 'element type(s)' : 'callback(s)'}.`);
+    lines.push('');
+    if (moved.length === 0) {
+        lines.push(`**IDENTICAL** — every one of the ${formatNumber(rows.length)} rows is unchanged. ` +
+            'This is the strong form of a negative result: not merely equal totals, but no ' +
+            'population swapped for another of the same size.');
+        return lines;
+    }
+    lines.push(markdownTable([keyHeader, 'Baseline', 'Target', 'Δ'], moved
+        .slice(0, topN)
+        .map(r => [
+        clampKey(r.key),
+        formatNumber(r.baseline),
+        formatNumber(r.target),
+        `${r.delta >= 0 ? '+' : ''}${formatNumber(r.delta)}`,
+    ]), new Set([1, 2, 3])));
+    if (moved.length > topN) {
+        lines.push('');
+        lines.push(`_… ${formatNumber(moved.length - topN)} further changed row(s) omitted; raise \`top_n\` to see them._`);
+    }
+    lines.push('');
+    lines.push(`${formatNumber(moved.length)} of ${formatNumber(rows.length)} rows changed; ` +
+        `${formatNumber(rows.length - moved.length)} identical.`);
+    return lines;
+}
+export function registerCensusDiff(server) {
+    server.tool('memlab_census_diff', 'Take the detached-DOM and listener-record census at TWO rungs and diff them per class / per callback in one call. ' +
+        'This is the mandated baseline-vs-final comparison: run the census on BOTH ends and compare the per-class distribution, not just the two totals.\n\n' +
+        'Two totals that match are NOT a negative result — they are also consistent with one population being swapped for another of the same size, which is a real observed shape. ' +
+        'The per-row diff is what makes the negative claim: "777 nodes across 66 classes, zero change on every one" is a finding; "777 at both ends" is a guess.\n\n' +
+        'Replaces the ~30-line eval that otherwise gets rewritten every round (build {class -> count} on each rung, diff the maps by hand), and loads one graph at a time so it works on a ladder of 250-540 MB captures.', {
+        baseline: z
+            .string()
+            .describe('Path to the EARLY rung. Local path, manifold:// URL, or bare filename.'),
+        target: z
+            .string()
+            .describe('Path to the LATE rung, compared against the baseline.'),
+        kinds: z
+            .array(z.enum(['detached', 'listeners']))
+            .optional()
+            .default(['detached', 'listeners'])
+            .describe('Which censuses to take. Both by default, which is what the protocol asks for.'),
+        top_n: z
+            .number()
+            .int()
+            .min(1)
+            .optional()
+            .default(25)
+            .describe('Maximum CHANGED rows to print per kind. Unchanged rows are counted, never listed.'),
+        max_file_size_mb: z
+            .number()
+            .optional()
+            .describe('Per-file size ceiling, matching memlab_load_snapshot.'),
+    }, async ({ baseline, target, kinds, top_n, max_file_size_mb }) => {
+        try {
+            const { rungs, largestMB } = resolveRungs([baseline, target], max_file_size_mb);
+            const [baseRung, targetRung] = rungs;
+            // Both censuses are full-heap walks, so they run against the same 90s
+            // scan guardrail every other tool does. Scale it from the largest
+            // capture or a big ladder loses a rung to the guardrail rather than to
+            // anything about the heap.
+            const scanBudgetMs = scaledTimeoutMs(largestMB);
+            const take = (snapshot) => {
+                const out = {
+                    detached: emptyCensus(),
+                    listeners: emptyCensus(),
+                };
+                // One pass per kind, but only for the kinds asked for: the listener
+                // walk visits every object's edges and is the expensive half.
+                if (kinds.includes('detached'))
+                    out.detached = censusDetached(snapshot);
+                if (kinds.includes('listeners'))
+                    out.listeners = censusListeners(snapshot);
+                return out;
+            };
+            armScanBudgetFor(scanBudgetMs);
+            const baseCensus = await withSnapshotAt(baseRung.localPath, take);
+            armScanBudgetFor(scanBudgetMs);
+            const targetCensus = await withSnapshotAt(targetRung.localPath, take);
+            const lines = [];
+            lines.push('## Census diff');
+            lines.push('');
+            lines.push(`- baseline: \`${baseRung.label}\``);
+            lines.push(`- target: \`${targetRung.label}\``);
+            lines.push('');
+            let anyMoved = false;
+            for (const kind of kinds) {
+                const rows = diffCensus(baseCensus[kind], targetCensus[kind]);
+                if (rows.some(r => r.delta !== 0))
+                    anyMoved = true;
+                lines.push(...renderKind(kind, baseCensus[kind], targetCensus[kind], top_n));
+                lines.push('');
+            }
+            lines.push(anyMoved
+                ? '_A changed row is a population, not yet a leak. Trace a sample with `memlab_retainer_trace` and check ' +
+                    '`memlab_dev_artifacts` before attributing it — React DEV and Fast Refresh populations grow across a ladder too._'
+                : '_Nothing moved in either census. Record this: an unchanged per-class distribution across the ladder is the ' +
+                    'strongest cheap evidence that a suspected leak is not in the DOM or listener population at all._');
+            return toolResult(lines.join('\n'), pathsHeader(rungs.map(r => r.label)));
+        }
+        catch (e) {
+            return errorResult(e instanceof Error ? e : new Error(String(e)));
+        }
+    });
+}
+//# sourceMappingURL=census-diff.js.map

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

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

package/dist/tools/chain-walk.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 registerChainWalk(server: McpServer): void;
+//# sourceMappingURL=chain-walk.d.ts.map

package/dist/tools/chain-walk.d.ts.map

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

package/dist/tools/chain-walk.js

@@ -0,0 +1,184 @@
+/**
+ * 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 { toolResult, formatBytes, formatNumber } from '../utils.js';
+export function registerChainWalk(server) {
+    server.tool('memlab_chain_walk', 'Walk a repeated linked structure from a starting node and report how deep it goes and what it holds — for closure chains (`begin` -> `context` -> `.prev` -> ...), React update queues (`.next`), LRU lists (`.next`/`.prev`), and range/interval trees (`.l`/`.r`). ' +
+        'Exists because these get hand-written as evals, and the hand-written version reliably miscounts: it counts how many TIMES an object is captured rather than how many DISTINCT objects are captured, so a chain that pins the same element at several links reads as that many separate leaks. Measured case: a hand-rolled walk reported 6 distinct detached elements for a 6-link chain that pinned 2. ' +
+        'This returns distinct sets by construction and reports the occurrence count alongside only when the two differ. Cycles are detected and reported rather than walked forever. ' +
+        'Use it after a retainer trace shows the same edge name repeating — that repetition is the signal that a chain, not a single object, is the finding.', {
+        start_id: z
+            .number()
+            .describe('Node id to start from (the object holding the chain head).'),
+        head_edge: z
+            .string()
+            .optional()
+            .describe('Optional edge to step through first, from `start_id` to the first link (e.g. "begin"). Omit if `start_id` IS the first link.'),
+        next_edges: z
+            .array(z.string())
+            .min(1)
+            .describe('Edge name(s) that advance one link. One name walks a list ("next", "prev", "p"); several walk a tree ("l", "r"), in which case every branch is followed and `depth` is the maximum depth reached.'),
+        capture_edges: z
+            .array(z.string())
+            .optional()
+            .default([])
+            .describe('Edges to record at each link — what the chain is holding onto. Omit to record every named property of each link, which is the right default when you do not yet know what it captures.'),
+        max_links: z
+            .number()
+            .optional()
+            .default(10000)
+            .describe('Safety bound on links visited (default 10000). A chain longer than this is itself the finding; the result says it was truncated.'),
+        show_links: z
+            .number()
+            .optional()
+            .default(3)
+            .describe('How many individual links to detail (default 3).'),
+    }, async ({ start_id, head_edge, next_edges, capture_edges, max_links, show_links, }) => {
+        const snapshot = getSnapshot();
+        if (!snapshot) {
+            return toolResult('Error: No heap snapshot loaded. Use memlab_load_snapshot first.');
+        }
+        const start = snapshot.getNodeById(start_id);
+        if (!start) {
+            return toolResult(`Error: node @${start_id} not found.`);
+        }
+        const edgeTarget = (node, name) => {
+            for (const e of node.references) {
+                if (String(e.name_or_index) === name)
+                    return e.toNode;
+            }
+            return null;
+        };
+        let head = start;
+        if (head_edge != null && head_edge !== '') {
+            head = edgeTarget(start, head_edge);
+            if (!head) {
+                return toolResult(`Error: @${start_id} has no edge \`${head_edge}\`. Check the edge name with memlab_object_shape({node_id: ${start_id}}).`);
+            }
+        }
+        const seen = new Set();
+        const links = [];
+        // Distinct captured objects across the WHOLE chain — the number that is
+        // usually wanted and usually got wrong.
+        const distinctCaptured = new Map();
+        let occurrences = 0;
+        let cyclic = false;
+        let truncated = false;
+        let maxDepth = 0;
+        const stack = [
+            { node: head, depth: 1 },
+        ];
+        while (stack.length > 0) {
+            const entry = stack.pop();
+            if (!entry)
+                break;
+            const { node, depth } = entry;
+            if (seen.has(node.id)) {
+                cyclic = true;
+                continue;
+            }
+            if (seen.size >= max_links) {
+                truncated = true;
+                break;
+            }
+            seen.add(node.id);
+            maxDepth = Math.max(maxDepth, depth);
+            const captured = [];
+            for (const e of node.references) {
+                const edgeName = String(e.name_or_index);
+                if (next_edges.includes(edgeName))
+                    continue;
+                const wanted = capture_edges.length > 0
+                    ? capture_edges.includes(edgeName)
+                    : e.type === 'property' || e.type === 'context';
+                if (!wanted)
+                    continue;
+                const t = e.toNode;
+                captured.push({
+                    edge: edgeName,
+                    id: t.id,
+                    name: t.name,
+                    detached: Boolean(t.is_detached),
+                });
+                occurrences++;
+                const prev = distinctCaptured.get(t.id);
+                if (prev) {
+                    prev.occurrences++;
+                }
+                else {
+                    distinctCaptured.set(t.id, {
+                        name: t.name,
+                        detached: Boolean(t.is_detached),
+                        occurrences: 1,
+                    });
+                }
+            }
+            if (links.length < show_links) {
+                links.push({
+                    depth,
+                    nodeId: node.id,
+                    name: node.name,
+                    retained: node.retainedSize,
+                    captured: captured.slice(0, 8),
+                });
+            }
+            for (const edgeName of next_edges) {
+                const nxt = edgeTarget(node, edgeName);
+                if (nxt)
+                    stack.push({ node: nxt, depth: depth + 1 });
+            }
+        }
+        const detachedDistinct = [...distinctCaptured.values()].filter(c => c.detached).length;
+        const out = [
+            `## Chain from @${start_id}${head_edge ? ` via \`.${head_edge}\`` : ''}`,
+            '',
+            `- **Links walked: ${formatNumber(seen.size)}** (max depth ${formatNumber(maxDepth)})`,
+            `- Distinct objects captured: **${formatNumber(distinctCaptured.size)}**` +
+                (occurrences !== distinctCaptured.size
+                    ? ` — from ${formatNumber(occurrences)} capture occurrences, so the same object is held at several links. Quote the DISTINCT count; the occurrence count is what a hand-written walk reports by mistake.`
+                    : ''),
+            `- Distinct captured objects that are detached DOM: **${formatNumber(detachedDistinct)}**`,
+        ];
+        if (cyclic) {
+            out.push('- ⚠ The chain revisits a node it already walked: it is cyclic, not a list. Depth is the number of distinct links, not a loop count.');
+        }
+        if (truncated) {
+            out.push(`- ⚠ Stopped at the ${formatNumber(max_links)}-link bound; the real chain is longer. That length is itself the finding.`);
+        }
+        if (seen.size === 1) {
+            out.push('', `> Only one link: nothing advanced through ${next_edges.map(e => `\`${e}\``).join(' / ')}. Either this is not a chain, or the advancing edge has a different name — check with memlab_object_shape({node_id: ${start_id}}).`);
+        }
+        if (links.length > 0) {
+            out.push('', '### First links', '');
+            for (const l of links) {
+                out.push(`**Link ${l.depth}** — @${l.nodeId} \`${l.name}\` (${formatBytes(l.retained)} retained)`);
+                if (l.captured.length === 0) {
+                    out.push('  - captures nothing named');
+                }
+                for (const c of l.captured) {
+                    out.push(`  - \`${c.edge}\` → @${c.id} ${c.name}${c.detached ? ' **[DETACHED]**' : ''}`);
+                }
+            }
+        }
+        const top = [...distinctCaptured.entries()]
+            .sort((a, b) => b[1].occurrences - a[1].occurrences)
+            .slice(0, 8);
+        if (top.length > 0) {
+            out.push('', '### Distinct captured objects (most-held first)', '');
+            for (const [nodeId, info] of top) {
+                out.push(`- @${nodeId} \`${info.name}\`${info.detached ? ' **[DETACHED]**' : ''} — held at ${formatNumber(info.occurrences)} link(s)`);
+            }
+        }
+        out.push('', "_Depth alone is not a leak: a bounded structure has a depth too. What makes a chain a finding is that it grows per interaction and nothing removes links — check that with `memlab_ladder_probe` over a ladder, using this tool's link count as the metric._");
+        return toolResult(out.join('\n'));
+    });
+}
+//# sourceMappingURL=chain-walk.js.map

package/dist/tools/chain-walk.js.map

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

package/dist/tools/class-histogram.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"class-histogram.d.ts","sourceRoot":"","sources":["../../src/tools/class-histogram.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,yCAAyC,CAAC;AAkBvE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAgU9D"}
+{"version":3,"file":"class-histogram.d.ts","sourceRoot":"","sources":["../../src/tools/class-histogram.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,yCAAyC,CAAC;AAmBvE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA4U9D"}

package/dist/tools/class-histogram.js

@@ -12,7 +12,7 @@ import memlabCore from '@memlab/core';
 const { NumericSet } = memlabCore;
 import { getSnapshot, getSnapshotMetadata } from '../heap-state.js';
 import { checkAnalysisDeadline } from '../analysis-budget.js';
-import { errorResult, toolResult, formatBytes, formatNumber, markdownTable, truncateNodeName, suggestionsSuppressed, boundedDominatorRetainedSize, } from '../utils.js';
+import { errorResult, toolResult, formatBytes, formatNumber, markdownTable, truncateNodeName, suggestionsSuppressed, boundedDominatorRetainedSize, makeNamePatternTest, } from '../utils.js';
 export function registerClassHistogram(server) {
     server.tool('memlab_class_histogram', 'Show per-constructor/class instance count and total self size. Useful for identifying which types of objects dominate memory. ' +
         'By DEFAULT (`include_retained_size:false`) it returns a counts + self-size histogram in a single O(N) pass with NO dominator walk — fast and safe on snapshots with millions of nodes; rows are sorted by self size. ' +
@@ -36,6 +36,10 @@ export function registerClassHistogram(server) {
             .number()
             .optional()
             .describe('Minimum total self size in bytes to include.'),
+        name_pattern: z
+            .string()
+            .optional()
+            .describe('Filter class names by pattern before aggregating — a case-insensitive regular expression, or a plain substring when the pattern is not valid regex (e.g. "blink::UndoStep", "Detached", "^WA"). Answering "is class X present?" this way costs one row instead of a whole table.'),
         node_type: z
             .string()
             .optional()
@@ -60,9 +64,12 @@ export function registerClassHistogram(server) {
             .optional()
             .default(false)
             .describe('Omit "Suggested next steps" boilerplate from the output to save tokens.'),
-    }, async ({ limit, min_count, min_retained_size, min_self_size, node_type, include_retained_size, max_retained_classes, max_dominator_walk, suppress_suggestions, }) => {
+    }, async ({ limit, min_count, min_retained_size, min_self_size, name_pattern, node_type, include_retained_size, max_retained_classes, max_dominator_walk, suppress_suggestions, }) => {
         try {
-            const snapshot = getSnapshot();
+            // Light-safe only without retained sizes: the retained path walks the
+            // dominator tree, which a light load never built.
+            const snapshot = getSnapshot({ allowLight: !include_retained_size });
+            const nameMatches = makeNamePatternTest(name_pattern);
             const meta = getSnapshotMetadata();
             // Flat strings and numbers are leaf nodes: they dominate nothing but
             // themselves, so instances never overlap on the dominator tree and a
@@ -79,6 +86,8 @@ export function registerClassHistogram(server) {
             snapshot.nodes.forEach(node => {
                 if (node_type && node.type !== node_type)
                     return;
+                if (!nameMatches(node.name))
+                    return;
                 // Skip internal meta nodes
                 if (node.id <= 3)
                     return;
@@ -134,6 +143,8 @@ export function registerClassHistogram(server) {
                     idsByClass.set(key, new NumericSet());
                 if (idsByClass.size > 0) {
                     snapshot.nodes.forEach(node => {
+                        if (!nameMatches(node.name))
+                            return;
                         if (node.id <= 3)
                             return;
                         if (node_type && node.type !== node_type)

package/dist/tools/class-histogram.js.map

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

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

@@ -0,0 +1,44 @@
+/**
+ * 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 { IHeapNode, IHeapSnapshot } from '@memlab/core';
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * A per-capture-stable name for one collection, in the SAME `<Owner>.<property>`
+ * form `memlab_collection_trend` takes as a locator.
+ *
+ * That shared shape is the point of this tool: discovery hands you a locator you
+ * can paste straight into the trend tool to confirm and to track a fix, instead
+ * of a node id that means nothing in the next capture.
+ *
+ * Node ids, array indices and V8 scope numbers are all per-capture, so none of
+ * them can appear in the signature. The walk climbs referrers (not the dominator
+ * tree — this runs on a LIGHT parse with no dominators) until it finds a class
+ * name worth printing, and falls back to `<context>` for a module-scope closure
+ * binding, which is where most module singletons live.
+ */
+export declare function collectionSignature(node: IHeapNode): string | null;
+export interface CollectionStat {
+    instances: number;
+    entries: number;
+    maxEntries: number;
+    kinds: Set<string>;
+}
+/**
+ * Census every JS collection in one snapshot, keyed by signature.
+ *
+ * Deliberately does NOT filter by size. The whole point is to catch the
+ * collection that is small now and unbounded later: one of the three
+ * never-drained telemetry stores this tool was written for held 2 entries at the
+ * baseline rung and 1,260 at the last one, so any size floor would have hidden
+ * it. Growth is the filter, and growth needs the ladder.
+ */
+export declare function censusCollections(snapshot: IHeapSnapshot): Map<string, CollectionStat>;
+export declare function registerCollectionDiff(server: McpServer): void;
+//# sourceMappingURL=collection-diff.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"collection-diff.d.ts","sourceRoot":"","sources":["../../src/tools/collection-diff.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAY,SAAS,EAAE,aAAa,EAAC,MAAM,cAAc,CAAC;AACtE,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,yCAAyC,CAAC;AA6DvE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,CAsDlE;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,aAAa,GACtB,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAoB7B;AAkDD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA2K9D"}