@xstate-devtools/adapter 0.1.4 → 0.1.5

package/dist/react.cjs

@@ -22,114 +22,15 @@ var react_exports = {};
 __export(react_exports, {
   InspectorProvider: () => InspectorProvider,
   useInspectedActorRef: () => useInspectedActorRef,
-  useInspectedMachine: () => useInspectedMachine
+  useInspectedMachine: () => useInspectedMachine,
+  useRestorableInspectedMachine: () => useRestorableInspectedMachine
 });
 module.exports = __toCommonJS(react_exports);
-var import_react = require("@xstate/react");
-var import_react2 = require("react");
-
-// src/logging.ts
-function hasProcessEnv() {
-  return typeof process !== "undefined" && typeof process.env !== "undefined";
-}
-function isLoggingEnabled() {
-  if (globalThis.__XSTATE_DEVTOOLS_LOGGING__ === true) return true;
-  if (!hasProcessEnv()) return false;
-  const value = process.env.XSTATE_DEVTOOLS_LOGGING;
-  return value === "1" || value === "true";
-}
-function log(level, scope, message, details) {
-  if (!isLoggingEnabled()) return;
-  if (details === void 0) {
-    console[level](`[xstate-devtools:${scope}] ${message}`);
-    return;
-  }
-  console[level](`[xstate-devtools:${scope}] ${message}`, details);
-}
-function debugLog(scope, message, details) {
-  log("debug", scope, message, details);
-}
-function infoLog(scope, message, details) {
-  log("info", scope, message, details);
-}
-function warnLog(scope, message, details) {
-  log("warn", scope, message, details);
-}
-
-// src/sanitize.ts
-var MAX_DEPTH = 10;
-var MAX_STRING_LENGTH = 500;
-var MAX_ARRAY_LENGTH = 100;
-function sanitizeValue(value, depth, seen) {
-  if (depth > MAX_DEPTH) return "[MaxDepth]";
-  if (value === null || value === void 0) return value;
-  if (typeof value === "boolean" || typeof value === "number") return value;
-  if (typeof value === "string") {
-    return value.length > MAX_STRING_LENGTH ? `${value.slice(0, MAX_STRING_LENGTH)}\u2026` : value;
-  }
-  if (typeof value === "function") return `[Function: ${value.name || "(anonymous)"}]`;
-  if (typeof value === "symbol") return `[Symbol: ${value.description ?? ""}]`;
-  if (typeof value === "bigint") return `[BigInt: ${value}]`;
-  if (value instanceof Error) return { __type: "Error", name: value.name, message: value.message };
-  if (value instanceof Date) return { __type: "Date", iso: value.toISOString() };
-  if (value instanceof RegExp) return { __type: "RegExp", source: value.source, flags: value.flags };
-  if (typeof value === "object") {
-    if (seen.has(value)) return "[Circular]";
-    seen.add(value);
-  }
-  if (value instanceof Map) {
-    const entries = [];
-    for (const [k, v] of value) {
-      if (entries.length >= MAX_ARRAY_LENGTH) break;
-      entries.push([sanitizeValue(k, depth + 1, seen), sanitizeValue(v, depth + 1, seen)]);
-    }
-    return { __type: "Map", entries };
-  }
-  if (value instanceof Set) {
-    const values = [];
-    for (const v of value) {
-      if (values.length >= MAX_ARRAY_LENGTH) break;
-      values.push(sanitizeValue(v, depth + 1, seen));
-    }
-    return { __type: "Set", values };
-  }
-  if (value instanceof Promise) return "[Promise]";
-  if (value instanceof WeakMap || value instanceof WeakSet) return "[WeakCollection]";
-  if (ArrayBuffer.isView(value)) return `[TypedArray: ${value.constructor.name}]`;
-  if (typeof Node !== "undefined" && value instanceof Node) {
-    return `[DOMNode: ${value.tagName ?? value.nodeName}]`;
-  }
-  if (Array.isArray(value)) {
-    const sliced = value.slice(0, MAX_ARRAY_LENGTH);
-    const result = sliced.map((v) => sanitizeValue(v, depth + 1, seen));
-    if (value.length > MAX_ARRAY_LENGTH) result.push(`[\u2026${value.length - MAX_ARRAY_LENGTH} more]`);
-    return result;
-  }
-  if (typeof value === "object") {
-    const result = {};
-    let count = 0;
-    for (const [k, v] of Object.entries(value)) {
-      if (count++ >= MAX_ARRAY_LENGTH) {
-        result["\u2026"] = "[truncated]";
-        break;
-      }
-      result[k] = sanitizeValue(v, depth + 1, seen);
-    }
-    return result;
-  }
-  return String(value);
-}
-function sanitize(value, depth = 0) {
-  return sanitizeValue(value, depth, /* @__PURE__ */ new WeakSet());
-}
+var import_react = require("react");
+var import_react2 = require("@xstate/react");
+var import_xstate = require("xstate");
 
 // src/serialize.ts
