@buoy-gg/redux 7.0.9 → 7.0.11

package/lib/commonjs/redux/components/ReduxModal.js

@@ -48,7 +48,8 @@ function ReduxModal({
   onBack,
   onMinimize,
   enableSharedModalDimensions = false,
-  inline = false
+  inline = false,
+  onActionSelect
 }) {
   const isPro = (0, _license.useIsPro)();
   const [showProModal, setShowProModal] = (0, _react.useState)(false);
@@ -93,6 +94,17 @@ function ReduxModal({
 
   // Get selected action from index
   const selectedAction = selectedActionIndex !== null ? visibleActions[selectedActionIndex] : null;
+
+  // Notify the host on selection (keyed by action id so re-renders with the
+  // same selection don't re-fire; remote mirrors fetch state trees here).
+  const lastNotifiedSelectionRef = (0, _react.useRef)(null);
+  (0, _react.useEffect)(() => {
+    if (!onActionSelect) return;
+    const id = selectedAction?.id ?? null;
+    if (id === null || id === lastNotifiedSelectionRef.current) return;
+    lastNotifiedSelectionRef.current = id;
+    onActionSelect(selectedAction);
+  }, [selectedAction, onActionSelect]);
   const [searchText, setSearchText] = (0, _react.useState)("");
   const [isSearchActive, setIsSearchActive] = (0, _react.useState)(false);
   const searchInputRef = (0, _react.useRef)(null);

package/lib/commonjs/redux/sync/reduxSyncAdapter.js

@@ -6,6 +6,15 @@ Object.defineProperty(exports, "__esModule", {
 exports.reduxSyncAdapter = void 0;
 var _reduxActionStore = require("../utils/reduxActionStore");
 var _autoInstrument = require("../utils/autoInstrument");
+/**
+ * Upper bound for one on-demand action-detail response. Generous — this is a
+ * single explicit fetch, not a per-action stream — but still guarded so a
+ * pathological tree can't OOM the device through the reply emit.
+ */
+const MAX_ACTION_DETAIL_BYTES = 8 * 1024 * 1024;
+
+/** Per-action budget for `payload`/`action` on the snapshot wire. */
+const MAX_WIRE_PAYLOAD_BYTES = 16 * 1024;
 /** Top-level slice names of the state tree, for the compact (no-values) view. */
 function topLevelKeys(state) {
   return state && typeof state === "object" && !Array.isArray(state) ? Object.keys(state) : [];
@@ -43,13 +52,82 @@ function unavailable() {
  * action-log snapshot.
  */
 const reduxSyncAdapter = exports.reduxSyncAdapter = {
-  version: 1,
-  getSnapshot: () => _reduxActionStore.reduxActionStore.getActions(),
+  version: 2,
+  /**
+   * WIRE-FORM snapshot: actions WITHOUT raw prevState/nextState trees.
+   * Shipping the trees serialized up to 25×2 full state trees through
+   * socket.emit per action — no guard on that path — which froze and
+   * native-OOM-crashed enterprise-scale apps whenever a dashboard was
+   * connected (root cause confirmed by patch-and-retest). Dashboards fetch
+   * trees on demand via `getActionDetail`; already-evicted entries keep the
+   * eviction sentinel so consumers can distinguish "fetchable" from "gone".
+   */
+  getSnapshot: () => _reduxActionStore.reduxActionStore.getActions().map(a => {
+    const wire = (0, _reduxActionStore.isEvictedState)(a.prevState) ? {
+      ...a
+    } : {
+      ...a,
+      prevState: _reduxActionStore.STATE_ON_DEVICE,
+      nextState: _reduxActionStore.STATE_ON_DEVICE
+    };
+    // A dispatched payload can itself be huge (rehydration actions carry
+    // whole state trees). The list view renders payloadPreview anyway —
+    // oversized payload/action values stay on-device behind markers.
+    if ((0, _reduxActionStore.jsonLongerThan)(wire.payload, MAX_WIRE_PAYLOAD_BYTES)) {
+      wire.payload = _reduxActionStore.PAYLOAD_ON_DEVICE;
+    }
+    if ((0, _reduxActionStore.jsonLongerThan)(wire.action, MAX_WIRE_PAYLOAD_BYTES)) {
+      wire.action = _reduxActionStore.PAYLOAD_ON_DEVICE;
+    }
+    return wire;
+  }),
   subscribe: onChange => _reduxActionStore.reduxActionStore.subscribe(onChange),
   actions: {
     clearEvents: () => {
       _reduxActionStore.reduxActionStore.clearActions();
     },
+    /**
+     * On-demand detail: one action's real prevState/nextState trees.
+     * The per-snapshot stream stays tree-free; this is the explicit,
+     * size-guarded channel for the detail pane.
+     */
+    getActionDetail: params => {
+      const {
+        id
+      } = params ?? {};
+      if (!id) return {
+        found: false,
+        reason: "missing id"
+      };
+      const action = _reduxActionStore.reduxActionStore.getActionById(id);
+      if (!action) return {
+        found: false,
+        reason: "unknown id"
+      };
+      if ((0, _reduxActionStore.isEvictedState)(action.prevState)) {
+        return {
+          found: true,
+          id,
+          evicted: true,
+          reason: `Raw state was evicted (retained for recent actions only).`
+        };
+      }
+      // Per-field cap: oversized fields degrade individually instead of
+      // failing the whole detail (a giant payload shouldn't hide the trees).
+      const cappedNote = {
+        __buoyTruncated: true,
+        note: `Exceeds the ${MAX_ACTION_DETAIL_BYTES / (1024 * 1024)}MB detail limit — inspect it on-device.`
+      };
+      const cap = value => (0, _reduxActionStore.jsonLongerThan)(value, MAX_ACTION_DETAIL_BYTES) ? cappedNote : value;
+      return {
+        found: true,
+        id,
+        prevState: cap(action.prevState),
+        nextState: cap(action.nextState),
+        payload: cap(action.payload),
+        action: cap(action.action)
+      };
+    },
     /**
      * Compact current-state reader: the instrumented store's slice names, and
      * the full state tree only when `includeValues` is set (heavy).

package/lib/commonjs/redux/utils/autoInstrument.js

@@ -198,6 +198,10 @@ let warnedJumpUnsupported = false;
  * that and warn once instead of pretending it worked.
  */
 function jumpToState(state) {
+  if ((0, _reduxActionStore.isEvictedState)(state)) {
+    console.warn("[BuoyRedux] Cannot jump - this action's state was evicted (raw state is retained for recent actions only)");
+    return;
+  }
   const store = (0, _activeStoreRegistry.getActiveStore)();
   if (!store) {
     console.warn("[BuoyRedux] Cannot jump to state - no store instrumented");

package/lib/commonjs/redux/utils/buoyReduxMiddleware.js

@@ -56,6 +56,10 @@ const BUOY_REPLAY_ACTION = exports.BUOY_REPLAY_ACTION = "@@buoy/REPLAY_ACTION";
  * which silently broke the modal's Jump button on the zero-config path.
  */
 function jumpToState(state) {
+  if ((0, _reduxActionStore.isEvictedState)(state)) {
+    console.warn("[BuoyRedux] Cannot jump - this action's state was evicted (raw state is retained for recent actions only)");
+    return;
+  }
   const store = (0, _activeStoreRegistry.getActiveStore)();
   if (store) {
     store.dispatch({

package/lib/commonjs/redux/utils/reduxActionStore.js

@@ -3,11 +3,65 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
+exports.STATE_RETENTION_LIMIT = exports.STATE_ON_DEVICE = exports.STATE_EVICTED = exports.PAYLOAD_ON_DEVICE = void 0;
+exports.isEvictedState = isEvictedState;
+exports.jsonLongerThan = jsonLongerThan;
 exports.reduxActionStore = void 0;
 /**
  * Redux action store - captures and stores Redux Toolkit actions
  */
 
+/**
+ * How many of the most-recent actions keep their raw prevState/nextState
+ * trees. Older actions keep all diff metadata but their trees are replaced
+ * with STATE_EVICTED so a store switch can't pin hundreds of MB.
+ */
+const STATE_RETENTION_LIMIT = exports.STATE_RETENTION_LIMIT = 25;
+
+/**
+ * Sentinel installed in place of evicted state trees. A frozen plain object
+ * so existing detail viewers render it harmlessly; jumpToState refuses it.
+ */
+const STATE_EVICTED = exports.STATE_EVICTED = Object.freeze({
+  __buoyStateEvicted: true,
+  note: `Raw state retained for the ${STATE_RETENTION_LIMIT} most recent actions only.`
+});
+
+/**
+ * Sentinel used in WIRE-FORM snapshots (sync to desktop/MCP) in place of raw
+ * prevState/nextState trees. Unlike STATE_EVICTED the trees still exist on
+ * the device — dashboards fetch them on demand via the adapter's
+ * `getActionDetail` action. Shipping them in every snapshot serialized up to
+ * 25×2 full state trees through socket.emit per action (no guard), which
+ * froze and native-OOM-crashed enterprise-scale apps whenever a dashboard
+ * was connected (confirmed by patch-and-retest on the affected app).
+ */
+const STATE_ON_DEVICE = exports.STATE_ON_DEVICE = Object.freeze({
+  __buoyStateOnDevice: true,
+  note: "State trees stay on the device — fetched on demand via getActionDetail."
+});
+
+/**
+ * Wire-form sentinel for an oversized action `payload`/`action`. A dispatched
+ * payload can itself be huge (rehydration actions carry the whole new state),
+ * so the per-snapshot stream ships `payloadPreview` + this marker instead;
+ * `getActionDetail` serves the real value on demand.
+ */
+const PAYLOAD_ON_DEVICE = exports.PAYLOAD_ON_DEVICE = Object.freeze({
+  __buoyPayloadOnDevice: true,
+  note: "Payload stays on the device — fetched on demand via getActionDetail."
+});
+
+/**
+ * True when a value is one of the state sentinels (evicted or on-device) —
+ * guards time travel and any consumer that needs a REAL tree.
+ */
+function isEvictedState(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const v = value;
+  return v.__buoyStateEvicted === true || v.__buoyStateOnDevice === true;
+}
+
 // ============================================
 // Helper Functions for Enhanced Data
 // ============================================
@@ -60,6 +114,39 @@ function parseActionType(type) {
   };
 }
 
+/**
+ * Cheap early-abort size probe: is `value`'s JSON form definitely longer than
+ * `limit`? Bails the moment the running estimate exceeds the limit, so the
+ * cost is O(limit) — never O(payload). Used to avoid JSON.stringify-ing large
+ * payloads (a fulfilled thunk's payload can be megabytes) just to produce a
+ * 40-char preview; that full stringify ran on EVERY dispatch and blocked the
+ * JS thread at enterprise state sizes.
+ */
+function jsonLongerThan(value, limit) {
+  let bytes = 0;
+  const stack = [value];
+  const seen = new Set();
+  while (stack.length > 0) {
+    if (bytes > limit) return true;
+    const v = stack.pop();
+    if (v === null || v === undefined) bytes += 4;else if (typeof v === "string") bytes += v.length + 2;else if (typeof v === "number") bytes += 8;else if (typeof v === "boolean") bytes += 5;else if (typeof v === "object") {
+      if (seen.has(v)) continue;
+      seen.add(v);
+      if (Array.isArray(v)) {
+        bytes += 2 + v.length;
+        for (let i = 0; i < v.length; i++) stack.push(v[i]);
+      } else {
+        bytes += 2;
+        for (const k in v) {
+          bytes += k.length + 4;
+          stack.push(v[k]);
+        }
+      }
+    } else bytes += 4;
+  }
+  return bytes > limit;
+}
+
 /**
  * Format payload preview for display
  */
@@ -75,6 +162,8 @@ function formatPayloadPreview(payload, maxLength = 40) {
     }
     if (Array.isArray(payload)) {
       if (payload.length === 0) return "[]";
+      // Probe cheaply first — only stringify payloads that can actually fit.
+      if (jsonLongerThan(payload, maxLength)) return `[${payload.length} items]`;
       const preview = JSON.stringify(payload);
       return preview.length > maxLength ? `[${payload.length} items]` : preview;
     }
@@ -82,7 +171,8 @@ function formatPayloadPreview(payload, maxLength = 40) {
       const keys = Object.keys(payload);
       if (keys.length === 0) return "{}";
 
-      // Try to create a meaningful preview
+      // Probe cheaply first — only stringify payloads that can actually fit.
+      if (jsonLongerThan(payload, maxLength)) return `{ ${keys.length} keys }`;
       const preview = JSON.stringify(payload);
       if (preview.length <= maxLength) return preview;
 
@@ -218,6 +308,23 @@ class ReduxActionStore {
       isSlowAction
     };
     this.actions = [reduxAction, ...this.actions].slice(0, this.maxActions);
+
+    // Bound raw-state retention. Every action holds prevState/nextState by
+    // reference; with structural sharing that's normally cheap, but when a
+    // host replaces large slices wholesale (store switch / rehydration),
+    // each retained action pins a DISTINCT multi-MB subtree — measured 88MB
+    // pinned by 50 slice-replacing actions, enough to OOM-kill enterprise
+    // apps. Detail view + time travel realistically use recent actions, so
+    // older ones keep their diff metadata but drop the raw trees.
+    for (let i = STATE_RETENTION_LIMIT; i < this.actions.length; i++) {
+      const a = this.actions[i];
+      if (a.prevState !== STATE_EVICTED) {
+        a.prevState = STATE_EVICTED;
+        a.nextState = STATE_EVICTED;
+      } else {
+        break; // older entries already evicted (list is newest-first)
+      }
+    }
     this.notifyListeners();
   }
   getActions() {
@@ -280,7 +387,39 @@ class ReduxActionStore {
     if (!this.isEnabled) {
       return;
     }
-    this.actions = actions.slice(0, this.maxActions);
+    // Preserve any trees a remote mirror already hydrated via
+    // replaceActionStates — wire-form snapshots always carry markers, and a
+    // full snapshot arriving after a detail fetch must not blank the detail
+    // pane back out.
+    const hydrated = new Map();
+    for (const existing of this.actions) {
+      if (existing.prevState !== undefined && !isEvictedState(existing.prevState)) {
+        hydrated.set(existing.id, existing);
+      }
+    }
+    this.actions = actions.slice(0, this.maxActions).map(a => {
+      const h = hydrated.get(a.id);
+      return h && isEvictedState(a.prevState) ? {
+        ...a,
+        prevState: h.prevState,
+        nextState: h.nextState
+      } : a;
+    });
+    this.notifyListeners();
+  }
+
+  /**
+   * Hydrate one mirrored action with real values (state trees, payload,
+   * action) fetched on demand from the device via the adapter's
+   * `getActionDetail` action. Remote-mirror (desktop) use only.
+   */
+  hydrateAction(id, patch) {
+    const index = this.actions.findIndex(a => a.id === id);
+    if (index === -1) return;
+    this.actions = [...this.actions.slice(0, index), {
+      ...this.actions[index],
+      ...patch
+    }, ...this.actions.slice(index + 1)];
     this.notifyListeners();
   }
   setEnabled(enabled) {

package/lib/module/redux/components/ReduxModal.js

@@ -7,7 +7,7 @@
  * providing zero-config action capture for the DevTools.
  */
 
-import { useState, useMemo, useRef, useCallback } from "react";
+import { useState, useMemo, useRef, useCallback, useEffect } from "react";
 import { View, Text, StyleSheet, FlatList, TextInput, TouchableOpacity } from "react-native";
 import { JsModal, ModalHeader, macOSColors, buoyColors, Search, Trash2, Power, X, Zap, CheckCircle, Copy, Lock, AlertTriangle, devToolsStorageKeys, copyToClipboard, ProUpgradeModal, PowerToggleButton, TickProvider } from "@buoy-gg/shared-ui";
 import { useIsPro } from "@buoy-gg/license";
@@ -42,7 +42,8 @@ export function ReduxModal({
   onBack,
   onMinimize,
   enableSharedModalDimensions = false,
-  inline = false
+  inline = false,
+  onActionSelect
 }) {
   const isPro = useIsPro();
   const [showProModal, setShowProModal] = useState(false);
@@ -87,6 +88,17 @@ export function ReduxModal({
 
   // Get selected action from index
   const selectedAction = selectedActionIndex !== null ? visibleActions[selectedActionIndex] : null;
+
+  // Notify the host on selection (keyed by action id so re-renders with the
+  // same selection don't re-fire; remote mirrors fetch state trees here).
+  const lastNotifiedSelectionRef = useRef(null);
+  useEffect(() => {
+    if (!onActionSelect) return;
+    const id = selectedAction?.id ?? null;
+    if (id === null || id === lastNotifiedSelectionRef.current) return;
+    lastNotifiedSelectionRef.current = id;
+    onActionSelect(selectedAction);
+  }, [selectedAction, onActionSelect]);
   const [searchText, setSearchText] = useState("");
   const [isSearchActive, setIsSearchActive] = useState(false);
   const searchInputRef = useRef(null);

package/lib/module/redux/sync/reduxSyncAdapter.js

@@ -1,7 +1,17 @@
 "use strict";
 
-import { reduxActionStore } from "../utils/reduxActionStore";
+import { reduxActionStore, STATE_ON_DEVICE, PAYLOAD_ON_DEVICE, isEvictedState, jsonLongerThan } from "../utils/reduxActionStore";
 import { getActiveStore, getInstrumentationStatus } from "../utils/autoInstrument";
+
+/**
+ * Upper bound for one on-demand action-detail response. Generous — this is a
+ * single explicit fetch, not a per-action stream — but still guarded so a
+ * pathological tree can't OOM the device through the reply emit.
+ */
+const MAX_ACTION_DETAIL_BYTES = 8 * 1024 * 1024;
+
+/** Per-action budget for `payload`/`action` on the snapshot wire. */
+const MAX_WIRE_PAYLOAD_BYTES = 16 * 1024;
 /** Top-level slice names of the state tree, for the compact (no-values) view. */
 function topLevelKeys(state) {
   return state && typeof state === "object" && !Array.isArray(state) ? Object.keys(state) : [];
@@ -39,13 +49,82 @@ function unavailable() {
  * action-log snapshot.
  */
 export const reduxSyncAdapter = {
-  version: 1,
-  getSnapshot: () => reduxActionStore.getActions(),
+  version: 2,
+  /**
+   * WIRE-FORM snapshot: actions WITHOUT raw prevState/nextState trees.
+   * Shipping the trees serialized up to 25×2 full state trees through
+   * socket.emit per action — no guard on that path — which froze and
+   * native-OOM-crashed enterprise-scale apps whenever a dashboard was
+   * connected (root cause confirmed by patch-and-retest). Dashboards fetch
+   * trees on demand via `getActionDetail`; already-evicted entries keep the
+   * eviction sentinel so consumers can distinguish "fetchable" from "gone".
+   */
+  getSnapshot: () => reduxActionStore.getActions().map(a => {
+    const wire = isEvictedState(a.prevState) ? {
+      ...a
+    } : {
+      ...a,
+      prevState: STATE_ON_DEVICE,
+      nextState: STATE_ON_DEVICE
+    };
+    // A dispatched payload can itself be huge (rehydration actions carry
+    // whole state trees). The list view renders payloadPreview anyway —
+    // oversized payload/action values stay on-device behind markers.
+    if (jsonLongerThan(wire.payload, MAX_WIRE_PAYLOAD_BYTES)) {
+      wire.payload = PAYLOAD_ON_DEVICE;
+    }
+    if (jsonLongerThan(wire.action, MAX_WIRE_PAYLOAD_BYTES)) {
+      wire.action = PAYLOAD_ON_DEVICE;
+    }
+    return wire;
+  }),
   subscribe: onChange => reduxActionStore.subscribe(onChange),
   actions: {
     clearEvents: () => {
       reduxActionStore.clearActions();
     },
+    /**
+     * On-demand detail: one action's real prevState/nextState trees.
+     * The per-snapshot stream stays tree-free; this is the explicit,
+     * size-guarded channel for the detail pane.
+     */
+    getActionDetail: params => {
+      const {
+        id
+      } = params ?? {};
+      if (!id) return {
+        found: false,
+        reason: "missing id"
+      };
+      const action = reduxActionStore.getActionById(id);
+      if (!action) return {
+        found: false,
+        reason: "unknown id"
+      };
+      if (isEvictedState(action.prevState)) {
+        return {
+          found: true,
+          id,
+          evicted: true,
+          reason: `Raw state was evicted (retained for recent actions only).`
+        };
+      }
+      // Per-field cap: oversized fields degrade individually instead of
+      // failing the whole detail (a giant payload shouldn't hide the trees).
+      const cappedNote = {
+        __buoyTruncated: true,
+        note: `Exceeds the ${MAX_ACTION_DETAIL_BYTES / (1024 * 1024)}MB detail limit — inspect it on-device.`
+      };
+      const cap = value => jsonLongerThan(value, MAX_ACTION_DETAIL_BYTES) ? cappedNote : value;
+      return {
+        found: true,
+        id,
+        prevState: cap(action.prevState),
+        nextState: cap(action.nextState),
+        payload: cap(action.payload),
+        action: cap(action.action)
+      };
+    },
     /**
      * Compact current-state reader: the instrumented store's slice names, and
      * the full state tree only when `includeValues` is set (heavy).

package/lib/module/redux/utils/autoInstrument.js

@@ -15,7 +15,7 @@
  * capture as "top-level-only" — see activeStoreRegistry.getInstrumentationStatus.
  */
 
-import { reduxActionStore } from "./reduxActionStore";
+import { reduxActionStore, isEvictedState } from "./reduxActionStore";
 import { BUOY_JUMP_TO_STATE, isMiddlewareActive } from "./buoyReduxMiddleware";
 import { registerActiveStore, unregisterActiveStore, getActiveStore as getRegisteredStore, ENHANCER_SYMBOL } from "./activeStoreRegistry";
 
@@ -183,6 +183,10 @@ let warnedJumpUnsupported = false;
  * that and warn once instead of pretending it worked.
  */
 export function jumpToState(state) {
+  if (isEvictedState(state)) {
+    console.warn("[BuoyRedux] Cannot jump - this action's state was evicted (raw state is retained for recent actions only)");
+    return;
+  }
   const store = getRegisteredStore();
   if (!store) {
     console.warn("[BuoyRedux] Cannot jump to state - no store instrumented");

package/lib/module/redux/utils/buoyReduxMiddleware.js

@@ -16,7 +16,7 @@
  * ```
  */
 
-import { reduxActionStore } from "./reduxActionStore";
+import { reduxActionStore, isEvictedState } from "./reduxActionStore";
 import { registerActiveStore, getActiveStore } from "./activeStoreRegistry";
 
 // ============================================
@@ -48,6 +48,10 @@ export const BUOY_REPLAY_ACTION = "@@buoy/REPLAY_ACTION";
  * which silently broke the modal's Jump button on the zero-config path.
  */
 export function jumpToState(state) {
+  if (isEvictedState(state)) {
+    console.warn("[BuoyRedux] Cannot jump - this action's state was evicted (raw state is retained for recent actions only)");
+    return;
+  }
   const store = getActiveStore();
   if (store) {
     store.dispatch({

package/lib/module/redux/utils/reduxActionStore.js

@@ -4,6 +4,57 @@
  * Redux action store - captures and stores Redux Toolkit actions
  */
 
+/**
+ * How many of the most-recent actions keep their raw prevState/nextState
+ * trees. Older actions keep all diff metadata but their trees are replaced
+ * with STATE_EVICTED so a store switch can't pin hundreds of MB.
+ */
+export const STATE_RETENTION_LIMIT = 25;
+
+/**
+ * Sentinel installed in place of evicted state trees. A frozen plain object
+ * so existing detail viewers render it harmlessly; jumpToState refuses it.
+ */
+export const STATE_EVICTED = Object.freeze({
+  __buoyStateEvicted: true,
+  note: `Raw state retained for the ${STATE_RETENTION_LIMIT} most recent actions only.`
+});
+
+/**
+ * Sentinel used in WIRE-FORM snapshots (sync to desktop/MCP) in place of raw
+ * prevState/nextState trees. Unlike STATE_EVICTED the trees still exist on
+ * the device — dashboards fetch them on demand via the adapter's
+ * `getActionDetail` action. Shipping them in every snapshot serialized up to
+ * 25×2 full state trees through socket.emit per action (no guard), which
+ * froze and native-OOM-crashed enterprise-scale apps whenever a dashboard
+ * was connected (confirmed by patch-and-retest on the affected app).
+ */
+export const STATE_ON_DEVICE = Object.freeze({
+  __buoyStateOnDevice: true,
+  note: "State trees stay on the device — fetched on demand via getActionDetail."
+});
+
+/**
+ * Wire-form sentinel for an oversized action `payload`/`action`. A dispatched
+ * payload can itself be huge (rehydration actions carry the whole new state),
+ * so the per-snapshot stream ships `payloadPreview` + this marker instead;
+ * `getActionDetail` serves the real value on demand.
+ */
+export const PAYLOAD_ON_DEVICE = Object.freeze({
+  __buoyPayloadOnDevice: true,
+  note: "Payload stays on the device — fetched on demand via getActionDetail."
+});
+
+/**
+ * True when a value is one of the state sentinels (evicted or on-device) —
+ * guards time travel and any consumer that needs a REAL tree.
+ */
+export function isEvictedState(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const v = value;
+  return v.__buoyStateEvicted === true || v.__buoyStateOnDevice === true;
+}
+
 // ============================================
 // Helper Functions for Enhanced Data
 // ============================================
@@ -56,6 +107,39 @@ function parseActionType(type) {
   };
 }
 
+/**
+ * Cheap early-abort size probe: is `value`'s JSON form definitely longer than
+ * `limit`? Bails the moment the running estimate exceeds the limit, so the
+ * cost is O(limit) — never O(payload). Used to avoid JSON.stringify-ing large
+ * payloads (a fulfilled thunk's payload can be megabytes) just to produce a
+ * 40-char preview; that full stringify ran on EVERY dispatch and blocked the
+ * JS thread at enterprise state sizes.
+ */
+export function jsonLongerThan(value, limit) {
+  let bytes = 0;
+  const stack = [value];
+  const seen = new Set();
+  while (stack.length > 0) {
+    if (bytes > limit) return true;
+    const v = stack.pop();
+    if (v === null || v === undefined) bytes += 4;else if (typeof v === "string") bytes += v.length + 2;else if (typeof v === "number") bytes += 8;else if (typeof v === "boolean") bytes += 5;else if (typeof v === "object") {
+      if (seen.has(v)) continue;
+      seen.add(v);
+      if (Array.isArray(v)) {
+        bytes += 2 + v.length;
+        for (let i = 0; i < v.length; i++) stack.push(v[i]);
+      } else {
+        bytes += 2;
+        for (const k in v) {
+          bytes += k.length + 4;
+          stack.push(v[k]);
+        }
+      }
+    } else bytes += 4;
+  }
+  return bytes > limit;
+}
+
 /**
  * Format payload preview for display
  */
@@ -71,6 +155,8 @@ function formatPayloadPreview(payload, maxLength = 40) {
     }
     if (Array.isArray(payload)) {
       if (payload.length === 0) return "[]";
+      // Probe cheaply first — only stringify payloads that can actually fit.
+      if (jsonLongerThan(payload, maxLength)) return `[${payload.length} items]`;
       const preview = JSON.stringify(payload);
       return preview.length > maxLength ? `[${payload.length} items]` : preview;
     }
@@ -78,7 +164,8 @@ function formatPayloadPreview(payload, maxLength = 40) {
       const keys = Object.keys(payload);
       if (keys.length === 0) return "{}";
 
-      // Try to create a meaningful preview
+      // Probe cheaply first — only stringify payloads that can actually fit.
+      if (jsonLongerThan(payload, maxLength)) return `{ ${keys.length} keys }`;
       const preview = JSON.stringify(payload);
       if (preview.length <= maxLength) return preview;
 
@@ -214,6 +301,23 @@ class ReduxActionStore {
       isSlowAction
     };
     this.actions = [reduxAction, ...this.actions].slice(0, this.maxActions);
+
+    // Bound raw-state retention. Every action holds prevState/nextState by
+    // reference; with structural sharing that's normally cheap, but when a
+    // host replaces large slices wholesale (store switch / rehydration),
+    // each retained action pins a DISTINCT multi-MB subtree — measured 88MB
+    // pinned by 50 slice-replacing actions, enough to OOM-kill enterprise
+    // apps. Detail view + time travel realistically use recent actions, so
+    // older ones keep their diff metadata but drop the raw trees.
+    for (let i = STATE_RETENTION_LIMIT; i < this.actions.length; i++) {
+      const a = this.actions[i];
+      if (a.prevState !== STATE_EVICTED) {
+        a.prevState = STATE_EVICTED;
+        a.nextState = STATE_EVICTED;
+      } else {
+        break; // older entries already evicted (list is newest-first)
+      }
+    }
     this.notifyListeners();
   }
   getActions() {
@@ -276,7 +380,39 @@ class ReduxActionStore {
     if (!this.isEnabled) {
       return;
     }
-    this.actions = actions.slice(0, this.maxActions);
+    // Preserve any trees a remote mirror already hydrated via
+    // replaceActionStates — wire-form snapshots always carry markers, and a
+    // full snapshot arriving after a detail fetch must not blank the detail
+    // pane back out.
+    const hydrated = new Map();
+    for (const existing of this.actions) {
+      if (existing.prevState !== undefined && !isEvictedState(existing.prevState)) {
+        hydrated.set(existing.id, existing);
+      }
+    }
+    this.actions = actions.slice(0, this.maxActions).map(a => {
+      const h = hydrated.get(a.id);
+      return h && isEvictedState(a.prevState) ? {
+        ...a,
+        prevState: h.prevState,
+        nextState: h.nextState
+      } : a;
+    });
+    this.notifyListeners();
+  }
+
+  /**
+   * Hydrate one mirrored action with real values (state trees, payload,
+   * action) fetched on demand from the device via the adapter's
+   * `getActionDetail` action. Remote-mirror (desktop) use only.
+   */
+  hydrateAction(id, patch) {
+    const index = this.actions.findIndex(a => a.id === id);
+    if (index === -1) return;
+    this.actions = [...this.actions.slice(0, index), {
+      ...this.actions[index],
+      ...patch
+    }, ...this.actions.slice(index + 1)];
     this.notifyListeners();
   }
   setEnabled(enabled) {

package/lib/typescript/redux/components/ReduxModal.d.ts

@@ -4,6 +4,7 @@
  * This component auto-instruments the Redux store when it mounts,
  * providing zero-config action capture for the DevTools.
  */
+import type { ReduxAction } from "../types";
 /** Free tier limit for action history */
 export declare const FREE_TIER_ACTION_LIMIT = 25;
 interface ReduxModalProps {
@@ -19,8 +20,14 @@ interface ReduxModalProps {
     onBack?: () => void;
     onMinimize?: (modalState: unknown) => void;
     enableSharedModalDimensions?: boolean;
+    /**
+     * Fired when the user selects an action (opens its detail view). Remote
+     * mirrors (Buoy Desktop) use this to fetch the action's real state trees
+     * on demand — wire-form snapshots carry markers instead of trees.
+     */
+    onActionSelect?: (action: ReduxAction) => void;
 }
-export declare function ReduxModal({ visible, onClose, onBack, onMinimize, enableSharedModalDimensions, inline, }: ReduxModalProps): import("react").JSX.Element | null;
+export declare function ReduxModal({ visible, onClose, onBack, onMinimize, enableSharedModalDimensions, inline, onActionSelect, }: ReduxModalProps): import("react").JSX.Element | null;
 /**
  * The same Redux tool as `ReduxModal`, rendered INLINE for hosts that place
  * tools in a panel rather than a modal. Exists so there is exactly one

package/lib/typescript/redux/components/ReduxModal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ReduxModal.d.ts","sourceRoot":"","sources":["../../../../src/redux/components/ReduxModal.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AA2CH,yCAAyC;AACzC,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC,UAAU,eAAe;IACvB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,UAAU,CAAC,EAAE,CAAC,UAAU,EAAE,OAAO,KAAK,IAAI,CAAC;IAC3C,2BAA2B,CAAC,EAAE,OAAO,CAAC;CACvC;AAgBD,wBAAgB,UAAU,CAAC,EACzB,OAAO,EACP,OAAO,EACP,MAAM,EACN,UAAU,EACV,2BAAmC,EACnC,MAAc,GACf,EAAE,eAAe,sCAwajB;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,KAAK,GAAE,IAAI,CAAC,eAAe,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAM,+BAGpE"}
+{"version":3,"file":"ReduxModal.d.ts","sourceRoot":"","sources":["../../../../src/redux/components/ReduxModal.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAyCH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C,yCAAyC;AACzC,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC,UAAU,eAAe;IACvB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,UAAU,CAAC,EAAE,CAAC,UAAU,EAAE,OAAO,KAAK,IAAI,CAAC;IAC3C,2BAA2B,CAAC,EAAE,OAAO,CAAC;IACtC;;;;OAIG;IACH,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAC;CAChD;AAgBD,wBAAgB,UAAU,CAAC,EACzB,OAAO,EACP,OAAO,EACP,MAAM,EACN,UAAU,EACV,2BAAmC,EACnC,MAAc,EACd,cAAc,GACf,EAAE,eAAe,sCAmbjB;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,KAAK,GAAE,IAAI,CAAC,eAAe,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAM,+BAGpE"}

package/lib/typescript/redux/sync/reduxSyncAdapter.d.ts

@@ -16,10 +16,71 @@
  */
 export declare const reduxSyncAdapter: {
     version: number;
-    getSnapshot: () => import("../types").ReduxAction[];
+    /**
+     * WIRE-FORM snapshot: actions WITHOUT raw prevState/nextState trees.
+     * Shipping the trees serialized up to 25×2 full state trees through
+     * socket.emit per action — no guard on that path — which froze and
+     * native-OOM-crashed enterprise-scale apps whenever a dashboard was
+     * connected (root cause confirmed by patch-and-retest). Dashboards fetch
+     * trees on demand via `getActionDetail`; already-evicted entries keep the
+     * eviction sentinel so consumers can distinguish "fetchable" from "gone".
+     */
+    getSnapshot: () => {
+        id: string;
+        type: string;
+        payload?: unknown;
+        action: Record<string, unknown>;
+        timestamp: number;
+        prevState: unknown;
+        nextState: unknown;
+        duration?: number;
+        hasStateChange: boolean;
+        category: import("../types").ActionCategory;
+        sliceName: string | null;
+        actionName: string;
+        meta?: import("../types").ActionMeta;
+        error?: unknown;
+        payloadPreview: string;
+        diffSummary: string;
+        changedKeysCount: number;
+        isSlowAction: boolean;
+    }[];
     subscribe: (onChange: () => void) => () => void;
     actions: {
         clearEvents: () => void;
+        /**
+         * On-demand detail: one action's real prevState/nextState trees.
+         * The per-snapshot stream stays tree-free; this is the explicit,
+         * size-guarded channel for the detail pane.
+         */
+        getActionDetail: (params: unknown) => {
+            found: false;
+            reason: string;
+            id?: undefined;
+            evicted?: undefined;
+            prevState?: undefined;
+            nextState?: undefined;
+            payload?: undefined;
+            action?: undefined;
+        } | {
+            found: true;
+            id: string;
+            evicted: true;
+            reason: string;
+            prevState?: undefined;
+            nextState?: undefined;
+            payload?: undefined;
+            action?: undefined;
+        } | {
+            found: true;
+            id: string;
+            prevState: unknown;
+            nextState: unknown;
+            payload: unknown;
+            action: unknown;
+            reason?: undefined;
+            evicted?: undefined;
+        };
         /**
          * Compact current-state reader: the instrumented store's slice names, and
          * the full state tree only when `includeValues` is set (heavy).

package/lib/typescript/redux/sync/reduxSyncAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reduxSyncAdapter.d.ts","sourceRoot":"","sources":["../../../../src/redux/sync/reduxSyncAdapter.ts"],"names":[],"mappings":"AAsCA;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,gBAAgB;;;0BAGL,MAAM,IAAI;;;QAK9B;;;WAGG;2BACgB,OAAO;;oBAlCZ,MAAM,EAAE;YACtB,4DAA4D;;;;;;YA6CxD,wEAAwE;;;;QAM5E,gEAAgE;2BAC7C,OAAO;;oBArDZ,MAAM,EAAE;YACtB,4DAA4D;;;;;;;;;CA8D/D,CAAC"}
+{"version":3,"file":"reduxSyncAdapter.d.ts","sourceRoot":"","sources":["../../../../src/redux/sync/reduxSyncAdapter.ts"],"names":[],"mappings":"AAsDA;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,gBAAgB;;IAE3B;;;;;;;;OAQG;;;;;;;;;;;;;;;;;;;;;0BAiBmB,MAAM,IAAI;;;QAK9B;;;;WAIG;kCACuB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;QA8BjC;;;WAGG;2BACgB,OAAO;;oBA7FZ,MAAM,EAAE;YACtB,4DAA4D;;;;;;YAwGxD,wEAAwE;;;;QAM5E,gEAAgE;2BAC7C,OAAO;;oBAhHZ,MAAM,EAAE;YACtB,4DAA4D;;;;;;;;;CAyH/D,CAAC"}

package/lib/typescript/redux/utils/autoInstrument.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"autoInstrument.d.ts","sourceRoot":"","sources":["../../../../src/redux/utils/autoInstrument.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAG7D,OAAO,EAKL,KAAK,gBAAgB,EACtB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,wBAAwB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,GACtB,MAAM,uBAAuB,CAAC;AAsB/B,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6BAA6B;IAC7B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAMD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAGzD;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,KAAK,EACZ,OAAO,GAAE,qBAA0B,GAClC,MAAM,IAAI,CAuFZ;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAapD;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,KAAK,EACZ,OAAO,GAAE,qBAA0B,GAClC,MAAM,IAAI,CAEZ;AASD;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAoBhD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAOxD;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,IAAI,gBAAgB,GAAG,IAAI,CAExD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD"}
+{"version":3,"file":"autoInstrument.d.ts","sourceRoot":"","sources":["../../../../src/redux/utils/autoInstrument.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAG7D,OAAO,EAKL,KAAK,gBAAgB,EACtB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,wBAAwB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,GACtB,MAAM,uBAAuB,CAAC;AAsB/B,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6BAA6B;IAC7B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAMD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAGzD;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,KAAK,EACZ,OAAO,GAAE,qBAA0B,GAClC,MAAM,IAAI,CAuFZ;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAapD;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,KAAK,EACZ,OAAO,GAAE,qBAA0B,GAClC,MAAM,IAAI,CAEZ;AASD;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CA0BhD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAOxD;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,IAAI,gBAAgB,GAAG,IAAI,CAExD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD"}

package/lib/typescript/redux/utils/buoyReduxMiddleware.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"buoyReduxMiddleware.d.ts","sourceRoot":"","sources":["../../../../src/redux/utils/buoyReduxMiddleware.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,UAAU,CAAC;AAc3D;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAE5C;AAMD,eAAO,MAAM,kBAAkB,yBAAyB,CAAC;AACzD,eAAO,MAAM,kBAAkB,yBAAyB,CAAC;AAczD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAOhD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAOxD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAWnE;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,UA4BjC,CAAC;AAEF;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,GAAE,0BAA+B,GACvC,UAAU,CAoCZ"}
+{"version":3,"file":"buoyReduxMiddleware.d.ts","sourceRoot":"","sources":["../../../../src/redux/utils/buoyReduxMiddleware.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,UAAU,CAAC;AAc3D;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAE5C;AAMD,eAAO,MAAM,kBAAkB,yBAAyB,CAAC;AACzD,eAAO,MAAM,kBAAkB,yBAAyB,CAAC;AAczD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAahD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAOxD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAWnE;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,UA4BjC,CAAC;AAEF;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,GAAE,0BAA+B,GACvC,UAAU,CAoCZ"}

package/lib/typescript/redux/utils/reduxActionStore.d.ts

@@ -2,6 +2,57 @@
  * Redux action store - captures and stores Redux Toolkit actions
  */
 import type { ReduxAction, ReduxFilter } from "../types";
+/**
+ * How many of the most-recent actions keep their raw prevState/nextState
+ * trees. Older actions keep all diff metadata but their trees are replaced
+ * with STATE_EVICTED so a store switch can't pin hundreds of MB.
+ */
+export declare const STATE_RETENTION_LIMIT = 25;
+/**
+ * Sentinel installed in place of evicted state trees. A frozen plain object
+ * so existing detail viewers render it harmlessly; jumpToState refuses it.
+ */
+export declare const STATE_EVICTED: Readonly<{
+    __buoyStateEvicted: true;
+    note: "Raw state retained for the 25 most recent actions only.";
+}>;
+/**
+ * Sentinel used in WIRE-FORM snapshots (sync to desktop/MCP) in place of raw
+ * prevState/nextState trees. Unlike STATE_EVICTED the trees still exist on
+ * the device — dashboards fetch them on demand via the adapter's
+ * `getActionDetail` action. Shipping them in every snapshot serialized up to
+ * 25×2 full state trees through socket.emit per action (no guard), which
+ * froze and native-OOM-crashed enterprise-scale apps whenever a dashboard
+ * was connected (confirmed by patch-and-retest on the affected app).
+ */
+export declare const STATE_ON_DEVICE: Readonly<{
+    __buoyStateOnDevice: true;
+    note: "State trees stay on the device — fetched on demand via getActionDetail.";
+}>;
+/**
+ * Wire-form sentinel for an oversized action `payload`/`action`. A dispatched
+ * payload can itself be huge (rehydration actions carry the whole new state),
+ * so the per-snapshot stream ships `payloadPreview` + this marker instead;
+ * `getActionDetail` serves the real value on demand.
+ */
+export declare const PAYLOAD_ON_DEVICE: Readonly<{
+    __buoyPayloadOnDevice: true;
+    note: "Payload stays on the device — fetched on demand via getActionDetail.";
+}>;
+/**
+ * True when a value is one of the state sentinels (evicted or on-device) —
+ * guards time travel and any consumer that needs a REAL tree.
+ */
+export declare function isEvictedState(value: unknown): boolean;
+/**
+ * Cheap early-abort size probe: is `value`'s JSON form definitely longer than
+ * `limit`? Bails the moment the running estimate exceeds the limit, so the
+ * cost is O(limit) — never O(payload). Used to avoid JSON.stringify-ing large
+ * payloads (a fulfilled thunk's payload can be megabytes) just to produce a
+ * 40-char preview; that full stringify ran on EVERY dispatch and blocked the
+ * JS thread at enterprise state sizes.
+ */
+export declare function jsonLongerThan(value: unknown, limit: number): boolean;
 declare class ReduxActionStore {
     private actions;
     private listeners;
@@ -37,6 +88,12 @@ declare class ReduxActionStore {
      * the enabled flag so the UI's pause button freezes the mirror.
      */
     replaceActions(actions: ReduxAction[]): void;
+    /**
+     * Hydrate one mirrored action with real values (state trees, payload,
+     * action) fetched on demand from the device via the adapter's
+     * `getActionDetail` action. Remote-mirror (desktop) use only.
+     */
+    hydrateAction(id: string, patch: Partial<ReduxAction>): void;
     setEnabled(enabled: boolean): void;
     getEnabled(): boolean;
     subscribe(listener: (actions: ReduxAction[]) => void): () => void;

package/lib/typescript/redux/utils/reduxActionStore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reduxActionStore.d.ts","sourceRoot":"","sources":["../../../../src/redux/utils/reduxActionStore.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAA8B,MAAM,UAAU,CAAC;AAiLrF,cAAM,gBAAgB;IACpB,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,SAAS,CAAoD;IACrE,OAAO,CAAC,cAAc,CAA8B;IACpD,OAAO,CAAC,UAAU,CAAO;IACzB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,iBAAiB,CAAS;IAElC,SAAS,CACP,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,SAAS,EAAE,OAAO,EAClB,SAAS,EAAE,OAAO,EAClB,QAAQ,CAAC,EAAE,MAAM,GAChB,IAAI;IAmDP,UAAU,IAAI,WAAW,EAAE;IAI3B,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAIlD,YAAY,IAAI,IAAI;IAYpB;;;OAGG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAWzC;;;;OAIG;IACH,cAAc,IAAI,IAAI;IAItB;;;;OAIG;IACH,mBAAmB,IAAI,OAAO;IAI9B;;;;OAIG;IACH,cAAc,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,IAAI;IAQ5C,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAIlC,UAAU,IAAI,OAAO;IAIrB,SAAS,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,IAAI,GAAG,MAAM,IAAI;IAOjE,OAAO,CAAC,eAAe;IAKvB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAQhC,QAAQ;;;;;;;IAuBR,aAAa,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,EAAE;IAmBjD,oBAAoB,IAAI,MAAM,EAAE;IAIhC;;OAEG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,EAAE;IAMnD;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,EAAE;IAKpD;;OAEG;IACH,qBAAqB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM;IAOlD;;OAEG;IACH,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAe3D;;OAEG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAWvC;;;OAGG;IACH,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;CAkBlD;AAED,eAAO,MAAM,gBAAgB,kBAAyB,CAAC"}
+{"version":3,"file":"reduxActionStore.d.ts","sourceRoot":"","sources":["../../../../src/redux/utils/reduxActionStore.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAA8B,MAAM,UAAU,CAAC;AAErF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC;;;GAGG;AACH,eAAO,MAAM,aAAa;;;EAGxB,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe;;;EAG1B,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB;;;EAG5B,CAAC;AAEH;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAItD;AAwDD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CA2BrE;AA8HD,cAAM,gBAAgB;IACpB,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,SAAS,CAAoD;IACrE,OAAO,CAAC,cAAc,CAA8B;IACpD,OAAO,CAAC,UAAU,CAAO;IACzB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,iBAAiB,CAAS;IAElC,SAAS,CACP,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,SAAS,EAAE,OAAO,EAClB,SAAS,EAAE,OAAO,EAClB,QAAQ,CAAC,EAAE,MAAM,GAChB,IAAI;IAyEP,UAAU,IAAI,WAAW,EAAE;IAI3B,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAIlD,YAAY,IAAI,IAAI;IAYpB;;;OAGG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAWzC;;;;OAIG;IACH,cAAc,IAAI,IAAI;IAItB;;;;OAIG;IACH,mBAAmB,IAAI,OAAO;IAI9B;;;;OAIG;IACH,cAAc,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,IAAI;IAuB5C;;;;OAIG;IACH,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI;IAW5D,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAIlC,UAAU,IAAI,OAAO;IAIrB,SAAS,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,IAAI,GAAG,MAAM,IAAI;IAOjE,OAAO,CAAC,eAAe;IAKvB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAQhC,QAAQ;;;;;;;IAuBR,aAAa,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,EAAE;IAmBjD,oBAAoB,IAAI,MAAM,EAAE;IAIhC;;OAEG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,EAAE;IAMnD;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,EAAE;IAKpD;;OAEG;IACH,qBAAqB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM;IAOlD;;OAEG;IACH,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAe3D;;OAEG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAWvC;;;OAGG;IACH,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;CAkBlD;AAED,eAAO,MAAM,gBAAgB,kBAAyB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buoy-gg/redux",
-  "version": "7.0.9",
+  "version": "7.0.11",
   "description": "Redux DevTools inside your React Native app — action log, state diffs & time travel with zero store changes. Part of Buoy devtools.",
   "main": "lib/commonjs/index.js",
   "module": "lib/module/index.js",
@@ -29,9 +29,9 @@
     "**/devtoolsHook.ts"
   ],
   "dependencies": {
-    "@buoy-gg/shared-ui": "^7.0.9",
-    "@buoy-gg/license": "^7.0.9",
-    "@buoy-gg/floating-tools-core": "^7.0.9"
+    "@buoy-gg/shared-ui": "^7.0.11",
+    "@buoy-gg/floating-tools-core": "^7.0.11",
+    "@buoy-gg/license": "^7.0.11"
   },
   "peerDependencies": {
     "@reduxjs/toolkit": ">=1.9.0",