@memlab/mcp-server 2.1.1 → 2.3.0

package/dist/tools/eval.js

@@ -119,7 +119,8 @@ export function registerEval(server) {
         '`.toNode`, `.fromNode`.\n' +
         '**Iterating all nodes:** `snapshot.nodes.forEach(node => { ... })` — NOT for-of.\n' +
         '**Get node by ID:** `snapshot.getNodeById(id)` returns IHeapNode or null.\n' +
-        '**String values:** `node.toStringNode()?.stringValue` for string nodes.\n\n' +
+        '**String values:** `node.toStringNode()?.stringValue` for string nodes.\n' +
+        '**Caveat — retained_size is unreliable here:** inside eval, `node.retained_size`/`.retainedSize` can read back ~0 for every node on some loads. Node counts, property/edge walks, and string values ARE trustworthy. For authoritative retained sizes call `helpers.retainedSize(id)` / `helpers.retainedSizes([ids])` (they re-resolve the node on the real snapshot), or use the dedicated tools (`memlab_largest_objects`, `memlab_class_histogram`, `memlab_pinch_points`, `memlab_object_shape`).\n\n' +
         '**Example — inspect Map entries:**\n' +
         '```\nconst map = snapshot.getNodeById(12345);\nconst entries = [];\n' +
         'for (const edge of map.references) {\n' +
@@ -127,23 +128,38 @@ export function registerEval(server) {
         '    for (const te of edge.toNode.references) {\n' +
         '      entries.push({name: te.toNode.name, type: te.toNode.type});\n' +
         '    }\n  }\n}\nresult = entries.slice(0, 10);\n```', {
+        mode: z
+            .enum(['eval', 'describe_env'])
+            .optional()
+            .default('eval')
+            .describe('"eval" (default) runs `code`. "describe_env" ignores `code` and returns the in-scope globals, the IHeapNode/IHeapEdge API, and the required calling conventions (`result =`, `.forEach`) so you can self-correct before running.'),
         code: z
             .string()
+            .optional()
             .describe('JavaScript code to execute. Must assign the output to a `result` variable. ' +
             'Available globals: snapshot (IHeapSnapshot — use .nodes.forEach(), .getNodeById(), .edges.forEach()), ' +
             'utils (@memlab/core utils with aggregateDominatorMetrics, isFiberNode, isDetachedDOMNode), ' +
             'helpers ({ serializeNodeSummary, serializeNodeDetail, formatBytes, formatNumber, ' +
-            'markdownTable, isNodeWorthInspecting, filterLargestObjects, queryNodes }), ' +
+            'markdownTable, isNodeWorthInspecting, filterLargestObjects, queryNodes, ' +
+            'groupReferrersByEdge(nodeId), groupArrayElementsByProperty(arrayNodeId, propName), ' +
+            'isOrphaned(nodeId, ownershipEdgeNames[]), countUniqueTargets(arrayNodeId, propName), ' +
+            'retainedSize(id), retainedSizes(ids[]) }), ' +
             'and standard JS built-ins. ' +
             'Node traversal: use node.references (outgoing) and node.referrers (incoming) with for-of. ' +
             'Edge properties: .name_or_index, .type, .toNode, .fromNode.'),
         timeout_ms: z
             .number()
             .optional()
-            .default(30000)
-            .describe('Execution timeout in milliseconds (default 30000)'),
-    }, async ({ code, timeout_ms }) => {
+            .default(60000)
+            .describe('Execution timeout in milliseconds (default 60000). Full-snapshot scans on large heaps may need 120000+.'),
+    }, async ({ mode, code, timeout_ms }) => {
         try {
+            if (mode === 'describe_env') {
+                return toolResult(describeEnv());
+            }
+            if (code == null || code.trim() === '') {
+                return errorResult(new Error('No code provided. Pass `code`, or use mode:"describe_env" to see the available globals and conventions.'));
+            }
             const snapshot = getSnapshot();
             const consoleOutput = [];
             const capturedConsole = {
@@ -152,6 +168,107 @@ export function registerEval(server) {
                 error: (...args) => consoleOutput.push('[error] ' + args.map(String).join(' ')),
                 info: (...args) => consoleOutput.push('[info] ' + args.map(String).join(' ')),
             };
+            const groupReferrersByEdge = (nodeId) => {
+                const target = snapshot.getNodeById(nodeId);
+                if (!target)
+                    return {};
+                const groups = {};
+                for (const edge of target.referrers) {
+                    const eName = String(edge.name_or_index);
+                    const from = edge.fromNode;
+                    if (!groups[eName])
+                        groups[eName] = [];
+                    if (groups[eName].length < 10) {
+                        groups[eName].push({
+                            fromName: from.name,
+                            fromType: from.type,
+                            fromId: from.id,
+                        });
+                    }
+                }
+                return groups;
+            };
+            const groupArrayElementsByProperty = (arrayNodeId, propertyName) => {
+                const arrNode = snapshot.getNodeById(arrayNodeId);
+                if (!arrNode)
+                    return { error: 'Node not found' };
+                const groups = {};
+                let missing = 0;
+                let total = 0;
+                for (const edge of arrNode.references) {
+                    if (edge.type !== 'element')
+                        continue;
+                    const elem = edge.toNode;
+                    if (elem.id <= 3)
+                        continue;
+                    total++;
+                    let found = false;
+                    for (const propEdge of elem.references) {
+                        if (String(propEdge.name_or_index) === propertyName) {
+                            const target = propEdge.toNode;
+                            const key = target.name;
+                            if (!groups[key])
+                                groups[key] = { count: 0, exampleId: target.id };
+                            groups[key].count++;
+                            found = true;
+                            break;
+                        }
+                    }
+                    if (!found)
+                        missing++;
+                }
+                return { groups, total, missing };
+            };
+            const isOrphaned = (nodeId, ownershipEdgeNames) => {
+                const target = snapshot.getNodeById(nodeId);
+                if (!target)
+                    return false;
+                const ownerSet = new Set(ownershipEdgeNames);
+                for (const edge of target.referrers) {
+                    if (ownerSet.has(String(edge.name_or_index)))
+                        return false;
+                }
+                return true;
+            };
+            // Authoritative retained sizes (Feedback round 3 §3b). Reading
+            // `.retainedSize` off proxied/iterated nodes inside eval can come back
+            // ~0; these helpers look the node up fresh on the real snapshot (the
+            // same path the dedicated tools use) so custom analyses can rank by
+            // retained size.
+            const retainedSize = (id) => {
+                const n = snapshot.getNodeById(id);
+                return n ? n.retainedSize : 0;
+            };
+            const retainedSizes = (ids) => {
+                const out = {};
+                for (const id of ids) {
+                    const n = snapshot.getNodeById(id);
+                    out[id] = n ? n.retainedSize : 0;
+                }
+                return out;
+            };
+            const countUniqueTargets = (arrayNodeId, propertyName) => {
+                const arrNode = snapshot.getNodeById(arrayNodeId);
+                if (!arrNode)
+                    return { error: 'Node not found' };
+                const uniqueIds = new Set();
+                let total = 0;
+                for (const edge of arrNode.references) {
+                    if (edge.type !== 'element')
+                        continue;
+                    const elem = edge.toNode;
+                    if (elem.id <= 3)
+                        continue;
+                    total++;
+                    for (const propEdge of elem.references) {
+                        if (String(propEdge.name_or_index) === propertyName) {
+                            uniqueIds.add(propEdge.toNode.id);
+                            break;
+                        }
+                    }
+                }
+                return { uniqueCount: uniqueIds.size, totalElements: total };
+            };
             const helpers = {
                 serializeNodeSummary,
                 serializeNodeDetail,
@@ -161,6 +278,12 @@ export function registerEval(server) {
                 isNodeWorthInspecting,
                 filterLargestObjects,
                 queryNodes,
+                groupReferrersByEdge,
+                groupArrayElementsByProperty,
+                isOrphaned,
+                countUniqueTargets,
+                retainedSize,
+                retainedSizes,
             };
             const sandbox = {
                 snapshot: wrapSnapshot(snapshot),
@@ -197,6 +320,15 @@ export function registerEval(server) {
             const context = vm.createContext(sandbox);
             const script = new vm.Script(code, { filename: 'memlab_eval' });
             script.runInContext(context, { timeout: timeout_ms });
+            // Actionable hint when nothing was assigned to `result` (the #1 user
+            // error — code that `return`s a value or runs a value-returning IIFE
+            // never populates `result`, so output is silently "undefined").
+            if (sandbox.result === undefined && consoleOutput.length === 0) {
+                return toolResult('Your code ran without error but never assigned to `result`, so there is nothing to return.\n' +
+                    'Assign the value you want back to `result` (do NOT use `return` at the top level), e.g.:\n' +
+                    '  `result = someValue;`\n' +
+                    'Use mode:"describe_env" to see the full calling convention.');
+            }
             let output;
             try {
                 output = JSON.stringify(sandbox.result, null, 2) ?? 'undefined';
@@ -212,12 +344,59 @@ export function registerEval(server) {
             return toolResult(output);
         }
         catch (err) {
-            if (err instanceof Error &&
-                err.message.includes('Script execution timed out')) {
-                return errorResult(new Error(`Execution timed out after ${timeout_ms}ms`));
-            }
-            return errorResult(err);
+            return errorResult(new Error(actionableEvalError(err, code)));
         }
     });
 }
+// Map the opaque VM errors that the documented calling-convention mistakes
+// produce into actionable guidance (Feedback §3).
+function actionableEvalError(err, code) {
+    const msg = err instanceof Error ? err.message : String(err);
+    if (msg.includes('Script execution timed out')) {
+        return `Execution timed out. Increase timeout_ms, or narrow the scan (filter earlier, use a dedicated tool like memlab_find_by_property/memlab_property_distribution instead of a full snapshot.nodes walk).`;
+    }
+    if (msg.includes('Illegal return statement')) {
+        return `Illegal return statement: you cannot \`return\` at the top level here. Assign the value to \`result\` instead — e.g. \`result = ...;\`. (Use mode:"describe_env" for the convention.)`;
+    }
+    if (msg.includes('is not iterable')) {
+        return `${msg}\nHint: \`snapshot.nodes\` is not a for-of iterable. Use \`snapshot.nodes.forEach(node => { ... })\` (and \`snapshot.edges.forEach(...)\`). \`node.references\`/\`node.referrers\` ARE for-of iterable.`;
+    }
+    if (code &&
+        /\bfor\s*\(\s*(const|let|var)\b.*\bof\b.*\bsnapshot\.nodes\b/.test(code)) {
+        return `${msg}\nHint: iterate all nodes with \`snapshot.nodes.forEach(node => { ... })\`, not \`for...of\`.`;
+    }
+    return msg;
+}
+function describeEnv() {
+    return [
+        '# memlab_eval environment',
+        '',
+        '## Calling conventions (REQUIRED)',
+        '- Assign your output to `result` — do NOT use `return` at the top level (that throws "Illegal return statement").',
+        '- Iterate all nodes with `snapshot.nodes.forEach(node => { ... })` and all edges with `snapshot.edges.forEach(...)`. `snapshot.nodes` is NOT a for-of iterable.',
+        '- `node.references` (outgoing) and `node.referrers` (incoming) ARE for-of iterable.',
+        '',
+        '## In-scope globals',
+        '- `snapshot` — IHeapSnapshot: `.nodes.forEach(cb)`, `.edges.forEach(cb)`, `.getNodeById(id)`.',
+        '- `utils` — @memlab/core utils (e.g. `aggregateDominatorMetrics`, `isFiberNode`, `isDetachedDOMNode`).',
+        '- `helpers` — `serializeNodeSummary`, `serializeNodeDetail`, `formatBytes`, `formatNumber`, `markdownTable`, `isNodeWorthInspecting`, `filterLargestObjects`, `queryNodes`, `groupReferrersByEdge(nodeId)`, `groupArrayElementsByProperty(arrayNodeId, prop)`, `isOrphaned(nodeId, ownerEdges[])`, `countUniqueTargets(arrayNodeId, prop)`, `retainedSize(id)`, `retainedSizes(ids[])`.',
+        '- Standard JS built-ins (Array, Object, Map, Set, JSON, Math, RegExp, …). No require/process/fs/network.',
+        '',
+        '## IHeapNode API',
+        '`.id`, `.name`, `.type`, `.self_size`, `.retainedSize` (alias `.retained_size`), `.edge_count`, `.is_detached`, `.numOfReferrers` (alias `.referrer_count`), `.isString`, `.toStringNode()?.stringValue`, `.hasPathEdge`, `.pathEdge`, `.dominatorNode`, `.location` (`script_id`/`line`/`column`).',
+        '',
+        '## Caveat: retained_size',
+        'Inside eval, `.retainedSize`/`.retained_size` can read back ~0 for every node on some loads. Counts, property/edge walks, and string values are reliable. For authoritative retained sizes call `helpers.retainedSize(id)` or `helpers.retainedSizes([ids])` (they re-resolve the node on the real snapshot, so you can rank custom analyses by retained size), or use `memlab_largest_objects`, `memlab_class_histogram`, `memlab_pinch_points`, or `memlab_object_shape`.',
+        '',
+        '## IHeapEdge API',
+        '`.name_or_index`, `.type` (property/element/context/internal/hidden/shortcut), `.toNode`, `.fromNode`.',
+        '',
+        '## Runnable example',
+        '```',
+        'const counts = {};',
+        'snapshot.nodes.forEach(node => { counts[node.type] = (counts[node.type] || 0) + 1; });',
+        'result = counts;',
+        '```',
+    ].join('\n');
+}
 //# sourceMappingURL=eval.js.map

package/dist/tools/eval.js.map

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

package/dist/tools/event-listener-leaks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"event-listener-leaks.d.ts","sourceRoot":"","sources":["../../src/tools/event-listener-leaks.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,yCAAyC,CAAC;AA0JvE,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA2LlE"}
+{"version":3,"file":"event-listener-leaks.d.ts","sourceRoot":"","sources":["../../src/tools/event-listener-leaks.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,yCAAyC,CAAC;AA+NvE,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAkZlE"}

package/dist/tools/event-listener-leaks.js

@@ -102,14 +102,63 @@ function countZombies(listeners, snapshot) {
     }
     return zombies;
 }
+function analyzeContextDistribution(listeners, snapshot) {
+    const callbackIds = new Set();
+    const contextIds = new Set();
+    const contextShapeMap = new Map();
+    let orphanedCount = 0;
+    for (const l of listeners) {
+        callbackIds.add(l.callbackId);
+        if (l.contextId != null) {
+            contextIds.add(l.contextId);
+            const ctxNode = snapshot.getNodeById(l.contextId);
+            if (ctxNode) {
+                const shapeName = ctxNode.name;
+                const existing = contextShapeMap.get(shapeName);
+                if (existing) {
+                    existing.count++;
+                }
+                else {
+                    contextShapeMap.set(shapeName, { count: 1, exampleId: ctxNode.id });
+                }
+                if (ctxNode.numOfReferrers <= 2) {
+                    orphanedCount++;
+                }
+            }
+        }
+    }
+    const contextShapes = [...contextShapeMap.entries()]
+        .map(([shapeName, info]) => ({
+        shapeName,
+        count: info.count,
+        exampleId: info.exampleId,
+    }))
+        .sort((a, b) => b.count - a.count)
+        .slice(0, 10);
+    return {
+        uniqueCallbacks: callbackIds.size,
+        uniqueContexts: contextIds.size,
+        totalListeners: listeners.length,
+        contextShapes,
+        orphanedContextCount: orphanedCount,
+    };
+}
+// A duplicate is the SAME callback function instance bound to the SAME context
+// instance, registered more than once. We key by node ids (callbackId +
+// contextId), NOT by name/shape — keying by name counted distinct closures that
+// merely share a name across different hosts as "duplicates", which produced
+// wildly inflated counts (e.g. 99.95%) on per-model registries that are really
+// structural, one-listener-per-model (Feedback §8).
 function countDuplicateCallbacks(listeners) {
-    const callbackContextPairs = new Map();
+    const pairs = new Map();
     for (const l of listeners) {
-        const key = `${l.callbackName}\0${l.contextName ?? ''}`;
-        callbackContextPairs.set(key, (callbackContextPairs.get(key) ?? 0) + 1);
+        if (l.callbackId <= 0)
+            continue;
+        const key = `${l.callbackId}\0${l.contextId ?? 0}`;
+        pairs.set(key, (pairs.get(key) ?? 0) + 1);
     }
     let duplicates = 0;
-    for (const count of callbackContextPairs.values()) {
+    for (const count of pairs.values()) {
         if (count > 1)
             duplicates += count - 1;
     }
@@ -117,11 +166,14 @@ function countDuplicateCallbacks(listeners) {
 }
 export function registerEventListenerLeaks(server) {
     server.tool('memlab_event_listener_leaks', 'Detect EventEmitter-style listener accumulation — the #1 cause of memory leaks in ' +
-        'Backbone/Node.js/EventEmitter-based apps. Scans for objects with _events/_listeners ' +
-        'properties and flags: arrays with >N entries (accumulation), entries where the ' +
-        'context/ctx object has no other referrers (zombie listeners from missed .off() calls), ' +
-        'and multiple entries with the same callback but different contexts (mount/unmount leaks). ' +
-        'Use after memlab_auto_investigate flags subscription accumulation.', {
+        'event-driven apps. Scans for: (1) objects with _events/_listeners properties (Backbone/Node.js), ' +
+        'and (2) accumulations of {callback, context}-shaped objects (custom event systems like ' +
+        'WAWebEventEmitter, Signal, etc.). Detects arrays with >N entries (accumulation), entries ' +
+        'where the context/ctx object has no other referrers (zombie listeners), and multiple entries ' +
+        'with the same callback (mount/unmount leaks). ' +
+        'Use extra_event_properties to detect app-specific event container property names ' +
+        '(e.g., "#eventMap" for private class fields). ' +
+        '⚠ Full-heap scan — slow on very large heaps (millions of nodes).', {
         min_listeners: z
             .number()
             .optional()
@@ -137,10 +189,35 @@ export function registerEventListenerLeaks(server) {
             .optional()
             .default(true)
             .describe('Check for zombie listeners whose context objects have no other referrers (default true). Can be slow on very large snapshots.'),
-    }, async ({ min_listeners, limit, check_zombies }) => {
+        extra_event_properties: z
+            .array(z.string())
+            .optional()
+            .describe('Additional property names to scan as event containers (e.g., ["#eventMap", "#listeningTo"] for private class fields). ' +
+            'These are checked in addition to the built-in patterns (_events, _listeners, eventMap, etc.).'),
+        detect_shapes: z
+            .boolean()
+            .optional()
+            .default(true)
+            .describe('Also detect accumulations of {callback, context}-shaped objects regardless of parent property naming (default true). ' +
+            "Catches custom event systems that don't use standard _events/_listeners patterns."),
+        analyze_contexts: z
+            .boolean()
+            .optional()
+            .default(true)
+            .describe('For each accumulation, analyze the distribution of unique callbacks vs contexts, ' +
+            'group context objects by shape/class, and detect orphaned contexts (default true). ' +
+            'This is the key signal for identifying listener-based memory leaks where many ' +
+            'orphaned objects register on the same event.'),
+    }, async ({ min_listeners, limit, check_zombies, extra_event_properties, detect_shapes, analyze_contexts, }) => {
         try {
             const snapshot = getSnapshot();
             const accumulations = [];
+            const effectiveEventProps = new Set(EVENT_PROPERTY_NAMES);
+            if (extra_event_properties) {
+                for (const p of extra_event_properties) {
+                    effectiveEventProps.add(p);
+                }
+            }
             snapshot.nodes.forEach(node => {
                 if (node.id <= 3)
                     return;
@@ -148,7 +225,7 @@ export function registerEventListenerLeaks(server) {
                     return;
                 for (const edge of node.references) {
                     const eName = String(edge.name_or_index);
-                    if (!EVENT_PROPERTY_NAMES.has(eName))
+                    if (!effectiveEventProps.has(eName))
                         continue;
                     if (edge.toNode.id <= 3)
                         continue;
@@ -161,6 +238,9 @@ export function registerEventListenerLeaks(server) {
                         ? countZombies(allListeners, snapshot)
                         : 0;
                     const duplicateCallbackCount = countDuplicateCallbacks(allListeners);
+                    const contextDist = analyze_contexts
+                        ? analyzeContextDistribution(allListeners, snapshot)
+                        : undefined;
                     const entry = {
                         hostNodeId: node.id,
                         hostName: node.name,
@@ -179,6 +259,7 @@ export function registerEventListenerLeaks(server) {
                         zombieCount,
                         duplicateCallbackCount,
                         totalRetainedSize: node.retainedSize,
+                        contextDistribution: contextDist,
                     };
                     let inserted = false;
                     for (let i = 0; i < accumulations.length; i++) {
@@ -195,14 +276,129 @@ export function registerEventListenerLeaks(server) {
                     break;
                 }
             });
+            // Shape-based detection: find accumulations of {callback, context}-shaped objects
+            if (detect_shapes) {
+                const CALLBACK_PROPS = new Set([
+                    'callback',
+                    'fn',
+                    'handler',
+                    'listener',
+                ]);
+                const CONTEXT_PROPS = new Set([
+                    'context',
+                    'ctx',
+                    'this',
+                    'target',
+                    'scope',
+                ]);
+                const shapeMap = new Map();
+                snapshot.nodes.forEach(node => {
+                    if (node.id <= 3)
+                        return;
+                    if (node.type !== 'object' || node.name !== 'Object')
+                        return;
+                    const propNames = [];
+                    let hasCallback = false;
+                    let hasContext = false;
+                    let callbackId = 0;
+                    let callbackName = '';
+                    let contextId = null;
+                    let contextName = null;
+                    for (const edge of node.references) {
+                        if (edge.type !== 'property')
+                            continue;
+                        const pName = String(edge.name_or_index);
+                        propNames.push(pName);
+                        if (CALLBACK_PROPS.has(pName)) {
+                            hasCallback = true;
+                            callbackId = edge.toNode.id;
+                            callbackName = edge.toNode.name;
+                        }
+                        if (CONTEXT_PROPS.has(pName)) {
+                            hasContext = true;
+                            contextId = edge.toNode.id;
+                            contextName = edge.toNode.name;
+                        }
+                    }
+                    if (!hasCallback || !hasContext)
+                        return;
+                    if (propNames.length === 0 || propNames.length > 10)
+                        return;
+                    propNames.sort();
+                    const key = propNames.join(',');
+                    const existing = shapeMap.get(key);
+                    if (existing) {
+                        existing.count++;
+                        existing.totalRetained += node.retainedSize;
+                        existing.allListeners.push({
+                            callbackId,
+                            callbackName,
+                            contextId,
+                            contextName,
+                        });
+                    }
+                    else {
+                        shapeMap.set(key, {
+                            count: 1,
+                            totalRetained: node.retainedSize,
+                            properties: propNames,
+                            exampleId: node.id,
+                            allListeners: [
+                                { callbackId, callbackName, contextId, contextName },
+                            ],
+                        });
+                    }
+                });
+                for (const [, shape] of shapeMap) {
+                    if (shape.count < min_listeners)
+                        continue;
+                    const contextDist = analyze_contexts
+                        ? analyzeContextDistribution(shape.allListeners, snapshot)
+                        : undefined;
+                    const entry = {
+                        hostNodeId: shape.exampleId,
+                        hostName: `{${shape.properties.join(', ')}}`,
+                        hostType: 'shape',
+                        eventPropertyName: `(${shape.properties.join(', ')})`,
+                        eventContainerId: shape.exampleId,
+                        totalListeners: shape.count,
+                        eventBreakdown: [
+                            {
+                                eventName: '(shape-based)',
+                                listenerCount: shape.count,
+                                sampleListeners: shape.allListeners.slice(0, 3),
+                            },
+                        ],
+                        zombieCount: 0,
+                        duplicateCallbackCount: countDuplicateCallbacks(shape.allListeners),
+                        totalRetainedSize: shape.totalRetained,
+                        contextDistribution: contextDist,
+                    };
+                    let inserted = false;
+                    for (let i = 0; i < accumulations.length; i++) {
+                        if (entry.totalListeners > accumulations[i].totalListeners) {
+                            accumulations.splice(i, 0, entry);
+                            inserted = true;
+                            break;
+                        }
+                    }
+                    if (!inserted)
+                        accumulations.push(entry);
+                    if (accumulations.length > limit)
+                        accumulations.length = limit;
+                }
+            }
             if (accumulations.length === 0) {
                 return toolResult(`No event listener accumulation found with >= ${min_listeners} listeners. ` +
-                    `Try lowering min_listeners or check \`memlab_find_by_property\` with property_name="_events".`);
+                    `Try lowering min_listeners, or check \`memlab_find_by_property\` with property_name="callback", ` +
+                    `or use \`memlab_shape_histogram\` with sort_by="count" to find high-count shapes.`);
             }
             const lines = [
                 `## Event Listener Leak Detection`,
                 `Found ${accumulations.length} object(s) with potential listener accumulation`,
                 '',
+                '_"Duplicates" = the same callback instance bound to the same context, registered more than once (by node id, not by name/shape). One listener per distinct model/host is structural, not a leak._',
+                '',
             ];
             const headers = [
                 'Host',
@@ -233,7 +429,33 @@ export function registerEventListenerLeaks(server) {
                     lines.push('');
                 }
                 if (a.duplicateCallbackCount > 0) {
-                    lines.push(`**${formatNumber(a.duplicateCallbackCount)} duplicate callback(s)** — same callback registered multiple times (classic mount/unmount leak)`);
+                    lines.push(`**${formatNumber(a.duplicateCallbackCount)} duplicate callback(s)** — the same callback *instance* bound to the same context registered more than once (classic mount/unmount leak). One listener per distinct model is structural, not a duplicate.`);
+                    lines.push('');
+                }
+                if (a.contextDistribution) {
+                    const cd = a.contextDistribution;
+                    lines.push('**Context distribution:**');
+                    lines.push(`- ${formatNumber(cd.uniqueCallbacks)} unique callback(s) across ${formatNumber(cd.totalListeners)} listeners`);
+                    lines.push(`- ${formatNumber(cd.uniqueContexts)} unique context object(s) across ${formatNumber(cd.totalListeners)} listeners`);
+                    if (cd.orphanedContextCount > 0) {
+                        const orphanPct = cd.uniqueContexts > 0
+                            ? ` (${((cd.orphanedContextCount / cd.uniqueContexts) * 100).toFixed(0)}%)`
+                            : '';
+                        lines.push(`- **${formatNumber(cd.orphanedContextCount)} orphaned context(s)**${orphanPct} — only retained by listener registrations`);
+                    }
+                    if (cd.contextShapes.length > 0) {
+                        lines.push('- Context shapes:');
+                        for (const cs of cd.contextShapes) {
+                            lines.push(`  - ${formatNumber(cs.count)}× \`${cs.shapeName}\` (example: @${cs.exampleId})`);
+                        }
+                    }
+                    if (cd.uniqueCallbacks <= 3 &&
+                        cd.uniqueContexts > 10 &&
+                        cd.orphanedContextCount > cd.uniqueContexts * 0.5) {
+                        lines.push('');
+                        lines.push(`**⚠ LEAK PATTERN:** Few callbacks (${cd.uniqueCallbacks}) but many orphaned contexts (${formatNumber(cd.orphanedContextCount)}) — ` +
+                            `classic listener-based memory leak where orphaned objects register on shared models but are never unregistered.`);
+                    }
                     lines.push('');
                 }
                 lines.push('Event breakdown:');