@buoy-gg/redux 7.0.10 → 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/reduxActionStore.js

@@ -3,8 +3,9 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.STATE_RETENTION_LIMIT = exports.STATE_EVICTED = void 0;
+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
@@ -26,9 +27,39 @@ const STATE_EVICTED = exports.STATE_EVICTED = Object.freeze({
   note: `Raw state retained for the ${STATE_RETENTION_LIMIT} most recent actions only.`
 });
 
-/** True when a value is the evicted-state sentinel (guards time travel). */
+/**
+ * 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) {
-  return typeof value === "object" && value !== null && value.__buoyStateEvicted === true;
+  if (typeof value !== "object" || value === null) return false;
+  const v = value;
+  return v.__buoyStateEvicted === true || v.__buoyStateOnDevice === true;
 }
 
 // ============================================
@@ -356,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/reduxActionStore.js

@@ -20,9 +20,39 @@ export const STATE_EVICTED = Object.freeze({
   note: `Raw state retained for the ${STATE_RETENTION_LIMIT} most recent actions only.`
 });
 
-/** True when a value is the evicted-state sentinel (guards time travel). */
+/**
+ * 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) {
-  return typeof value === "object" && value !== null && value.__buoyStateEvicted === true;
+  if (typeof value !== "object" || value === null) return false;
+  const v = value;
+  return v.__buoyStateEvicted === true || v.__buoyStateOnDevice === true;
 }
 
 // ============================================
@@ -85,7 +115,7 @@ function parseActionType(type) {
  * 40-char preview; that full stringify ran on EVERY dispatch and blocked the
  * JS thread at enterprise state sizes.
  */
-function jsonLongerThan(value, limit) {
+export function jsonLongerThan(value, limit) {
   let bytes = 0;
   const stack = [value];
   const seen = new Set();
@@ -350,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/reduxActionStore.d.ts

@@ -16,8 +16,43 @@ export declare const STATE_EVICTED: Readonly<{
     __buoyStateEvicted: true;
     note: "Raw state retained for the 25 most recent actions only.";
 }>;
-/** True when a value is the evicted-state sentinel (guards time travel). */
+/**
+ * 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;
@@ -53,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;AAErF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC;;;GAGG;AACH,eAAO,MAAM,aAAa;;;EAGxB,CAAC;AAEH,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAMtD;AAyND,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;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.10",
+  "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.10",
-    "@buoy-gg/floating-tools-core": "^7.0.10",
-    "@buoy-gg/license": "^7.0.10"
+    "@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",