-var MAX_SERIALIZED_NODES = 500;
-var MAX_TRANSITIONS_PER_NODE = 100;
-var MAX_CHILD_STATES = 100;
-var MAX_ACTIONS_PER_TRANSITION = 20;
-var MAX_ENTRY_EXIT_ACTIONS = 20;
-var MAX_INVOKES_PER_NODE = 20;
 function serializeGuard(guard) {
   if (!guard) return void 0;
   if (typeof guard === "string") return guard;
@@ -150,214 +51,133 @@ function serializeAction(action) {
   return String(action);
 }
 function serializeTransitionList(transitions) {
-  return transitions.slice(0, MAX_TRANSITIONS_PER_NODE).map((t) => ({
+  return transitions.map((t) => ({
     eventType: t.eventType ?? "",
     targets: (t.target ?? []).map((n) => n?.id ?? String(n)).filter(Boolean),
     guard: serializeGuard(t.guard),
-    actions: (t.actions ?? []).slice(0, MAX_ACTIONS_PER_TRANSITION).map(serializeAction).filter(Boolean)
+    actions: (t.actions ?? []).map(serializeAction).filter(Boolean)
   }));
 }
 function serializeInvokes(node) {
-  return node.invoke.slice(0, MAX_INVOKES_PER_NODE).map((inv) => ({
+  return node.invoke.map((inv) => ({
     id: inv.id ?? "(unknown)",
     src: typeof inv.src === "string" ? inv.src : inv.src?.id ?? inv.src?.name ?? "(inline)"
   }));
 }
-function serializeNode(node, state) {
-  if (!node || typeof node !== "object") {
-    return {
-      id: "(unknown)",
-      key: "(unknown)",
-      type: "atomic",
-      states: {},
-      on: [],
-      always: [],
-      entry: [],
-      exit: [],
-      invoke: []
-    };
-  }
-  if (state.count >= MAX_SERIALIZED_NODES) {
-    return {
-      id: node.id ?? "(truncated)",
-      key: node.key ?? "(truncated)",
-      type: node.type ?? "atomic",
-      states: {},
-      on: [],
-      always: [],
-      entry: [],
-      exit: [],
-      invoke: []
-    };
-  }
-  if (state.seen.has(node)) {
-    return {
-      id: node.id ?? "(circular)",
-      key: node.key ?? "(circular)",
-      type: node.type ?? "atomic",
-      states: {},
-      on: [],
-      always: [],
-      entry: [],
-      exit: [],
-      invoke: []
-    };
-  }
-  state.seen.add(node);
-  state.count += 1;
+function serializeNode(node) {
   const allTransitions = [];
   if (node.transitions instanceof Map) {
     for (const [, tList] of node.transitions) {
-      if (allTransitions.length >= MAX_TRANSITIONS_PER_NODE) break;
       allTransitions.push(...serializeTransitionList(tList));
-      if (allTransitions.length >= MAX_TRANSITIONS_PER_NODE) {
-        allTransitions.length = MAX_TRANSITIONS_PER_NODE;
-        break;
-      }
     }
   }
   const always = Array.isArray(node.always) ? serializeTransitionList(node.always) : [];
-  const childEntries = Object.entries(node.states ?? {}).slice(0, MAX_CHILD_STATES);
   return {
     id: node.id,
     key: node.key,
     type: node.type,
     initial: node.initial?.target?.[0]?.key,
-    states: Object.fromEntries(childEntries.map(([k, v]) => [k, serializeNode(v, state)])),
+    states: Object.fromEntries(
+      Object.entries(node.states ?? {}).map(([k, v]) => [k, serializeNode(v)])
+    ),
     on: allTransitions,
     always,
-    entry: (node.entry ?? []).slice(0, MAX_ENTRY_EXIT_ACTIONS).map(serializeAction).filter(Boolean),
-    exit: (node.exit ?? []).slice(0, MAX_ENTRY_EXIT_ACTIONS).map(serializeAction).filter(Boolean),
-    invoke: serializeInvokes(node),
-    sourceLocation: node.config?.__xstateDevtoolsSource ?? void 0,
-    description: node.config?.description ?? void 0
+    entry: (node.entry ?? []).map(serializeAction).filter(Boolean),
+    exit: (node.exit ?? []).map(serializeAction).filter(Boolean),
+    invoke: serializeInvokes(node)
   };
 }
 function serializeMachine(machine, sourceLocation) {
   return {
     id: machine.id,
-    root: serializeNode(machine.root, { seen: /* @__PURE__ */ new WeakSet(), count: 0 }),
+    root: serializeNode(machine.root),
     sourceLocation
   };
 }
 
-// src/core.ts
-function summarizeMessage(message) {
-  const summary = { type: message.type };
-  if ("sessionId" in message) summary.sessionId = message.sessionId;
-  if ("stateNodeId" in message) summary.stateNodeId = message.stateNodeId;
-  if ("parentSessionId" in message && message.parentSessionId) {
-    summary.parentSessionId = message.parentSessionId;
+// src/sanitize.ts
+var MAX_DEPTH = 10;
+var MAX_STRING_LENGTH = 500;
+var MAX_ARRAY_LENGTH = 100;
+var MAX_NODES = 1e4;
+function sanitizeInner(value, ctx) {
+  if (ctx.depth > MAX_DEPTH) return "[MaxDepth]";
+  if (++ctx.budget.n > MAX_NODES) return "[Truncated]";
+  if (value === null || value === void 0) return value;
+  if (typeof value === "boolean" || typeof value === "number") return value;
+  if (typeof value === "string") {
+    return value.length > MAX_STRING_LENGTH ? value.slice(0, MAX_STRING_LENGTH) + "\u2026" : value;
   }
-  if ("globalSeq" in message) summary.globalSeq = message.globalSeq;
-  if ("timestamp" in message) summary.timestamp = message.timestamp;
-  if ("event" in message && message.event && typeof message.event === "object" && "type" in message.event) {
-    summary.eventType = message.event.type;
+  if (typeof value === "function") return `[Function: ${value.name || "(anonymous)"}]`;
+  if (typeof value === "symbol") return `[Symbol: ${value.description ?? ""}]`;
+  if (typeof value === "bigint") return `[BigInt: ${value}]`;
+  if (value instanceof Error) return { __type: "Error", name: value.name, message: value.message };
+  if (value instanceof Date) return { __type: "Date", iso: value.toISOString() };
+  if (value instanceof RegExp) return { __type: "RegExp", source: value.source, flags: value.flags };
+  if (value instanceof Promise) return "[Promise]";
+  if (value instanceof WeakMap || value instanceof WeakSet) return "[WeakCollection]";
+  if (ArrayBuffer.isView(value)) return `[TypedArray: ${value.constructor.name}]`;
+  if (typeof Node !== "undefined" && value instanceof Node) {
+    return `[DOMNode: ${value.tagName ?? value.nodeName}]`;
   }
-  return summary;
-}
-function summarizeInspectionEvent(event) {
-  return {
-    type: event?.type,
-    sessionId: event?.actorRef?.sessionId,
-    eventType: event?.type === "@xstate.event" && event?.event && typeof event.event === "object" ? event.event.type : void 0
-  };
-}
-function debugLog2(source, message, details) {
-  debugLog(`${source}:adapter`, message, details);
-}
-function infoLog2(source, message, details) {
-  infoLog(`${source}:adapter`, message, details);
-}
-function warnLog2(source, message, details) {
-  warnLog(`${source}:adapter`, message, details);
-}
-function isLibraryStackFrame(line) {
-  const normalized = line.replace(/\\/g, "/").toLowerCase();
-  return normalized.includes("/node_modules/xstate/") || normalized.includes("/node_modules/@xstate/") || normalized.includes("/@xstate-devtools/adapter/") || normalized.includes("/packages/adapter/");
-}
-function normalizeStackFrame(line) {
-  return line.trim().replace(/^at\s+/, "");
-}
-function extractStackFrameLocation(frame) {
-  return frame.match(/\((.*)\)$/)?.[1] ?? frame;
-}
-function isAnonymousOrEvalLocation(location) {
-  const normalized = location.trim().toLowerCase().replace(/^[./\\]+/, "");
-  return normalized === "<anonymous>" || normalized === "anonymous" || normalized === "(anonymous)" || normalized === "eval" || normalized === "<eval>" || normalized === "[native code]";
-}
-function hasFilesystemBackedPath(location) {
-  const trimmed = location.trim();
-  if (!trimmed) return false;
-  const match = trimmed.match(/^(.*?)(?::\d+)?(?::\d+)?$/);
-  const rawPath = (match?.[1] ?? trimmed).trim();
-  if (!rawPath || isAnonymousOrEvalLocation(rawPath)) return false;
-  if (/^[a-zA-Z]:[\\/]/.test(rawPath)) return true;
-  if (rawPath.startsWith("/") || rawPath.startsWith("./") || rawPath.startsWith("../")) return true;
-  if (/^[a-zA-Z][a-zA-Z\d+.-]*:\/\//.test(rawPath)) {
-    try {
-      const url = new URL(rawPath);
-      if (url.protocol === "file:") return true;
-      return url.pathname.startsWith("/@fs/");
-    } catch {
-      return false;
+  if (ctx.seen.has(value)) return "[Circular]";
+  ctx.seen.add(value);
+  const child = { ...ctx, depth: ctx.depth + 1 };
+  if (value instanceof Map) {
+    const entries = [];
+    for (const [k, v] of value) {
+      if (entries.length >= MAX_ARRAY_LENGTH) break;
+      entries.push([sanitizeInner(k, child), sanitizeInner(v, child)]);
     }
+    return { __type: "Map", entries };
   }
-  return false;
-}
-function remapWebUrlLocationToFsPath(location, source, options) {
-  if (source !== "web" || !options?.webSourceRoot) return location;
-  const match = location.trim().match(/^(.*?)(?::(\d+))?(?::(\d+))?$/);
-  if (!match) return location;
-  const [, rawPath, line, column] = match;
-  if (!rawPath || !/^https?:\/\//.test(rawPath)) return location;
-  try {
-    const url = new URL(rawPath);
-    const pathname = decodeURIComponent(url.pathname);
-    if (!pathname.startsWith("/app/")) return location;
-    const root = options.webSourceRoot.replace(/\/+$/, "");
-    const filePath = `${root}${pathname}`;
-    const suffix = line ? `:${line}${column ? `:${column}` : ""}` : "";
-    return `${filePath}${suffix}`;
-  } catch {
-    return location;
+  if (value instanceof Set) {
+    const values = [];
+    for (const v of value) {
+      if (values.length >= MAX_ARRAY_LENGTH) break;
+      values.push(sanitizeInner(v, child));
+    }
+    return { __type: "Set", values };
   }
-}
-function getSourceLocationFromStack(stack, source = "web", options) {
-  const lines = stack?.split("\n") ?? [];
-  for (let i = 0; i < lines.length; i += 1) {
-    if (i <= 2) continue;
-    const line = lines[i];
-    if (isLibraryStackFrame(line)) continue;
-    const normalizedFrame = normalizeStackFrame(line);
-    const location = remapWebUrlLocationToFsPath(
-      extractStackFrameLocation(normalizedFrame),
-      source,
-      options
-    );
-    if (!hasFilesystemBackedPath(location)) continue;
-    const wrapped = normalizedFrame.match(/\((.*)\)$/);
-    if (wrapped) {
-      return normalizedFrame.replace(wrapped[1], location);
+  if (Array.isArray(value)) {
+    const sliced = value.slice(0, MAX_ARRAY_LENGTH);
+    const result = sliced.map((v) => sanitizeInner(v, child));
+    if (value.length > MAX_ARRAY_LENGTH) result.push(`[\u2026${value.length - MAX_ARRAY_LENGTH} more]`);
+    return result;
+  }
+  if (typeof value === "object") {
+    const result = {};
+    let count = 0;
+    for (const [k, v] of Object.entries(value)) {
+      if (count++ >= MAX_ARRAY_LENGTH) {
+        result["\u2026"] = "[truncated]";
+        break;
+      }
+      result[k] = sanitizeInner(v, child);
     }
-    return location;
+    return result;
   }
-  return void 0;
+  return String(value);
+}
+function sanitize(value) {
+  return sanitizeInner(value, { depth: 0, budget: { n: 0 }, seen: /* @__PURE__ */ new WeakSet() });
 }
-function getSourceLocation(source, options) {
+
+// src/core.ts
+function getSourceLocation() {
   try {
-    const oldLimit = Error.stackTraceLimit;
-    Error.stackTraceLimit = 50;
-    const stack = new Error().stack;
-    Error.stackTraceLimit = oldLimit;
-    return getSourceLocationFromStack(stack, source, options);
+    const lines = new Error().stack?.split("\n") ?? [];
+    const callerLine = lines.find(
+      (l, i) => i > 3 && !l.includes("xstate") && !l.includes("adapter")
+    );
+    return callerLine?.trim().replace(/^at\s+/, "");
   } catch {
     return void 0;
   }
 }
 function serializeSnapshot(snapshot) {
   return {
-    value: snapshot?.value ?? null,
+    value: sanitize(snapshot?.value ?? null),
     context: sanitize(snapshot?.context),
     status: snapshot?.status ?? "active",
     error: snapshot?.error ? sanitize(snapshot.error) : void 0
@@ -370,125 +190,18 @@ function safeSerializeSnapshot(actorRef) {
     return { value: null, context: void 0, status: "active" };
   }
 }
-function getActorDisplayName(actorRef) {
-  const actor = actorRef;
-  const src = actor.src ?? actor.logic?.src;
-  if (typeof src === "string" && src.length > 0) return src;
-  if (typeof actor.logic?.id === "string" && actor.logic.id.length > 0) return actor.logic.id;
-  if (typeof actor.logic?.name === "string" && actor.logic.name.length > 0) return actor.logic.name;
-  if (src && typeof src === "object") {
-    const namedSrc = src;
-    if (typeof namedSrc.id === "string" && namedSrc.id.length > 0) return namedSrc.id;
-    if (typeof namedSrc.name === "string" && namedSrc.name.length > 0) return namedSrc.name;
-  }
-  return void 0;
-}
-function getNodeInitialChild(node) {
-  if (!node.states) return null;
-  if (typeof node.initial === "string") {
-    return node.states[node.initial] ?? null;
+function safePersistedSnapshot(actorRef) {
+  const getPersisted = actorRef.getPersistedSnapshot;
+  if (typeof getPersisted !== "function") {
+    return { error: "Actor does not support getPersistedSnapshot." };
   }
-  const target = Array.isArray(node.initial?.target) ? node.initial.target[0] : null;
-  return target ?? null;
-}
-function encodeChildValue(child, childValue) {
-  if (child.type === "atomic" || child.type === "final" || child.type === "history") {
-    return child.key;
-  }
-  return { [child.key]: childValue };
-}
-function getDefaultStateValue(node) {
-  if (node.type === "parallel") {
-    const value = {};
-    for (const child of Object.values(node.states ?? {})) {
-      value[child.key] = getDefaultSelectionValue(child);
-    }
-    return value;
-  }
-  const initialChild = getNodeInitialChild(node);
-  if (!initialChild) return {};
-  return encodeChildValue(initialChild, getDefaultStateValue(initialChild));
-}
-function getDefaultSelectionValue(node) {
-  if (node.type === "atomic" || node.type === "final" || node.type === "history") {
-    return node.key;
-  }
-  return getDefaultStateValue(node);
-}
-function getExistingChildValue(value, childKey) {
-  if (!value || typeof value !== "object") return void 0;
-  return value[childKey];
-}
-function getPathToRoot(target, root) {
-  const path = [];
-  let current = target;
-  while (current) {
-    path.unshift(current);
-    if (current.id === root.id) return path;
-    current = current.parent;
-  }
-  throw new Error(`State node '${target.id}' is not part of machine '${root.id}'`);
-}
-function buildTargetStateValue(node, path, currentValue) {
-  const [, ...restPath] = path;
-  if (restPath.length === 0) {
-    if (node.type === "parallel") {
-      const next = {};
-      for (const child2 of Object.values(node.states ?? {})) {
-        next[child2.key] = getExistingChildValue(currentValue, child2.key) ?? getDefaultSelectionValue(child2);
-      }
-      return next;
-    }
-    if (node.type === "compound") {
-      return getDefaultStateValue(node);
-    }
-    return node.key;
-  }
-  const child = restPath[0];
-  if (node.type === "parallel") {
-    const next = {};
-    for (const sibling of Object.values(node.states ?? {})) {
-      if (sibling.key === child.key) {
-        next[sibling.key] = buildTargetStateValue(
-          sibling,
-          restPath,
-          getExistingChildValue(currentValue, sibling.key)
-        );
-      } else {
-        next[sibling.key] = getExistingChildValue(currentValue, sibling.key) ?? getDefaultSelectionValue(sibling);
-      }
-    }
-    return next;
-  }
-  const childValue = buildTargetStateValue(
-    child,
-    restPath,
-    getExistingChildValue(currentValue, child.key)
-  );
-  return encodeChildValue(child, childValue);
-}
-function setActiveState(actorRef, stateNodeId) {
-  const mutableActorRef = actorRef;
-  const machine = mutableActorRef.logic;
-  if (!machine?.getStateNodeById || !machine.resolveState || typeof mutableActorRef.update !== "function") {
-    throw new Error("Actor does not expose machine state mutation internals");
+  try {
+    const raw = getPersisted.call(actorRef);
+    if (raw === void 0) return { error: "No persisted snapshot available." };
+    return { persisted: JSON.parse(JSON.stringify(raw)) };
+  } catch (e) {
+    return { error: `Snapshot is not JSON-serializable: ${e.message}` };
   }
-  const currentSnapshot = actorRef.getSnapshot();
-  const targetNode = machine.getStateNodeById(stateNodeId);
-  const path = getPathToRoot(targetNode, machine.root);
-  const targetValue = buildTargetStateValue(machine.root, path, currentSnapshot?.value);
-  const nextSnapshot = machine.resolveState({
-    value: targetValue,
-    context: currentSnapshot?.context,
-    status: currentSnapshot?.status,
-    output: currentSnapshot?.output,
-    error: currentSnapshot?.error,
-    historyValue: currentSnapshot?.historyValue
-  });
-  mutableActorRef.update(nextSnapshot, {
-    type: "xstate.devtools.set-active-state",
-    stateNodeId
-  });
 }
 var SEQ_KEY = "__xstate_devtools_global_seq__";
 function nextSeq() {
@@ -498,10 +211,10 @@ function nextSeq() {
   g[SEQ_KEY] = next;
   return next;
 }
-function createInspector(transport, source, options = {}) {
+function createInspector(transport, source) {
   const actorRefs = /* @__PURE__ */ new Map();
-  const actorMachines = /* @__PURE__ */ new Map();
-  const prefix = `${source}:`;
+  const restoreHandlers = /* @__PURE__ */ new Map();
+  const prefix = source + ":";
   const tag = (sessionId) => prefix + sessionId;
   const tagOptional = (id) => id ? prefix + id : void 0;
   const stripIfMine = (id) => id.startsWith(prefix) ? id.slice(prefix.length) : null;
@@ -513,278 +226,200 @@ function createInspector(transport, source, options = {}) {
       return;
     }
     if (snap?.status !== "active") {
-      const message = {
-        type: "XSTATE_ACTOR_STOPPED",
-        sessionId: tag(actorRef.sessionId)
-      };
-      debugLog2(source, "actor stopped; notifying transport", summarizeMessage(message));
-      transport.send(message);
+      transport.send({ type: "XSTATE_ACTOR_STOPPED", sessionId: tag(actorRef.sessionId) });
       actorRefs.delete(actorRef.sessionId);
-      actorMachines.delete(actorRef.sessionId);
     }
   }
   const unsubscribe = transport.subscribe((message) => {
-    debugLog2(source, "received message from transport", summarizeMessage(message));
-    if (message.type === "XSTATE_PANEL_CONNECTED") {
-      infoLog2(source, "panel connected; resyncing actors", { actorCount: actorRefs.size });
-      actorRefs.forEach((actorRef, sessionId) => {
-        const machine = actorMachines.get(sessionId) ?? null;
-        const resyncMessage = {
-          type: "XSTATE_ACTOR_REGISTERED",
-          sessionId: tag(sessionId),
-          parentSessionId: tagOptional(actorRef._parent?.sessionId),
-          displayName: getActorDisplayName(actorRef),
-          machine,
-          snapshot: safeSerializeSnapshot(actorRef),
-          globalSeq: nextSeq(),
-          timestamp: Date.now()
-        };
-        debugLog2(source, "resyncing actor", summarizeMessage(resyncMessage));
-        transport.send(resyncMessage);
-      });
-      return;
-    }
     if (message.type === "XSTATE_DISPATCH") {
       const local = stripIfMine(message.sessionId);
-      if (local === null) {
-        debugLog2(source, "ignoring dispatch for different source", summarizeMessage(message));
-        return;
-      }
+      if (local === null) return;
       const ref = actorRefs.get(local);
       if (ref) {
         try {
-          debugLog2(source, "dispatching event to actor", {
-            sessionId: local,
-            eventType: message.event && typeof message.event === "object" && "type" in message.event ? message.event.type : void 0
-          });
           ref.send(message.event);
         } catch (e) {
-          warnLog2(source, "dispatch error", { error: e, sessionId: local });
+          console.warn("[xstate-devtools] dispatch error:", e);
         }
-      } else {
-        warnLog2(source, "received dispatch for unknown actor", {
-          sessionId: local,
-          knownActors: actorRefs.size
-        });
       }
-      return;
-    }
-    if (message.type === "XSTATE_SET_ACTIVE_STATE") {
+    } else if (message.type === "XSTATE_REQUEST_PERSISTED") {
       const local = stripIfMine(message.sessionId);
-      if (local === null) {
-        debugLog2(
-          source,
-          "ignoring state activation for different source",
-          summarizeMessage(message)
-        );
-        return;
-      }
+      if (local === null) return;
       const ref = actorRefs.get(local);
-      if (!ref) {
-        warnLog2(source, "received state activation for unknown actor", {
-          sessionId: local,
-          knownActors: actorRefs.size
-        });
-        return;
+      if (!ref) return;
+      const { persisted, error } = safePersistedSnapshot(ref);
+      transport.send({
+        type: "XSTATE_PERSISTED_SNAPSHOT",
+        sessionId: tag(local),
+        persisted,
+        error,
+        timestamp: Date.now()
+      });
+    } else if (message.type === "XSTATE_RESTORE") {
+      const local = stripIfMine(message.sessionId);
+      if (local === null) return;
+      const handler = restoreHandlers.get(local);
+      if (handler) {
+        try {
+          handler(message.persisted);
+        } catch (e) {
+          console.warn("[xstate-devtools] restore error:", e);
+        }
       }
-      try {
-        debugLog2(source, "setting active state on actor", summarizeMessage(message));
-        setActiveState(ref, message.stateNodeId);
-        const snapshotMessage = {
+    }
+  });
+  const inspect = (inspectionEvent) => {
+    try {
+      if (inspectionEvent.type === "@xstate.actor") {
+        const actorRef = inspectionEvent.actorRef;
+        const sessionId = actorRef.sessionId;
+        actorRefs.set(sessionId, actorRef);
+        const logic = actorRef.logic;
+        const machine = logic?.root ? serializeMachine(logic, getSourceLocation()) : null;
+        transport.send({
+          type: "XSTATE_ACTOR_REGISTERED",
+          sessionId: tag(sessionId),
+          parentSessionId: tagOptional(actorRef._parent?.sessionId),
+          // actorRef.id is the invoke `id` for invoked actors — lets the debugger
+          // nest non-machine actors (promise/callback) under their state.
+          actorId: actorRef.id,
+          machine,
+          snapshot: safeSerializeSnapshot(actorRef),
+          globalSeq: nextSeq(),
+          timestamp: Date.now()
+        });
+      } else if (inspectionEvent.type === "@xstate.snapshot") {
+        transport.send({
           type: "XSTATE_SNAPSHOT",
-          sessionId: tag(local),
-          snapshot: safeSerializeSnapshot(ref),
+          sessionId: tag(inspectionEvent.actorRef.sessionId),
+          snapshot: serializeSnapshot(inspectionEvent.snapshot),
           timestamp: Date.now(),
           globalSeq: nextSeq()
-        };
-        debugLog2(
-          source,
-          "sending snapshot after state activation",
-          summarizeMessage(snapshotMessage)
-        );
-        transport.send(snapshotMessage);
-      } catch (error) {
-        warnLog2(source, "failed to set active state", {
-          error,
-          sessionId: local,
-          stateNodeId: message.stateNodeId
         });
+        checkAndNotifyStop(inspectionEvent.actorRef);
+      } else if (inspectionEvent.type === "@xstate.event") {
+        transport.send({
+          type: "XSTATE_EVENT",
+          sessionId: tag(inspectionEvent.actorRef.sessionId),
+          event: inspectionEvent.event,
+          snapshotAfter: safeSerializeSnapshot(inspectionEvent.actorRef),
+          timestamp: Date.now(),
+          globalSeq: nextSeq()
+        });
+        checkAndNotifyStop(inspectionEvent.actorRef);
       }
-    }
-  });
-  transport.send({ type: "XSTATE_ADAPTER_READY" });
-  infoLog2(source, "inspector created");
-  const inspect = (inspectionEvent) => {
-    debugLog2(source, "inspect callback invoked", summarizeInspectionEvent(inspectionEvent));
-    if (inspectionEvent.type === "@xstate.actor") {
-      const actorRef = inspectionEvent.actorRef;
-      const sessionId = actorRef.sessionId;
-      const actorLogic = actorRef.logic;
-      const machine = actorLogic?.root ? serializeMachine(
-        actorLogic,
-        actorLogic.config?.__xstateDevtoolsSource ?? getSourceLocation(source, options)
-      ) : null;
-      actorRefs.set(sessionId, actorRef);
-      actorMachines.set(sessionId, machine);
-      const notifyStop = () => {
-        if (actorRefs.has(sessionId)) {
-          actorRefs.delete(sessionId);
-          actorMachines.delete(sessionId);
-          const stopMsg = {
-            type: "XSTATE_ACTOR_STOPPED",
-            sessionId: tag(sessionId)
-          };
-          debugLog2(source, "actor stopped; notifying transport", summarizeMessage(stopMsg));
-          transport.send(stopMsg);
-        }
-      };
-      try {
-        actorRef.subscribe({ complete: notifyStop, error: notifyStop });
-      } catch {
-      }
-      const message = {
-        type: "XSTATE_ACTOR_REGISTERED",
-        sessionId: tag(sessionId),
-        parentSessionId: tagOptional(actorRef._parent?.sessionId),
-        displayName: getActorDisplayName(actorRef),
-        machine,
-        snapshot: safeSerializeSnapshot(actorRef),
-        globalSeq: nextSeq(),
-        timestamp: Date.now()
-      };
-      infoLog2(source, "registering actor with transport", {
-        message: summarizeMessage(message),
-        actorCount: actorRefs.size,
-        hasMachine: machine !== null
-      });
-      transport.send(message);
-    } else if (inspectionEvent.type === "@xstate.snapshot") {
-      const message = {
-        type: "XSTATE_SNAPSHOT",
-        sessionId: tag(inspectionEvent.actorRef.sessionId),
-        snapshot: serializeSnapshot(inspectionEvent.snapshot),
-        timestamp: Date.now(),
-        globalSeq: nextSeq()
-      };
-      debugLog2(source, "sending snapshot to transport", summarizeMessage(message));
-      transport.send(message);
-      checkAndNotifyStop(inspectionEvent.actorRef);
-    } else if (inspectionEvent.type === "@xstate.event") {
-      const message = {
-        type: "XSTATE_EVENT",
-        sessionId: tag(inspectionEvent.actorRef.sessionId),
-        // sanitize() returns unknown; the inspected event keeps its { type, ... }
-        // shape, so it is a SerializedEvent after deep-sanitizing.
-        event: sanitize(inspectionEvent.event),
-        snapshotAfter: safeSerializeSnapshot(inspectionEvent.actorRef),
-        timestamp: Date.now(),
-        globalSeq: nextSeq()
-      };
-      debugLog2(source, "sending event to transport", summarizeMessage(message));
-      transport.send(message);
-      checkAndNotifyStop(inspectionEvent.actorRef);
-    } else {
-      debugLog2(
-        source,
-        "ignoring unsupported inspection event",
-        summarizeInspectionEvent(inspectionEvent)
-      );
+    } catch (e) {
+      console.warn("[xstate-devtools] inspection failed, dropping event:", e.message);
     }
   };
+  function registerRestore(sessionId, handler) {
+    restoreHandlers.set(sessionId, handler);
+    return () => {
+      if (restoreHandlers.get(sessionId) === handler) restoreHandlers.delete(sessionId);
+    };
+  }
   function dispose() {
-    infoLog2(source, "disposing inspector", { actorCount: actorRefs.size });
     unsubscribe();
     actorRefs.clear();
-    actorMachines.clear();
+    restoreHandlers.clear();
   }
-  return { inspect, dispose };
+  return { inspect, dispose, registerRestore };
 }
 
 // src/index.ts
-function createAdapter(options = {}) {
+function createAdapter() {
   if (typeof window === "undefined") {
-    infoLog("web:adapter", "createAdapter called without window; returning no-op adapter");
     return { inspect: () => {
     }, dispose: () => {
+    }, registerRestore: () => () => {
     } };
   }
-  infoLog("web:adapter", "creating browser adapter", {
-    hookInstalled: Boolean(window.__XSTATE_DEVTOOLS__)
-  });
-  let warnedMissingHook = false;
   const transport = {
     send(message) {
-      const payload = { ...message, __xstateDevtools: true };
-      debugLog("web:adapter", "sending message via page hook", {
-        type: message.type,
-        sessionId: "sessionId" in message ? message.sessionId : void 0
-      });
-      if (window.__XSTATE_DEVTOOLS__) {
-        window.__XSTATE_DEVTOOLS__.send(payload);
-        return;
-      }
-      if (!warnedMissingHook) {
-        warnedMissingHook = true;
-        warnLog("web:adapter", "page hook missing; using direct window.postMessage fallback");
-      }
-      window.postMessage(payload, "*");
+      window.__XSTATE_DEVTOOLS__?.send({ ...message, __xstateDevtools: true });
     },
     subscribe(handler) {
-      infoLog("web:adapter", "subscribing to window messages");
       const onMessage = (evt) => {
         if (evt.source !== window) return;
         const data = evt.data;
         if (!data?.__xstateDevtools) return;
-        debugLog("web:adapter", "received message from window bridge", {
-          type: data.type,
-          sessionId: "sessionId" in data ? data.sessionId : void 0
-        });
         handler(data);
       };
       window.addEventListener("message", onMessage);
-      return () => {
-        infoLog("web:adapter", "unsubscribing from window messages");
-        window.removeEventListener("message", onMessage);
-      };
+      return () => window.removeEventListener("message", onMessage);
     }
   };
-  return createInspector(transport, "web", options);
+  return createInspector(transport, "web");
 }
 
 // src/react.tsx
 var import_jsx_runtime = require("react/jsx-runtime");
-var InspectorContext = (0, import_react2.createContext)(null);
-function InspectorProvider({ children }) {
-  const adapterRef = (0, import_react2.useRef)(null);
-  if (!adapterRef.current && typeof window !== "undefined") {
-    adapterRef.current = createAdapter();
-  }
-  (0, import_react2.useEffect)(() => {
+var InspectorContext = (0, import_react.createContext)(null);
+function InspectorProvider({
+  children,
+  adapter
+}) {
+  const ownRef = (0, import_react.useRef)(null);
+  const useOwn = adapter == null;
+  if (useOwn && !ownRef.current && typeof window !== "undefined") {
+    ownRef.current = createAdapter();
+  }
+  const resolved = adapter ?? ownRef.current;
+  (0, import_react.useEffect)(() => {
+    if (!useOwn) return;
     return () => {
-      adapterRef.current?.dispose();
-      adapterRef.current = null;
+      ownRef.current?.dispose();
+      ownRef.current = null;
     };
-  }, []);
-  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(InspectorContext.Provider, { value: adapterRef.current, children });
+  }, [useOwn]);
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(InspectorContext.Provider, { value: resolved, children });
 }
 function useInspectedMachine(machine, options) {
-  const adapter = (0, import_react2.useContext)(InspectorContext);
-  return (0, import_react.useMachine)(machine, {
+  const adapter = (0, import_react.useContext)(InspectorContext);
+  return (0, import_react2.useMachine)(machine, {
     ...options,
     inspect: adapter?.inspect
   });
 }
 function useInspectedActorRef(machine, options) {
-  const adapter = (0, import_react2.useContext)(InspectorContext);
-  return (0, import_react.useActorRef)(machine, {
+  const adapter = (0, import_react.useContext)(InspectorContext);
+  return (0, import_react2.useActorRef)(machine, {
     ...options,
     inspect: adapter?.inspect
   });
 }
+function useRestorableInspectedMachine(machine, options) {
+  const adapter = (0, import_react.useContext)(InspectorContext);
+  const restoreSnapshotRef = (0, import_react.useRef)(options?.snapshot);
+  const [generation, setGeneration] = (0, import_react.useState)(0);
+  const actorRef = (0, import_react.useMemo)(() => {
+    return (0, import_xstate.createActor)(machine, {
+      ...options,
+      snapshot: restoreSnapshotRef.current,
+      inspect: adapter?.inspect
+    });
+  }, [generation, adapter]);
+  (0, import_react.useEffect)(() => {
+    actorRef.start();
+    return () => {
+      actorRef.stop();
+    };
+  }, [actorRef]);
+  (0, import_react.useEffect)(() => {
+    if (!adapter?.registerRestore) return;
+    return adapter.registerRestore(actorRef.sessionId, (persisted) => {
+      restoreSnapshotRef.current = persisted;
+      setGeneration((g) => g + 1);
+    });
+  }, [adapter, actorRef]);
+  const snapshot = (0, import_react2.useSelector)(actorRef, (s) => s);
+  return [snapshot, actorRef.send, actorRef];
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   InspectorProvider,
   useInspectedActorRef,
-  useInspectedMachine
+  useInspectedMachine,
+  useRestorableInspectedMachine
 });
 //# sourceMappingURL=react.cjs.map