pi-web-ui 0.20.0 → 0.20.1

package/dist/server/agent-service.js

@@ -225,14 +225,14 @@ function decodeText(buf) {
  *  programs wait for input that never comes. Legacy Chinese files are often
  *  GBK/GB2312 — read them with the right encoding, never paste mojibake into
  *  reasoning/answers. */
-const WINDOWS_PERSONA = `You are a coding agent running on Windows. The bash tool runs Git Bash (bash.exe), not PowerShell. Follow these rules to avoid hanging the session:
-
-
-
-- ALWAYS pass a timeout parameter to the bash tool (in seconds). There is NO default timeout — a command that never finishes (servers, watchers, infinite loops, slow downloads/installs) will hang the entire conversation indefinitely. Pick a generous timeout for long-running work, but never omit it.
-- NEVER run interactive or foreground long-running commands through the bash tool (vi, less, top, python -, node -, npm run dev, sleep 10000). For servers/daemons use background execution with output redirected to a log file, then poll the log; stop them when done.
-- In the interactive terminal (TTY) — which is Git Bash too, not PowerShell — NEVER use heredocs (<<'EOF' ... EOF) or here-strings, and NEVER start interactive programs (vi, less, python -, node -, npm init): they wait for keyboard input that never arrives and hang the terminal forever. Prefer writing a temp script file (e.g. .pi-tmp.sh) and running it non-interactively. ALWAYS pass a timeout to long-running commands (e.g. \`timeout 120 npm run dev\`).
-
+const WINDOWS_PERSONA = `You are a coding agent running on Windows. The bash tool runs Git Bash (bash.exe), not PowerShell. Follow these rules to avoid hanging the session:
+
+
+
+- ALWAYS pass a timeout parameter to the bash tool (in seconds). There is NO default timeout — a command that never finishes (servers, watchers, infinite loops, slow downloads/installs) will hang the entire conversation indefinitely. Pick a generous timeout for long-running work, but never omit it.
+- NEVER run interactive or foreground long-running commands through the bash tool (vi, less, top, python -, node -, npm run dev, sleep 10000). For servers/daemons use background execution with output redirected to a log file, then poll the log; stop them when done.
+- In the interactive terminal (TTY) — which is Git Bash too, not PowerShell — NEVER use heredocs (<<'EOF' ... EOF) or here-strings, and NEVER start interactive programs (vi, less, python -, node -, npm init): they wait for keyboard input that never arrives and hang the terminal forever. Prefer writing a temp script file (e.g. .pi-tmp.sh) and running it non-interactively. ALWAYS pass a timeout to long-running commands (e.g. \`timeout 120 npm run dev\`).
+
 Many legacy Chinese text files (.html/.txt/.md/.log, exported documents) are GBK/GB2312 encoded: the read tool decodes UTF-8 only and will show mojibake (乱码) for them. If a file's content looks garbled, read it through the terminal instead: in Git Bash use \`cat file | iconv -f GBK -t UTF-8\` (or \`iconv -f GBK -t UTF-8 file\`); in cmd use \`chcp 65001 && type file\`; in PowerShell use \`Get-Content -Encoding Default file\`. Never paste mojibake into your reasoning or answer — describe the decoded content instead.`;
 /**
  * Killable bash tool: wraps the SDK bash tool with operations that register
@@ -1565,6 +1565,8 @@ export class ClientSession {
      * the process is going to restart itself (so the notice can say so).
      */
     onUpdateReady = undefined;
+    /** Set by index.ts: called when /pi-web-ui:quit is invoked. */
+    onQuit = undefined;
     /** Ask the npm registry for the latest pi-web-ui version and report it. */
     async checkUpdate() {
         const current = ClientSession.currentAppVersion();
@@ -2038,19 +2040,22 @@ export class ClientSession {
      * (they never reach the server) but stay listed so the picker shows them.
      */
     static NATIVE_COMMANDS = [
-        { name: "new", description: "新建对话" },
-        { name: "model", description: "切换模型", argumentHint: "[名称]" },
-        { name: "compact", description: "压缩上下文", argumentHint: "[说明]" },
-        { name: "cwd", description: "切换工作目录", argumentHint: "<路径>" },
+        { name: "new", description: "新建对话", descriptionEn: "New chat" },
+        { name: "model", description: "切换模型", descriptionEn: "Switch model", argumentHint: "[名称]", argumentHintEn: "[name]" },
+        { name: "compact", description: "压缩上下文", descriptionEn: "Compact context", argumentHint: "[说明]", argumentHintEn: "[instructions]" },
+        { name: "cwd", description: "切换工作目录", descriptionEn: "Switch workspace", argumentHint: "<路径>", argumentHintEn: "<path>" },
         {
             name: "thinking",
             description: "设置思考强度",
-            argumentHint: "<off|low|medium|high>",
+            descriptionEn: "Set thinking level",
+            argumentHint: "<off|low|medium|high|xhigh|max>",
+            argumentHintEn: "<off|low|medium|high|xhigh|max>",
         },
-        { name: "resume", description: "刷新会话列表" },
-        { name: "reload", description: "重新加载扩展、技能与模板" },
-        { name: "help", description: "显示全部命令" },
-        { name: "copy", description: "复制上一条助手回复" },
+        { name: "resume", description: "刷新会话列表", descriptionEn: "Refresh session list" },
+        { name: "reload", description: "重新加载扩展、技能与模板", descriptionEn: "Reload extensions, skills & templates" },
+        { name: "help", description: "显示全部命令", descriptionEn: "Show all commands" },
+        { name: "copy", description: "复制上一条助手回复", descriptionEn: "Copy last assistant reply" },
+        { name: "pi-web-ui:quit", description: "退出服务", descriptionEn: "Quit server (supervisor will restart)" },
     ];
     /** Parse a prompt into "/command args" — returns null when it isn't one. */
     parseSlash(text) {
@@ -2190,6 +2195,20 @@ export class ClientSession {
                     });
                 }
                 return true;
+            case "pi-web-ui:quit": {
+                this.emit({
+                    type: "notice",
+                    level: "info",
+                    text: "正在退出 pi-web-ui… supervisor 将自动重启服务",
+                });
+                setTimeout(() => {
+                    const didSchedule = this.onQuit?.() ?? false;
+                    if (!didSchedule) {
+                        setTimeout(() => process.exit(0), 100);
+                    }
+                }, 300);
+                return true;
+            }
             case "help":
             case "copy":
                 // Client-side UI actions — the client handles them before sending;
@@ -4349,6 +4368,8 @@ export class AgentService {
      * self-update; returns whether the process will restart itself.
      */
     onUpdateReady = undefined;
+    /** Set by index.ts: called when /pi-web-ui:quit is invoked. */
+    onQuit = undefined;
     constructor(cwd, stateFile) {
         this.cwd = cwd;
         this.stateStore = new ClientStateStore(stateFile);
@@ -4394,8 +4415,9 @@ export class AgentService {
             }
         }
         cs.attachSink(send);
-        // Forward the update hook (set once by index.ts) to every session.
+        // Forward hooks (set once by index.ts) to every session.
         cs.onUpdateReady = this.onUpdateReady;
+        cs.onQuit = this.onQuit;
         return cs;
     }
     /** Remove a socket from a client's broadcast set (called on socket close). */

package/dist/server/index.js

@@ -189,6 +189,26 @@ function scheduleUpdateRestart() {
     return true;
 }
 service.onUpdateReady = scheduleUpdateRestart;
+function scheduleQuit() {
+    const isLaunchd = process.platform === "darwin" && process.ppid === 1;
+    const isSystemd = process.platform === "linux" && !!process.env.INVOCATION_ID;
+    const inDocker = existsSync("/.dockerenv");
+    if (isLaunchd || isSystemd || inDocker) {
+        setTimeout(() => {
+            console.log("pi-web-ui:quit — shutting down (supervisor will restart)…");
+            if (isSystemd)
+                process.exit(3);
+            void shutdown();
+        }, 300);
+        return true;
+    }
+    setTimeout(() => {
+        console.log("pi-web-ui:quit — shutting down (restart to reload)…");
+        void shutdown();
+    }, 300);
+    return true;
+}
+service.onQuit = scheduleQuit;
 wss.on("connection", (ws) => {
     let clientId = null;
     let closed = false;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-web-ui",
-  "version": "0.20.0",
+  "version": "0.20.1",
   "description": "Web chat interface for the pi coding agent, powered by the pi SDK (@earendil-works/pi-coding-agent) — one-command run, Docker/systemd/launchd deployable",
   "license": "MIT",
   "type": "module",