@petukhovart/agent-view 0.14.0 → 0.15.0

package/dist/inspectors/coverage/index.js

@@ -1,3 +1,4 @@
+import { capLines } from '../format.js';
 /**
  * Scripts nobody reviews: the runtime's own bundles, third-party packages, and
  * code with no URL at all (`eval`, `new Function`) which cannot be pointed at in
@@ -56,10 +57,6 @@ export function formatCoverage(scripts, options = {}) {
     if (hidden > 0 && !options.all) {
         lines.push(`… ${hidden} script${hidden === 1 ? '' : 's'} hidden (--all to show)`);
     }
-    const { maxLines } = options;
-    const text = maxLines !== undefined && lines.length > maxLines
-        ? [...lines.slice(0, maxLines - 1), `… ${lines.length - (maxLines - 1)} more lines`].join('\n')
-        : lines.join('\n');
-    return { text, functions: total };
+    return { text: capLines(lines, options.maxLines), functions: total };
 }
 //# sourceMappingURL=index.js.map

package/dist/inspectors/coverage/index.js.map

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

package/dist/inspectors/format.d.ts

@@ -0,0 +1,6 @@
+/** Output helpers every inspector prints with, so the tails and units read the same across commands. */
+/** Keep the first `maxLines - 1` lines and say how many were cut. */
+export declare function capLines(lines: string[], maxLines?: number): string;
+/** `512 B`, `12.3 KB`, `1.5 MB`; negatives keep their sign, for deltas. */
+export declare function formatBytes(n: number): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/inspectors/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/inspectors/format.ts"],"names":[],"mappings":"AAAA,wGAAwG;AAExG,qEAAqE;AACrE,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAGnE;AAED,2EAA2E;AAC3E,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAK7C"}

package/dist/inspectors/format.js

@@ -0,0 +1,17 @@
+/** Output helpers every inspector prints with, so the tails and units read the same across commands. */
+/** Keep the first `maxLines - 1` lines and say how many were cut. */
+export function capLines(lines, maxLines) {
+    if (maxLines === undefined || lines.length <= maxLines)
+        return lines.join('\n');
+    return [...lines.slice(0, maxLines - 1), `… ${lines.length - (maxLines - 1)} more lines`].join('\n');
+}
+/** `512 B`, `12.3 KB`, `1.5 MB`; negatives keep their sign, for deltas. */
+export function formatBytes(n) {
+    const abs = Math.abs(n);
+    if (abs < 1024)
+        return `${n} B`;
+    if (abs < 1024 * 1024)
+        return `${(n / 1024).toFixed(1)} KB`;
+    return `${(n / 1024 / 1024).toFixed(1)} MB`;
+}
+//# sourceMappingURL=format.js.map

package/dist/inspectors/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/inspectors/format.ts"],"names":[],"mappings":"AAAA,wGAAwG;AAExG,qEAAqE;AACrE,MAAM,UAAU,QAAQ,CAAC,KAAe,EAAE,QAAiB;IACzD,IAAI,QAAQ,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,IAAI,QAAQ;QAAE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC/E,OAAO,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,GAAG,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,MAAM,GAAG,CAAC,QAAQ,GAAG,CAAC,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACtG,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,WAAW,CAAC,CAAS;IACnC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;IACvB,IAAI,GAAG,GAAG,IAAI;QAAE,OAAO,GAAG,CAAC,IAAI,CAAA;IAC/B,IAAI,GAAG,GAAG,IAAI,GAAG,IAAI;QAAE,OAAO,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAA;IAC3D,OAAO,GAAG,CAAC,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAA;AAC7C,CAAC"}

package/dist/inspectors/heap/index.d.ts

