@buoy-gg/network 7.0.17 → 7.0.19

package/lib/commonjs/network/components/NetworkEventDetailView.js

@@ -324,13 +324,17 @@ const NetworkEventDetailView = exports.NetworkEventDetailView = /*#__PURE__*/(0,
   // fetched on demand through the resolver. On the device there is no resolver
   // and bodies are always inline, so this is a no-op there.
   const resolveBody = (0, _networkBodyResolver.useNetworkBodyResolver)();
-  const requestBodyOmitted = event.requestData === undefined && (event.requestSize ?? 0) > 0;
-  const responseBodyOmitted = event.responseData === undefined && (event.responseSize ?? 0) > 0;
+  // The explicit flag is authoritative (adapter v5+). The size>0 fallback keeps
+  // detail-on-demand working against a device on an older adapter, which marked
+  // a withheld body only by leaving `data` undefined with a non-zero size.
+  const requestBodyOmitted = event.requestData === undefined && (event.requestBodyOmitted === true || (event.requestSize ?? 0) > 0);
+  const responseBodyOmitted = event.responseData === undefined && (event.responseBodyOmitted === true || (event.responseSize ?? 0) > 0);
+  const headersOmitted = event.headersOmitted === true;
   const [resolvedBody, setResolvedBody] = (0, _react.useState)(null);
   const [isLoadingBody, setIsLoadingBody] = (0, _react.useState)(false);
   (0, _react.useEffect)(() => {
     setResolvedBody(null);
-    if (!resolveBody || !requestBodyOmitted && !responseBodyOmitted) {
+    if (!resolveBody || !requestBodyOmitted && !responseBodyOmitted && !headersOmitted) {
       setIsLoadingBody(false);
       return;
     }
@@ -344,12 +348,14 @@ const NetworkEventDetailView = exports.NetworkEventDetailView = /*#__PURE__*/(0,
     return () => {
       cancelled = true;
     };
-  }, [event.id, resolveBody, requestBodyOmitted, responseBodyOmitted]);
+  }, [event.id, resolveBody, requestBodyOmitted, responseBodyOmitted, headersOmitted]);
 
   // Effective bodies: inline data when present, otherwise the lazily resolved
   // body. `null`/`undefined` both collapse to undefined ("no body").
   const requestData = event.requestData ?? resolvedBody?.requestData ?? undefined;
   const responseData = event.responseData ?? resolvedBody?.responseData ?? undefined;
+  const requestHeaders = (headersOmitted ? resolvedBody?.requestHeaders : undefined) ?? event.requestHeaders;
+  const responseHeaders = (headersOmitted ? resolvedBody?.responseHeaders : undefined) ?? event.responseHeaders;
 
   // Generate full request details for copying
   const getFullRequestDetails = () => {
@@ -360,9 +366,9 @@ const NetworkEventDetailView = exports.NetworkEventDetailView = /*#__PURE__*/(0,
       statusText: event.statusText,
       timestamp: new Date(event.timestamp).toISOString(),
       duration: event.duration ? `${event.duration}ms` : "N/A",
-      requestHeaders: event.requestHeaders,
+      requestHeaders,
       requestData,
-      responseHeaders: event.responseHeaders,
+      responseHeaders,
       responseData,
       requestSize: event.requestSize ? (0, _formatting.formatBytes)(event.requestSize) : "N/A",
       responseSize: event.responseSize ? (0, _formatting.formatBytes)(event.responseSize) : "N/A",
@@ -551,12 +557,12 @@ ${JSON.stringify(requestDetails.responseData, null, 2)}
           color: _sharedUi.macOSColors.semantic.info
         }),
         defaultOpen: false,
-        count: Object.keys(event.requestHeaders).length,
-        children: Object.keys(event.requestHeaders).length > 0 ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
+        count: Object.keys(requestHeaders).length,
+        children: Object.keys(requestHeaders).length > 0 ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
           style: styles.dataViewerContainer,
           children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_dataViewer.DataViewer, {
             title: "",
-            data: event.requestHeaders,
+            data: requestHeaders,
             showTypeFilter: true,
             rawMode: true,
             initialExpanded: true,
@@ -573,12 +579,12 @@ ${JSON.stringify(requestDetails.responseData, null, 2)}
           color: NEUTRAL_ICON
         }),
         defaultOpen: false,
