@evandu/super-pi 0.1.151 → 0.1.153

package/dist/server/terminal.js

@@ -29,8 +29,8 @@
  *      nothing else; this file resolves the id against the store and spawns in that workspace's path.
  *      A browser that asked for `C:\` or `/etc` gets its own workspace's directory instead, because
  *      there is no code path on which a client-supplied path reaches `spawn`.
- *   4. BOUNDED SESSIONS. `MAX_SESSIONS` shells, one per client tab, capped so a loop of reconnects
- *      cannot accumulate processes.
+ *   4. BOUNDED SESSIONS. `MAX_SESSIONS` live shells, capped so a loop of reconnects cannot accumulate
+ *      processes.
  *
  * What is NOT here is a per-command allowlist. A terminal that refuses `rm` or `curl` is not a terminal,
  * and pretending otherwise would be worse than the honest version: with (1) and (2) the operator has
@@ -190,8 +190,33 @@ export function terminalShellCandidates(env = process.env) {
 // ---------------------------------------------------------------------------------------------
 // Bounds
 // ---------------------------------------------------------------------------------------------
-/** One shell per browser tab, and a hard ceiling so reconnects cannot accumulate processes. */
-export const MAX_SESSIONS = 8;
+/**
+ * THE CEILING ON LIVE SHELLS.
+ *
+ * WHAT THIS COUNTS. Only the browser's terminal panel: `terminal.open` is the ONE place a shell is
+ * spawned, and it is a command the browser sends over its own WebSocket. An agent session, a
+ * sub-agent run, and the `exec` tool do NOT consume this budget - the exec tool spawns its own
+ * short-lived `shell -c` process through a different service.
+ *
+ * WHY THE COUNT ACCUMULATES. The client opens up to five terminals per session (`MAX_SLOTS` in
+ * TerminalPanel), and a shell is deliberately KEPT ALIVE across a session switch: the panel unmounts
+ * without closing it, so the work in that shell survives the switch. Every session in the tree is a
+ * conversation with its own panel - including a CHILD session the user can click into - and each of
+ * them can hold five shells, and all of them land in this one map. A tree multiplies: eight parents
+ * with four children each are forty sessions, and forty sessions at four terminals is a hundred and
+ * sixty shells.
+ *
+ * WHY 256. Every shell in this map was opened by the user on purpose, and what runs inside it is the
+ * user's own business - so this constant is NOT a memory governor and does not pretend to be one. Its
+ * whole job is to be generous enough never to stand in the way of real work, and loud enough that a
+ * client looping on `terminal.open` is stopped with a message instead of quietly filling the machine.
+ * (For the record, the platform's own overhead per shell is the shell: an idle Windows PowerShell is
+ * ~90MB and an idle bash ~8MB, so the cost of "many terminals" is the cost of the shells themselves.)
+ * Reconnect storms do not need this constant to be low: the socket-close cleanup already kills a
+ * connection's shells, and the 30-second heartbeat reaps the half-open connections that would
+ * otherwise leave them behind.
+ */
+export const MAX_SESSIONS = 256;
 /** Below the client panel's own minimum, and small enough that a `ls` cannot stall the socket. */
 const MIN_COLS = 20;
 const MIN_ROWS = 5;
@@ -296,7 +321,15 @@ export class TerminalService {
             if (this.sessions.has(command.sessionId))
                 return;
             if (this.sessions.size >= MAX_SESSIONS) {
-                send({ type: "terminal.error", sessionId: command.sessionId, message: `终端会话已达上限（${MAX_SESSIONS} 个），请先关闭一个。` });
+                // The count is in the message because the shells eating the budget are usually the BACKGROUND
+                // ones of other sessions - a parent session's children included, each of which has its own
+                // panel with its own terminals. The user sees three terminals in this panel and a refusal,
+                // and has no way to guess that the sessions they left open still hold shells.
+                send({
+                    type: "terminal.error",
+                    sessionId: command.sessionId,
+                    message: `终端会话已达上限（服务器最多 ${MAX_SESSIONS} 个，当前已有 ${this.sessions.size} 个在运行）。切换会话后仍在后台运行的终端也计入其中（包括 session 树里的子会话），请到对应的会话里关闭一个再试。`,
+                });
                 return;
             }
             // The workspace id is the ONLY thing the browser supplies, and it is resolved here. A client that

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@evandu/super-pi",
-  "version": "0.1.151",
+  "version": "0.1.153",
   "description": "Web control plane and companion for Pi",
   "license": "MIT",
   "type": "module",
@@ -29,8 +29,8 @@
     "node": ">=22.19.0"
   },
   "scripts": {
-    "prepack": "npm run build",
-    "prepublishOnly": "npm run build && cross-env SUPER_PI_REQUIRE_REAL_PI=1 node scripts/extension-load.test.mjs",
+    "prepack": "node scripts/clean-build.mjs",
+    "prepublishOnly": "node scripts/clean-build.mjs && cross-env SUPER_PI_REQUIRE_REAL_PI=1 node scripts/extension-load.test.mjs",
     "dev": "concurrently --kill-others-on-fail \"npm:dev:server\" \"npm:dev:client\"",
     "dev:client": "vite --host 0.0.0.0",
     "dev:server": "cross-env SUPER_PI_PORT=3081 tsx watch src/server/index.ts",
@@ -53,6 +53,7 @@
     "scripts/pi-session.test.mjs",
     "scripts/length-continuation.test.mjs",
     "scripts/pi-session-isolation.test.mjs",
+    "scripts/build-state.test.mjs",
     "scripts/installed-layout.test.mjs",
     "scripts/pi-model-switch.test.mjs",
     "scripts/pi-thinking-levels.test.mjs",
@@ -173,6 +174,7 @@
     "scripts/tool-runner.test.mjs",
     "scripts/tool-runtime-api.test.mjs",
     "scripts/tool-sharing.test.mjs",
+    "scripts/tool-shortcuts.test.mjs",
     "scripts/tool-env.test.mjs",
     "scripts/tool-llm.test.mjs",
     "scripts/extension-load.test.mjs",
@@ -276,6 +278,7 @@
     "scripts/narrow-layout.test.mjs",
     "scripts/scrollbar-style.test.mjs",
     "scripts/stream-tail-browser.test.mjs",
+    "scripts/scroll-restore-browser.test.mjs",
     "scripts/theme-contrast.test.mjs",
     "scripts/theme-switch-state.test.mjs",
     "scripts/settings-window-structure.test.mjs",

package/dist/.super-pi-check-inputs.json

@@ -1,4 +0,0 @@
-{
-  "hash": "d9a3c77ee4b675f896a08fbc2935cfb779351bdab1ebf0323c76747f4ae3e739",
-  "recordedAt": "2026-11-01T15:09:34.268Z"
-}