@@ -0,0 +1,65 @@
+/**
+ * V8 `.heapsnapshot` reader, sized for one question: what grew between two
+ * snapshots, and who holds it. Retained sizes and dominator trees are out of
+ * scope on purpose — they are where the DevTools engine spends its 5,000 lines,
+ * and "which class grew, is it detached DOM, what retains it" needs neither.
+ */
+export type ClassStat = {
+    count: number;
+    size: number;
+};
+export type HeapSnapshot = {
+    name: string;
+    target: string;
+    nodeCount: number;
+    totalSize: number;
+    classes: Map<string, ClassStat>;
+    /** Retainer lookup needs the graph itself; kept as typed arrays, not as parsed JSON. */
+    graph: HeapGraph;
+};
+type HeapGraph = {
+    nodes: Uint32Array;
+    edges: Uint32Array;
+    strings: string[];
+    nodeFieldCount: number;
+    edgeFieldCount: number;
+    nodeTypes: string[];
+    edgeTypes: string[];
+    /** Field offsets inside one node / edge record. `detachedness` is -1 on V8 builds that predate it. */
+    nType: number;
+    nName: number;
+    nSize: number;
+    nEdgeCount: number;
+    nDetached: number;
+    eType: number;
+    eName: number;
+    eTo: number;
+};
+export declare function parseHeapSnapshot(json: string, name: string, target: string): HeapSnapshot;
+export declare function isDetachedClass(cls: string): boolean;
+export type ListOptions = {
+    filter?: string;
+    detached?: boolean;
+    maxLines?: number;
+};
+export declare function describeSnapshot(s: HeapSnapshot): string;
+export declare function formatSummary(s: HeapSnapshot, options?: ListOptions): string;
+export declare function formatDiff(a: HeapSnapshot, b: HeapSnapshot, options?: ListOptions): string;
+/**
+ * Who holds the instances of `cls`: one row per `<retainer class> <edge>`,
+ * counting distinct instances, not edges. Element indices collapse to `[]`, so
+ * an array of 200 leaks is one row. Weak edges keep nothing alive and are
+ * skipped.
+ *
+ * V8 reports an array's items twice, once from the `Array` and once from its
+ * `(object elements)` backing store, and a Map's entries only from the store.
+ * Stores name nothing a developer wrote, so an edge from one is attributed to
+ * the store's owner; counting instances makes the duplicate collapse. Still one
+ * named hop, no path to a GC root: the first owner is usually the map, list or
+ * closure at fault. Instances holding each other (DOM sibling links, list
+ * nodes) are left out: they never explain why the group is alive.
+ */
+export declare function formatRetainers(s: HeapSnapshot, cls: string, options?: Pick<ListOptions, 'maxLines'>): string;
+export declare function formatList(snapshots: HeapSnapshot[]): string;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/inspectors/heap/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/inspectors/heap/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkBH,MAAM,MAAM,SAAS,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAEvD,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IAC/B,wFAAwF;IACxF,KAAK,EAAE,SAAS,CAAA;CACjB,CAAA;AAED,KAAK,SAAS,GAAG;IACf,KAAK,EAAE,WAAW,CAAA;IAClB,KAAK,EAAE,WAAW,CAAA;IAClB,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,cAAc,EAAE,MAAM,CAAA;IACtB,cAAc,EAAE,MAAM,CAAA;IACtB,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,sGAAsG;IACtG,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;CACZ,CAAA;AAKD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,CAmC1F;AAgCD,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAQD,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,YAAY,GAAG,MAAM,CAIxD;AAUD,wBAAgB,aAAa,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,GAAE,WAAgB,GAAG,MAAM,CAQhF;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,EAAE,OAAO,GAAE,WAAgB,GAAG,MAAM,CAwB9F;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,IAAI,CAAC,WAAW,EAAE,UAAU,CAAM,GAAG,MAAM,CAyDjH;AAyCD,wBAAgB,UAAU,CAAC,SAAS,EAAE,YAAY,EAAE,GAAG,MAAM,CAG5D"}

package/dist/inspectors/heap/index.js