-        count: Object.keys(event.responseHeaders).length,
-        children: Object.keys(event.responseHeaders).length > 0 ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
+        count: Object.keys(responseHeaders).length,
+        children: Object.keys(responseHeaders).length > 0 ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
           style: styles.dataViewerContainer,
           children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_dataViewer.DataViewer, {
             title: "",
-            data: event.responseHeaders,
+            data: responseHeaders,
             showTypeFilter: true,
             rawMode: true,
             initialExpanded: true,

package/lib/commonjs/network/components/NetworkEventDetailView.web.js

@@ -637,13 +637,17 @@ const NetworkEventDetailView = exports.NetworkEventDetailView = /*#__PURE__*/(0,
   // webview port there is normally no resolver and bodies are always inline,
   // so this is a no-op there — exactly like on the device.
   const resolveBody = (0, _networkBodyResolver.useNetworkBodyResolver)();
-  const requestBodyOmitted = event.requestData === undefined && (event.requestSize ?? 0) > 0;
-  const responseBodyOmitted = event.responseData === undefined && (event.responseSize ?? 0) > 0;
+  // The explicit flag is authoritative (adapter v5+). The size>0 fallback keeps
+  // detail-on-demand working against a device on an older adapter, which marked
+  // a withheld body only by leaving `data` undefined with a non-zero size.
+  const requestBodyOmitted = event.requestData === undefined && (event.requestBodyOmitted === true || (event.requestSize ?? 0) > 0);
+  const responseBodyOmitted = event.responseData === undefined && (event.responseBodyOmitted === true || (event.responseSize ?? 0) > 0);
+  const headersOmitted = event.headersOmitted === true;
   const [resolvedBody, setResolvedBody] = (0, _react.useState)(null);
   const [isLoadingBody, setIsLoadingBody] = (0, _react.useState)(false);
   (0, _react.useEffect)(() => {
     setResolvedBody(null);
-    if (!resolveBody || !requestBodyOmitted && !responseBodyOmitted) {
+    if (!resolveBody || !requestBodyOmitted && !responseBodyOmitted && !headersOmitted) {
       setIsLoadingBody(false);
       return;
     }
@@ -657,12 +661,14 @@ const NetworkEventDetailView = exports.NetworkEventDetailView = /*#__PURE__*/(0,
     return () => {
       cancelled = true;
     };
-  }, [event.id, resolveBody, requestBodyOmitted, responseBodyOmitted]);
+  }, [event.id, resolveBody, requestBodyOmitted, responseBodyOmitted, headersOmitted]);
 
   // Effective bodies: inline data when present, otherwise the lazily resolved
   // body. `null`/`undefined` both collapse to undefined ("no body").
   const requestData = event.requestData ?? resolvedBody?.requestData ?? undefined;
   const responseData = event.responseData ?? resolvedBody?.responseData ?? undefined;
+  const requestHeaders = (headersOmitted ? resolvedBody?.requestHeaders : undefined) ?? event.requestHeaders;
+  const responseHeaders = (headersOmitted ? resolvedBody?.responseHeaders : undefined) ?? event.responseHeaders;
 
   // Generate full request details for copying (resolved LAZILY at press time —
   // see the copy button below).
@@ -674,9 +680,9 @@ const NetworkEventDetailView = exports.NetworkEventDetailView = /*#__PURE__*/(0,
       statusText: event.statusText,
       timestamp: new Date(event.timestamp).toISOString(),
       duration: event.duration ? `${event.duration}ms` : "N/A",
-      requestHeaders: event.requestHeaders,
+      requestHeaders,
       requestData,
-      responseHeaders: event.responseHeaders,
+      responseHeaders,
       responseData,
       requestSize: event.requestSize ? formatBytes(event.requestSize) : "N/A",
       responseSize: event.responseSize ? formatBytes(event.responseSize) : "N/A",
@@ -849,12 +855,12 @@ ${JSON.stringify(requestDetails.responseData, null, 2)}
         color: macOSColors.semantic.info
       }),
       defaultOpen: false,
-      count: Object.keys(event.requestHeaders).length,
-      children: Object.keys(event.requestHeaders).length > 0 ? /*#__PURE__*/(0, _jsxRuntime.jsx)("div", {
+      count: Object.keys(requestHeaders).length,
+      children: Object.keys(requestHeaders).length > 0 ? /*#__PURE__*/(0, _jsxRuntime.jsx)("div", {
         style: styles.dataViewerContainer,
         children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_DataViewer.DataViewer, {
           title: "",
-          data: event.requestHeaders,
+          data: requestHeaders,
           showTypeFilter: true,
           rawMode: true,
           initialExpanded: true
@@ -870,12 +876,12 @@ ${JSON.stringify(requestDetails.responseData, null, 2)}
         color: NEUTRAL_ICON
       }),
       defaultOpen: false,
-      count: Object.keys(event.responseHeaders).length,
-      children: Object.keys(event.responseHeaders).length > 0 ? /*#__PURE__*/(0, _jsxRuntime.jsx)("div", {
+      count: Object.keys(responseHeaders).length,
+      children: Object.keys(responseHeaders).length > 0 ? /*#__PURE__*/(0, _jsxRuntime.jsx)("div", {
         style: styles.dataViewerContainer,
         children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_DataViewer.DataViewer, {
           title: "",
-          data: event.responseHeaders,
+          data: responseHeaders,
           showTypeFilter: true,
           rawMode: true,
           initialExpanded: true

package/lib/commonjs/network/sync/networkSyncAdapter.js

@@ -3,38 +3,232 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.networkSyncAdapter = exports.SNAPSHOT_BODY_INLINE_LIMIT = void 0;
+exports.networkSyncAdapter = exports.SNAPSHOT_HEADER_VALUE_LIMIT = exports.SNAPSHOT_EVENTS_BUDGET = exports.SNAPSHOT_BODY_INLINE_LIMIT = void 0;
 var _networkEventStore = require("../utils/networkEventStore");
 var _networkSavedStore = require("../utils/networkSavedStore");
 var _overrideRulesStore = require("../overrides/overrideRulesStore");
 var _presets = require("../overrides/presets");
 var _engine = require("../overrides/engine");
 var _networkListener = require("../utils/networkListener");
+var _sharedUi = require("@buoy-gg/shared-ui");
 /**
- * Request/response bodies larger than this (using the cached size proxy already
- * on the event — no per-snapshot stringify) are NOT streamed in the list
- * snapshot. These are the multi-MB payloads (images, large JSON list responses)
- * that, re-sent every ~200ms for up to 500 events, freeze the desktop
- * dashboard's main thread while it deserializes and re-renders them. Smaller
- * bodies stay inline so the common case needs no round-trip (instant detail
- * view, and they remain available to copy/export). Stripped bodies are fetched
- * on demand via the `getEventBody` action when a request's detail view opens.
+ * Request/response bodies larger than this are NOT streamed in the list
+ * snapshot. Prefer the cached size proxy already on the event (free); if that
+ * field is missing or wrong (0 for a fat/cyclic body), fall back to an
+ * O(limit) walk. Stripped bodies come back via `getEventBody` on detail open.
  */
 const SNAPSHOT_BODY_INLINE_LIMIT = exports.SNAPSHOT_BODY_INLINE_LIMIT = 16 * 1024;
-const stripLargeBodies = event => {
-  const stripRequest = event.requestData !== undefined && (event.requestSize ?? 0) > SNAPSHOT_BODY_INLINE_LIMIT;
-  const stripResponse = event.responseData !== undefined && (event.responseSize ?? 0) > SNAPSHOT_BODY_INLINE_LIMIT;
-  if (!stripRequest && !stripResponse) return event;
-  // Keep sizes/headers/metadata; only drop the heavy data. `undefined` keys are
-  // omitted by JSON serialization, so this shrinks the wire payload, and the
-  // dashboard treats "data missing but size > 0" as "fetch on demand".
+
+/**
+ * Total inline budget for one snapshot's event list, held under the emit
+ * layer's 2MB so a snapshot is never DROPPED (a drop leaves the whole panel
+ * stale). Per-field caps alone don't get there: 500 requests with 9KB
+ * responses are all individually legal and still add up to ~4.7MB. Newest
+ * events keep their bodies inline (that's what a developer is looking at);
+ * once the budget is spent, older events degrade to metadata + fetch-on-demand.
+ */
+const SNAPSHOT_EVENTS_BUDGET = exports.SNAPSHOT_EVENTS_BUDGET = 1.25 * 1024 * 1024;
+function shouldStripBody(data, reportedSize) {
+  if (data === undefined) return false;
+  // The cached size proxy already on the event is free when it's right; the
+  // walk is the fallback for when it's missing or wrong (0 for a fat body).
+  if ((reportedSize ?? 0) > SNAPSHOT_BODY_INLINE_LIMIT) return true;
+  return (0, _sharedUi.isOverWireBudget)(data, SNAPSHOT_BODY_INLINE_LIMIT);
+}
+
+/** One event's wire form plus its measured cost, so the budget pass is free. */
+
+/**
+ * Per-event wire cache. `networkEventStore` never mutates an event in place —
+ * a response/override update replaces the object — so keying on identity is
+ * correct and self-invalidating, and a completed request is converted once
+ * instead of on all ~5 snapshots per second for as long as it stays in the
+ * list. This is what keeps the guards off the hot path.
+ */
+const wireCache = new WeakMap();
+const strippedCache = new WeakMap();
+
+/** Per-field guards: oversized bodies out, heavy headers/variables slimmed. */
+function toWireEvent(event) {
+  const cached = wireCache.get(event);
+  if (cached) return cached;
+  let entry;
+  try {
+    entry = buildWireEvent(event);
+  } catch {
+    // A body with a throwing getter or `toJSON` can blow up the size walk
+    // itself. Degrading this ONE event to metadata beats letting getSnapshot
+    // throw, which would take the whole panel down with it.
+    entry = buildMetadataOnly(event);
+  }
+  wireCache.set(event, entry);
+  return entry;
+}
+function buildMetadataOnly(event) {
   const stripped = {
-    ...event
+    ...event,
+    requestData: undefined,
+    responseData: undefined,
+    graphqlVariables: undefined,
+    requestBodyOmitted: event.requestData !== undefined ? true : undefined,
+    responseBodyOmitted: event.responseData !== undefined ? true : undefined
   };
-  if (stripRequest) stripped.requestData = undefined;
-  if (stripResponse) stripped.responseData = undefined;
-  return stripped;
-};
+  // The payload fields are gone, so measuring this is safe even when measuring
+  // the original blew up. Fall back to a nominal cost only if even THIS throws
+  // (a hostile getter on the event itself rather than on its body).
+  let bytes = 1024;
+  try {
+    bytes = (0, _sharedUi.approxJsonSize)(stripped, SNAPSHOT_EVENTS_BUDGET).bytes;
+  } catch {
+    /* keep the nominal estimate */
+  }
+  return {
+    event: stripped,
+    bytes
+  };
+}
+function buildWireEvent(event) {
+  const stripRequest = shouldStripBody(event.requestData, event.requestSize);
+  const stripResponse = shouldStripBody(event.responseData, event.responseSize);
+  const graphqlVariables = toWireGraphqlVariables(event.graphqlVariables);
+  const requestHeaders = toWireHeaders(event.requestHeaders);
+  const responseHeaders = toWireHeaders(event.responseHeaders);
+  const changed = stripRequest || stripResponse || graphqlVariables !== event.graphqlVariables || requestHeaders !== event.requestHeaders || responseHeaders !== event.responseHeaders;
+  let wire = event;
+  if (changed) {
+    // `undefined` keys are omitted by JSON serialization, so dropping the data
+    // shrinks the wire payload. Sizes stay HONEST — the explicit
+    // request/responseBodyOmitted flags are what tell the dashboard to fetch,
+    // matching `OverrideRule.bodyOmitted`. Full values come from `getEventBody`.
+    wire = {
+      ...event
+    };
+    if (stripRequest) {
+      wire.requestData = undefined;
+      wire.requestBodyOmitted = true;
+    }
+    if (stripResponse) {
+      wire.responseData = undefined;
+      wire.responseBodyOmitted = true;
+    }
+    if (graphqlVariables !== event.graphqlVariables) {
+      wire.graphqlVariables = graphqlVariables;
+    }
+    if (requestHeaders !== event.requestHeaders) {
+      wire.requestHeaders = requestHeaders;
+      wire.headersOmitted = true;
+    }
+    if (responseHeaders !== event.responseHeaders) {
+      wire.responseHeaders = responseHeaders;
+      wire.headersOmitted = true;
+    }
+  }
+  return {
+    event: wire,
+    bytes: (0, _sharedUi.approxJsonSize)(wire, SNAPSHOT_EVENTS_BUDGET).bytes
+  };
+}
+
+/**
+ * Metadata-only form, used for the tail of the list once the snapshot budget
+ * is spent. Method/url/status/timing all stay — only the payloads go.
+ */
+function toStrippedEvent(event) {
+  const cached = strippedCache.get(event);
+  if (cached) return cached;
+  const {
+    event: wire
+  } = toWireEvent(event);
+  const stripped = {
+    ...wire
+  };
+  if (stripped.requestData !== undefined) {
+    stripped.requestData = undefined;
+    stripped.requestBodyOmitted = true;
+  }
+  if (stripped.responseData !== undefined) {
+    stripped.responseData = undefined;
+    stripped.responseBodyOmitted = true;
+  }
+  if (stripped.graphqlVariables !== undefined) {
+    stripped.graphqlVariables = toWireGraphqlVariables(stripped.graphqlVariables, /* force */true);
+  }
+  const entry = {
+    event: stripped,
+    bytes: (0, _sharedUi.approxJsonSize)(stripped, SNAPSHOT_EVENTS_BUDGET).bytes
+  };
+  strippedCache.set(event, entry);
+  return entry;
+}
+
+/**
+ * Spend the snapshot budget newest-first. The store keeps events newest-first
+ * already, so this hands the developer full detail on what they are actually
+ * looking at and degrades the tail rather than dropping the whole panel.
+ */
+function fitEventsToBudget(events) {
+  const out = new Array(events.length);
+  let spent = 0;
+  for (let i = 0; i < events.length; i++) {
+    const full = toWireEvent(events[i]);
+    if (spent + full.bytes <= SNAPSHOT_EVENTS_BUDGET) {
+      out[i] = full.event;
+      spent += full.bytes;
+    } else {
+      const lean = toStrippedEvent(events[i]);
+      out[i] = lean.event;
+      spent += lean.bytes;
+    }
+  }
+  return out;
+}
+
+/**
+ * GraphQL variables are copied off `request.data.variables` onto their own
+ * field for the list subtitle (`GetPokemon › Sandshrew`). Capping requestData
+ * still left that copy on the wire. Keep short primitives for the subtitle;
+ * drop nested/fat values (file uploads, base64). Full variables stay in
+ * `requestData` on-device and come back via `getEventBody`.
+ */
+function toWireGraphqlVariables(vars, force = false) {
+  if (!vars) return vars;
+  if (!force && !shouldStripBody(vars, undefined)) return vars;
+  const slim = {};
+  for (const [key, value] of Object.entries(vars)) {
+    if (typeof value === "string" && value.length <= 64) slim[key] = value;else if (typeof value === "number" || typeof value === "boolean") {
+      slim[key] = value;
+    }
+  }
+  return Object.keys(slim).length > 0 ? slim : undefined;
+}
+
+/**
+ * Header values (Cookie, Authorization, custom JSON) still rode every
+ * snapshot after bodies were stripped. 500 events × a 4KB session cookie
+ * is a 2MB drop of the whole Network panel. Keep short values inline
+ * (content-type, accept); truncate the rest. Full maps stay on-device
+ * and come back via `getEventBody`.
+ *
+ * Returns the SAME object when nothing was truncated: callers use identity to
+ * decide whether anything was omitted, so a fresh `{}` here would flag every
+ * header-less event as truncated (and defeat the no-copy fast path).
+ */
+const SNAPSHOT_HEADER_VALUE_LIMIT = exports.SNAPSHOT_HEADER_VALUE_LIMIT = 64;
+function toWireHeaders(headers) {
+  if (!headers) return headers;
+  let changed = false;
+  const slim = {};
+  for (const [key, value] of Object.entries(headers)) {
+    if (typeof value !== "string") continue;
+    if (value.length <= SNAPSHOT_HEADER_VALUE_LIMIT) {
+      slim[key] = value;
+    } else {
+      slim[key] = `${value.slice(0, SNAPSHOT_HEADER_VALUE_LIMIT)}… [${value.length - SNAPSHOT_HEADER_VALUE_LIMIT} more]`;
+      changed = true;
+    }
+  }
+  return changed ? slim : headers;
+}
 
 /**
  * Drop oversized rule bodies from the snapshot, flagging what was dropped.
@@ -152,7 +346,9 @@ function baseFromRequest(params) {
  * this package doesn't need a dependency on it).
  *
  * Subscribing starts the network interceptor, so requests are only captured
- * while a dashboard is watching the network panel.
+ * while a dashboard is watching the network panel — or while an MCP
+ * client holds a capture-mode watch (`devtool-watch` with `stream:false`),
+ * which records without asking the device to push snapshots.
  *
  * v2: large bodies are stripped from the snapshot and fetched lazily via
  * `getEventBody` (see SNAPSHOT_BODY_INLINE_LIMIT).
@@ -164,9 +360,12 @@ function baseFromRequest(params) {
  * `NetworkPanel`/`NetworkInline` accept either shape.
  */
 const networkSyncAdapter = exports.networkSyncAdapter = {
-  version: 4,
+  // v5: honest request/responseSize + explicit request/responseBodyOmitted
+  // flags, and a total snapshot budget so the list degrades instead of the
+  // whole panel being dropped at the emit layer.
+  version: 5,
   getSnapshot: () => ({
-    events: _networkEventStore.networkEventStore.getEvents().map(stripLargeBodies),
+    events: fitEventsToBudget(_networkEventStore.networkEventStore.getEvents()),
     /**
      * Response-override rules live on the DEVICE — that's the only place they
      * can run, since a rule is applied inside the app's own XMLHttpRequest.
@@ -178,7 +377,7 @@ const networkSyncAdapter = exports.networkSyncAdapter = {
     // the same 200ms loop that the body-stripping exists to protect.
     saved: _networkSavedStore.networkSavedStore.getRecords().map(record => ({
       ...record,
-      event: stripLargeBodies(record.event)
+      event: toWireEvent(record.event).event
     }))
   }),
   subscribe: onChange => {
@@ -212,7 +411,9 @@ const networkSyncAdapter = exports.networkSyncAdapter = {
       if (!event) return null;
       return {
         requestData: event.requestData ?? null,
-        responseData: event.responseData ?? null
+        responseData: event.responseData ?? null,
+        requestHeaders: event.requestHeaders ?? null,
+        responseHeaders: event.responseHeaders ?? null
       };
     },
     /** Pin/unpin a request from the dashboard. */
@@ -359,6 +560,44 @@ const networkSyncAdapter = exports.networkSyncAdapter = {
       };
     },
     /** Why isn't my rule firing? Reports the engine's own view of the world. */
+    /**
+     * Is the device actually recording right now, and why not?
+     *
+     * The honest answer to an empty request list. Without this a caller can
+     * only guess, and the plausible guesses ("interception is broken on this
+     * runtime") are all wrong — the usual answer is simply that nothing is
+     * holding capture open.
+     */
+    getCaptureStatus: () => {
+      // RECORDING is what the caller actually wants to know, and it is driven
+      // by the store's subscriber count — not by whether the interceptor is
+      // installed. Those genuinely differ: an enabled override rule pins the
+      // interceptor (`overrideRulesStore.syncKeepAlive`) without anything
+      // writing to the event store, so reporting `isNetworkListening()` as
+      // "capturing" would answer "yes" to a device recording nothing. That is
+      // the same species of misleading answer this action exists to replace.
+      const subscribers = _networkEventStore.networkEventStore.getSubscriberCounts().total;
+
+      // `isNetworkListening()` lazily CONSTRUCTS the listener, which reaches
+      // for XMLHttpRequest — absent in Node and in any headless host. A
+      // diagnostic that throws is worse than no diagnostic, so probe
+      // defensively and report what we do know either way.
+      let interceptorInstalled = null;
+      let listenerCount = null;
+      try {
+        interceptorInstalled = (0, _networkListener.isNetworkListening)();
+        listenerCount = (0, _networkListener.getNetworkListenerCount)();
+      } catch {
+        /* no interceptable runtime here */
+      }
+      return {
+        capturing: subscribers > 0,
+        subscribers,
+        interceptorInstalled,
+        listenerCount,
+        eventCount: _networkEventStore.networkEventStore.getEvents().length
+      };
+    },
     debugOverrides: params => {
       const url = (params && typeof params === "object" ? params.url : undefined) ?? "https://example.com/";
       return {

package/lib/module/network/components/NetworkEventDetailView.js

@@ -323,13 +323,17 @@ export const NetworkEventDetailView = /*#__PURE__*/memo(function NetworkEventDet
   // fetched on demand through the resolver. On the device there is no resolver
   // and bodies are always inline, so this is a no-op there.
   const resolveBody = useNetworkBodyResolver();
-  const requestBodyOmitted = event.requestData === undefined && (event.requestSize ?? 0) > 0;
-  const responseBodyOmitted = event.responseData === undefined && (event.responseSize ?? 0) > 0;
+  // The explicit flag is authoritative (adapter v5+). The size>0 fallback keeps
+  // detail-on-demand working against a device on an older adapter, which marked
+  // a withheld body only by leaving `data` undefined with a non-zero size.
+  const requestBodyOmitted = event.requestData === undefined && (event.requestBodyOmitted === true || (event.requestSize ?? 0) > 0);
+  const responseBodyOmitted = event.responseData === undefined && (event.responseBodyOmitted === true || (event.responseSize ?? 0) > 0);
+  const headersOmitted = event.headersOmitted === true;
   const [resolvedBody, setResolvedBody] = useState(null);
   const [isLoadingBody, setIsLoadingBody] = useState(false);
   useEffect(() => {
     setResolvedBody(null);
-    if (!resolveBody || !requestBodyOmitted && !responseBodyOmitted) {
+    if (!resolveBody || !requestBodyOmitted && !responseBodyOmitted && !headersOmitted) {
       setIsLoadingBody(false);
       return;
     }
@@ -343,12 +347,14 @@ export const NetworkEventDetailView = /*#__PURE__*/memo(function NetworkEventDet
     return () => {
       cancelled = true;
     };
-  }, [event.id, resolveBody, requestBodyOmitted, responseBodyOmitted]);
+  }, [event.id, resolveBody, requestBodyOmitted, responseBodyOmitted, headersOmitted]);
 
   // Effective bodies: inline data when present, otherwise the lazily resolved
   // body. `null`/`undefined` both collapse to undefined ("no body").
   const requestData = event.requestData ?? resolvedBody?.requestData ?? undefined;
   const responseData = event.responseData ?? resolvedBody?.responseData ?? undefined;
+  const requestHeaders = (headersOmitted ? resolvedBody?.requestHeaders : undefined) ?? event.requestHeaders;
+  const responseHeaders = (headersOmitted ? resolvedBody?.responseHeaders : undefined) ?? event.responseHeaders;
 
   // Generate full request details for copying
   const getFullRequestDetails = () => {
@@ -359,9 +365,9 @@ export const NetworkEventDetailView = /*#__PURE__*/memo(function NetworkEventDet
       statusText: event.statusText,
       timestamp: new Date(event.timestamp).toISOString(),
       duration: event.duration ? `${event.duration}ms` : "N/A",
-      requestHeaders: event.requestHeaders,
+      requestHeaders,
       requestData,
-      responseHeaders: event.responseHeaders,
+      responseHeaders,
       responseData,
       requestSize: event.requestSize ? formatBytes(event.requestSize) : "N/A",
       responseSize: event.responseSize ? formatBytes(event.responseSize) : "N/A",
@@ -550,12 +556,12 @@ ${JSON.stringify(requestDetails.responseData, null, 2)}
           color: macOSColors.semantic.info
         }),
         defaultOpen: false,
-        count: Object.keys(event.requestHeaders).length,
-        children: Object.keys(event.requestHeaders).length > 0 ? /*#__PURE__*/_jsx(View, {
+        count: Object.keys(requestHeaders).length,
+        children: Object.keys(requestHeaders).length > 0 ? /*#__PURE__*/_jsx(View, {
           style: styles.dataViewerContainer,
           children: /*#__PURE__*/_jsx(DataViewer, {
             title: "",
-            data: event.requestHeaders,
+            data: requestHeaders,
             showTypeFilter: true,
             rawMode: true,
             initialExpanded: true,
@@ -572,12 +578,12 @@ ${JSON.stringify(requestDetails.responseData, null, 2)}
           color: NEUTRAL_ICON
         }),
         defaultOpen: false,
-        count: Object.keys(event.responseHeaders).length,
-        children: Object.keys(event.responseHeaders).length > 0 ? /*#__PURE__*/_jsx(View, {
+        count: Object.keys(responseHeaders).length,
+        children: Object.keys(responseHeaders).length > 0 ? /*#__PURE__*/_jsx(View, {
           style: styles.dataViewerContainer,
           children: /*#__PURE__*/_jsx(DataViewer, {
             title: "",
-            data: event.responseHeaders,
+            data: responseHeaders,
             showTypeFilter: true,
             rawMode: true,
             initialExpanded: true,