@@ -0,0 +1,269 @@
+/**
+ * V8 `.heapsnapshot` reader, sized for one question: what grew between two
+ * snapshots, and who holds it. Retained sizes and dominator trees are out of
+ * scope on purpose — they are where the DevTools engine spends its 5,000 lines,
+ * and "which class grew, is it detached DOM, what retains it" needs neither.
+ */
+import { capLines, formatBytes as fmtBytes } from '../format.js';
+const DETACHED = 2;
+const DETACHED_PREFIX = 'Detached ';
+export function parseHeapSnapshot(json, name, target) {
+    const raw = JSON.parse(json);
+    const { meta } = raw.snapshot;
+    const graph = {
+        nodes: Uint32Array.from(raw.nodes),
+        edges: Uint32Array.from(raw.edges),
+        strings: raw.strings,
+        nodeFieldCount: meta.node_fields.length,
+        edgeFieldCount: meta.edge_fields.length,
+        nodeTypes: meta.node_types[0],
+        edgeTypes: meta.edge_types[0],
+        nType: meta.node_fields.indexOf('type'),
+        nName: meta.node_fields.indexOf('name'),
+        nSize: meta.node_fields.indexOf('self_size'),
+        nEdgeCount: meta.node_fields.indexOf('edge_count'),
+        nDetached: meta.node_fields.indexOf('detachedness'),
+        eType: meta.edge_fields.indexOf('type'),
+        eName: meta.edge_fields.indexOf('name_or_index'),
+        eTo: meta.edge_fields.indexOf('to_node'),
+    };
+    const classes = new Map();
+    let totalSize = 0;
+    const nodeCount = graph.nodes.length / graph.nodeFieldCount;
+    for (let i = 0; i < nodeCount; i++) {
+        const off = i * graph.nodeFieldCount;
+        const cls = classOf(graph, off);
+        const size = graph.nodes[off + graph.nSize];
+        const stat = classes.get(cls) ?? { count: 0, size: 0 };
+        stat.count++;
+        stat.size += size;
+        classes.set(cls, stat);
+        totalSize += size;
+    }
+    return { name, target, nodeCount, totalSize, classes, graph };
+}
+/**
+ * DevTools' grouping, minus its per-constructor heuristics: objects and DOM
+ * wrappers by name, everything else by V8 type. A detached DOM wrapper becomes
+ * its own class so it stands out in a diff instead of hiding among the
+ * attached ones.
+ */
+function classOf(g, off) {
+    const type = g.nodeTypes[g.nodes[off + g.nType]];
+    const name = g.strings[g.nodes[off + g.nName]];
+    switch (type) {
+        case 'object':
+        case 'native':
+        case 'synthetic': {
+            if (name.startsWith(DETACHED_PREFIX))
+                return name;
+            const detached = g.nDetached >= 0 && g.nodes[off + g.nDetached] === DETACHED;
+            return detached ? DETACHED_PREFIX + name : name;
+        }
+        case 'closure':
+            return name ? `${name}()` : '(closure)';
+        case 'string':
+        case 'concatenated string':
+        case 'sliced string':
+            return '(string)';
+        case 'code':
+            return '(compiled code)';
+        default:
+            return `(${type})`;
+    }
+}
+export function isDetachedClass(cls) {
+    return cls.startsWith(DETACHED_PREFIX);
+}
+function keep(cls, options) {
+    if (options.detached && !isDetachedClass(cls))
+        return false;
+    if (options.filter && !cls.toLowerCase().includes(options.filter.toLowerCase()))
+        return false;
+    return true;
+}
+export function describeSnapshot(s) {
+    const detached = sumDetached(s.classes);
+    return `Snapshot "${s.name}" (${s.target}): ${fmtCount(s.nodeCount)} nodes, ${fmtBytes(s.totalSize)}, `
+        + `${fmtCount(detached.count)} detached DOM nodes (${fmtBytes(detached.size)})`;
+}
+function sumDetached(classes) {
+    const out = { count: 0, size: 0 };
+    for (const [cls, stat] of classes) {
+        if (isDetachedClass(cls)) {
+            out.count += stat.count;
+            out.size += stat.size;
+        }
+    }
+    return out;
+}
+export function formatSummary(s, options = {}) {
+    const rows = [...s.classes].filter(([cls]) => keep(cls, options)).sort((a, b) => b[1].size - a[1].size);
+    if (rows.length === 0)
+        return `(no class matching ${describeFilter(options)} in "${s.name}")`;
+    const lines = [describeSnapshot(s), ...table(['class', 'count', 'size'], rows.map(([cls, st]) => [cls, fmtCount(st.count), fmtBytes(st.size)]))];
+    return capLines(lines, options.maxLines);
+}
+export function formatDiff(a, b, options = {}) {
+    const rows = [];
+    for (const cls of new Set([...a.classes.keys(), ...b.classes.keys()])) {
+        if (!keep(cls, options))
+            continue;
+        const before = a.classes.get(cls) ?? { count: 0, size: 0 };
+        const after = b.classes.get(cls) ?? { count: 0, size: 0 };
+        const dCount = after.count - before.count;
+        const dSize = after.size - before.size;
+        if (dCount !== 0 || dSize !== 0)
+            rows.push([cls, dCount, dSize, after.count]);
+    }
+    if (rows.length === 0) {
+        const scope = options.filter || options.detached ? ` matching ${describeFilter(options)}` : '';
+        return `(no class changed between "${a.name}" and "${b.name}"${scope})`;
+    }
+    rows.sort((x, y) => y[2] - x[2] || y[1] - x[1]);
+    const dA = sumDetached(a.classes);
+    const dB = sumDetached(b.classes);
+    const head = `${a.name} → ${b.name} (${b.target}): ${fmtDelta(b.nodeCount - a.nodeCount)} nodes, `
+        + `${fmtDelta(b.totalSize - a.totalSize, true)}, detached ${fmtDelta(dB.count - dA.count)} (${fmtDelta(dB.size - dA.size, true)})`;
+    const lines = [head, ...table(['class', 'Δcount', 'Δsize', 'count'], rows.map(([cls, dc, ds, c]) => [cls, fmtDelta(dc), fmtDelta(ds, true), fmtCount(c)]))];
+    return capLines(lines, options.maxLines);
+}
+/**
+ * Who holds the instances of `cls`: one row per `<retainer class> <edge>`,
+ * counting distinct instances, not edges. Element indices collapse to `[]`, so
+ * an array of 200 leaks is one row. Weak edges keep nothing alive and are
+ * skipped.
+ *
+ * V8 reports an array's items twice, once from the `Array` and once from its
+ * `(object elements)` backing store, and a Map's entries only from the store.
+ * Stores name nothing a developer wrote, so an edge from one is attributed to
+ * the store's owner; counting instances makes the duplicate collapse. Still one
+ * named hop, no path to a GC root: the first owner is usually the map, list or
+ * closure at fault. Instances holding each other (DOM sibling links, list
+ * nodes) are left out: they never explain why the group is alive.
+ */
+export function formatRetainers(s, cls, options = {}) {
+    const g = s.graph;
+    const nodeCount = g.nodes.length / g.nodeFieldCount;
+    const classCache = new Map();
+    const clsAt = (off) => {
+        let c = classCache.get(off);
+        if (c === undefined) {
+            c = classOf(g, off);
+            classCache.set(off, c);
+        }
+        return c;
+    };
+    const weak = g.edgeTypes.indexOf('weak');
+    const indexed = new Set([g.edgeTypes.indexOf('element'), g.edgeTypes.indexOf('hidden')]);
+    const stores = new Set([g.nodeTypes.indexOf('array'), g.nodeTypes.indexOf('hidden')]);
+    const isStore = (off) => stores.has(g.nodes[off + g.nType]);
+    const edgeName = (edgeOff) => {
+        if (indexed.has(g.edges[edgeOff + g.eType]))
+            return '[]';
+        const name = g.strings[g.edges[edgeOff + g.eName]];
+        return /^\d+$/.test(name) ? '[]' : `.${name}`;
+    };
+    const held = new Map();
+    const hold = (key, instance) => {
+        const set = held.get(key) ?? new Set();
+        set.add(instance);
+        held.set(key, set);
+    };
+    /** Store node → its edges into `cls`, awaiting the store's owner. */
+    const pending = new Map();
+    let instances = 0;
+    let edgeOff = 0;
+    for (let i = 0; i < nodeCount; i++) {
+        const off = i * g.nodeFieldCount;
+        if (clsAt(off) === cls)
+            instances++;
+        const edgeCount = g.nodes[off + g.nEdgeCount];
+        for (let e = 0; e < edgeCount; e++, edgeOff += g.edgeFieldCount) {
+            if (g.edges[edgeOff + g.eType] === weak)
+                continue;
+            const to = g.edges[edgeOff + g.eTo];
+            if (clsAt(to) !== cls || clsAt(off) === cls)
+                continue;
+            if (isStore(off)) {
+                const list = pending.get(off) ?? [];
+                list.push([edgeName(edgeOff), to]);
+                pending.set(off, list);
+            }
+            else {
+                hold(`${clsAt(off)} ${edgeName(edgeOff)}`, to);
+            }
+        }
+    }
+    foldStores(g, pending, isStore, weak, (owner, name, to) => hold(`${clsAt(owner)} ${name}`, to));
+    if (instances === 0)
+        return `(no instances of "${cls}" in "${s.name}")`;
+    if (held.size === 0)
+        return `${cls} ×${fmtCount(instances)} in "${s.name}": no strong retainers (GC roots only)`;
+    const rows = [...held].map(([k, set]) => [k, set.size]).sort((a, b) => b[1] - a[1]);
+    const lines = [
+        `${cls} ×${fmtCount(instances)} in "${s.name}", retained by:`,
+        ...table(['retainer', 'instances'], rows.map(([k, n]) => [k, fmtCount(n)])),
+    ];
+    return capLines(lines, options.maxLines);
+}
+/**
+ * Attribute edges out of V8 stores to the nearest non-store owner. A store's
+ * owner may itself be a store (a Map's table behind its `(object elements)`),
+ * so the walk repeats, bounded so a cycle of internals cannot spin it. What is
+ * still unowned after that is reported under the store's own name: honest, if
+ * unhelpful.
+ */
+function foldStores(g, pending, isStore, weak, attribute) {
+    const nodeCount = g.nodes.length / g.nodeFieldCount;
+    for (let hop = 0; hop < 3 && pending.size > 0; hop++) {
+        const next = new Map();
+        let edgeOff = 0;
+        for (let i = 0; i < nodeCount; i++) {
+            const off = i * g.nodeFieldCount;
+            const edgeCount = g.nodes[off + g.nEdgeCount];
+            for (let e = 0; e < edgeCount; e++, edgeOff += g.edgeFieldCount) {
+                if (g.edges[edgeOff + g.eType] === weak)
+                    continue;
+                const list = pending.get(g.edges[edgeOff + g.eTo]);
+                if (!list)
+                    continue;
+                if (isStore(off)) {
+                    next.set(off, [...(next.get(off) ?? []), ...list]);
+                }
+                else {
+                    for (const [name, to] of list)
+                        attribute(off, name, to);
+                }
+                pending.delete(g.edges[edgeOff + g.eTo]);
+            }
+        }
+        for (const [off, list] of pending)
+            next.set(off, [...(next.get(off) ?? []), ...list]);
+        pending = next;
+    }
+    for (const [off, list] of pending)
+        for (const [name, to] of list)
+            attribute(off, name, to);
+}
+export function formatList(snapshots) {
+    if (snapshots.length === 0)
+        return '(no heap snapshots taken)';
+    return snapshots.map(describeSnapshot).join('\n');
+}
+function describeFilter(options) {
+    return options.filter ? `"${options.filter}"` : 'detached';
+}
+function table(header, rows) {
+    const widths = header.map((h, i) => Math.max(h.length, ...rows.map(r => r[i].length)));
+    const line = (r) => r.map((c, i) => i === 0 ? c.padEnd(widths[i]) : c.padStart(widths[i])).join('  ');
+    return [line(header), ...rows.map(line)];
+}
+function fmtCount(n) {
+    return n.toLocaleString('en-US');
+}
+function fmtDelta(n, bytes = false) {
+    const sign = n > 0 ? '+' : '';
+    return sign + (bytes ? fmtBytes(n) : fmtCount(n));
+}
+//# sourceMappingURL=index.js.map

package/dist/inspectors/heap/index.js.map

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

package/dist/server/server.d.ts

@@ -30,6 +30,8 @@ export declare class AgentViewServer {
     private idleTimer;
     private sceneCache;
     private domTextCache;
+    /** Named, insertion-ordered; dropped with the server. Raw JSON is never kept, only the parsed graph. */
+    private heapSnapshots;
     private axTreeCache;
     private portStates;
     private token;
@@ -98,6 +100,16 @@ export declare class AgentViewServer {
      * that *this* action did not reach the code, never that nothing can.
      */
     private handleCoverage;
+    /**
+     * Memory growth between named snapshots. `take` parses the snapshot inside
+     * the server and keeps only the graph, so the multi-hundred-MB JSON never
+     * reaches the CLI. `diff` without names compares the two most recent.
+     */
+    private handleHeap;
+    /** `s1`, `s2`, … skipping names already taken by hand. */
+    private freeHeapSnapshotName;
+    /** Named snapshot, or the most recent one. Throws the user-facing error; the dispatcher turns it into `{ ok: false }`. */
+    private pickHeapSnapshot;
     /** Which handlers are wired to a node, and where each was declared. */
     private handleListeners;
     private handleWait;

package/dist/server/server.d.ts.map

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

package/dist/server/server.js

@@ -20,6 +20,8 @@ import { formatNetworkList, formatNetworkDetail } from '../inspectors/network/in
 import { formatDialogStatus, describePolicy, describeArm } from '../inspectors/dialog/index.js';
 import { formatCoverage } from '../inspectors/coverage/index.js';
 import { formatListeners } from '../inspectors/listeners/index.js';
+import { parseHeapSnapshot, describeSnapshot, formatSummary, formatDiff, formatRetainers, formatList } from '../inspectors/heap/index.js';
+import { formatBytes } from '../inspectors/format.js';
 import { buildTauriArmScript, buildTauriStatusScript, TauriShimResult } from './tauri-dialog-shim.js';
 import { NetworkResourceType } from '../cdp/types.js';
 import { AxTreeCache } from '../cdp/ax-cache.js';
@@ -165,6 +167,8 @@ export class AgentViewServer {
     idleTimer = null;
     sceneCache = new Map();
     domTextCache = new Map();
+    /** Named, insertion-ordered; dropped with the server. Raw JSON is never kept, only the parsed graph. */
+    heapSnapshots = new Map();
     axTreeCache = new AxTreeCache();
     portStates = new Map();
     token = '';
@@ -189,6 +193,7 @@ export class AgentViewServer {
         dialog: (req) => this.handleDialog(req),
         coverage: (req) => this.handleCoverage(req),
         listeners: (req) => this.handleListeners(req),
+        heap: (req) => this.handleHeap(req),
         stop: () => this.handleStop(),
     };
     streamingCommands = new Set(['watch']);
@@ -915,6 +920,81 @@ export class AgentViewServer {
             return { ok: true, data: String(result.functions) };
         return { ok: true, data: result.text };
     }
+    /**
+     * Memory growth between named snapshots. `take` parses the snapshot inside
+     * the server and keeps only the graph, so the multi-hundred-MB JSON never
+     * reaches the CLI. `diff` without names compares the two most recent.
+     */
+    async handleHeap(req) {
+        const action = argStr(req.args, 'action');
+        const listOptions = () => ({
+            filter: argStr(req.args, 'filter'),
+            detached: argBool(req.args, 'detached'),
+            maxLines: argNum(req.args, 'maxLines'),
+        });
+        switch (action) {
+            case 'take': {
+                const target = await this.resolveTarget(req);
+                const conn = await this.getRuntimeSession(req, target);
+                const name = argStr(req.args, 'name') ?? this.freeHeapSnapshotName();
+                const json = await conn.takeHeapSnapshot();
+                const label = `${target.type}:${target.title || target.url}`;
+                const snapshot = parseHeapSnapshot(json, name, label);
+                // Re-taking a name moves it to the end: "most recent" is insertion order, and `diff` defaults to the last two.
+                this.heapSnapshots.delete(name);
+                this.heapSnapshots.set(name, snapshot);
+                return { ok: true, data: describeSnapshot(snapshot) };
+            }
+            case 'summary':
+                return { ok: true, data: formatSummary(this.pickHeapSnapshot(argStr(req.args, 'name')), listOptions()) };
+            case 'diff': {
+                const names = argStrArray(req.args, 'names') ?? [...this.heapSnapshots.keys()].slice(-2);
+                if (names.length < 2) {
+                    return { ok: false, error: 'heap diff needs two snapshots. Run `agent-view heap take` twice, or name them: `heap diff <a> <b>`.' };
+                }
+                const [a, b] = names.map((n) => this.pickHeapSnapshot(n));
+                return { ok: true, data: formatDiff(a, b, listOptions()) };
+            }
+            case 'retainers': {
+                const cls = argStr(req.args, 'class');
+                if (!cls)
+                    return { ok: false, error: 'heap retainers requires a class name, as printed by `heap diff`' };
+                const snapshot = this.pickHeapSnapshot(argStr(req.args, 'name'));
+                return { ok: true, data: formatRetainers(snapshot, cls, listOptions()) };
+            }
+            case 'list':
+                return { ok: true, data: formatList([...this.heapSnapshots.values()]) };
+            case 'clear': {
+                const n = this.heapSnapshots.size;
+                this.heapSnapshots.clear();
+                return { ok: true, data: `Dropped ${n} heap snapshot${n === 1 ? '' : 's'}` };
+            }
+            default:
+                return { ok: false, error: `Unknown heap action: ${action}` };
+        }
+    }
+    /** `s1`, `s2`, … skipping names already taken by hand. */
+    freeHeapSnapshotName() {
+        for (let i = this.heapSnapshots.size + 1;; i++) {
+            if (!this.heapSnapshots.has(`s${i}`))
+                return `s${i}`;
+        }
+    }
+    /** Named snapshot, or the most recent one. Throws the user-facing error; the dispatcher turns it into `{ ok: false }`. */
+    pickHeapSnapshot(name) {
+        if (name === undefined) {
+            const last = [...this.heapSnapshots.values()].at(-1);
+            if (!last)
+                throw new Error('No heap snapshots taken. Run `agent-view heap take` first.');
+            return last;
+        }
+        const found = this.heapSnapshots.get(name);
+        if (!found) {
+            const taken = [...this.heapSnapshots.keys()].map(k => `"${k}"`).join(', ') || 'none';
+            throw new Error(`No heap snapshot named "${name}". Taken: ${taken}.`);
+        }
+        return found;
+    }
     /** Which handlers are wired to a node, and where each was declared. */
     async handleListeners(req) {
         const { targetId } = await this.resolveWindow(req);
@@ -1772,13 +1852,6 @@ function formatIdleFeed(file) {
         'start with `agent-view logs start` — `logs tail` still reads the existing feed',
     ].join('\n');
 }
-function formatBytes(bytes) {
-    if (bytes < 1024)
-        return `${bytes} B`;
-    if (bytes < 1024 * 1024)
-        return `${(bytes / 1024).toFixed(1)} KB`;
-    return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
-}
 function formatElapsed(ms) {
     const total = Math.max(0, Math.round(ms / 1000));
     const h = Math.floor(total / 3600);