pi-webapp 0.1.12 → 0.1.14

package/README.md

@@ -46,6 +46,8 @@ In Pi, enter `/web` to open the interface in your default browser. Pi also print
 
 If you enter `/web` manually in a Pi terminal, that terminal session stays synchronized with the browser. With the launcher, Pi runs in the background. Sessions opened in other workspaces use the Pi SDK and load that workspace's skills and project context. They load enabled Web plugin Pi entries explicitly while keeping other Pi extensions isolated from the parent bridge.
 
+Chats run independently: switching workspaces or chats, or creating a new chat, leaves existing tasks running in the background. Returning to a chat restores its running output, history, and pending plugin interactions. Stop affects only the selected chat. Sessions remain in memory until the Pi service stops; stopping or restarting the service ends background tasks.
+
 On startup, the app discovers workspaces from Pi's saved sessions, so conversations from other directories appear in the sidebar. Workspace records and attachments stay under Pi's existing `pi-web/` data directory. Removing a workspace from the sidebar does not delete its files or sessions; you can add it again manually.
 
 ## Develop locally

package/README.zh-CN.md

@@ -46,6 +46,8 @@ pi
 
 如果通过 Pi 终端手动输入 `/web`，该终端会话会与浏览器保持同步。使用启动器时，Pi 在后台运行。在其他工作区打开的会话使用 Pi SDK，并加载该工作区的技能和项目上下文；已启用的 Web 插件 Pi 入口会显式加载，其他普通 Pi 扩展仍与主会话隔离。
 
+每个聊天独立运行：切换工作区、切换聊天或新建聊天时，原任务会继续在后台执行。切回后会恢复正在输出的内容、历史记录和待处理的插件交互。“停止”只影响当前选中的聊天。会话实例会保留到 Pi 服务停止；停止或重启服务会结束后台任务。
+
 启动时会从 Pi 已保存的会话中发现工作区，因此先前在其他目录使用 Pi 的会话也会出现在侧边栏。工作区记录和附件继续存放在 Pi 现有的 `pi-web/` 数据目录下。从侧边栏移除工作区不会删除其文件或会话；移除后如需再次显示，可以手动添加。
 
 ## 本地开发

package/bin/pi-webapp.mjs

@@ -131,26 +131,43 @@ async function serve(pi, args) {
   let runningUrl = null;
   let buffer = "";
   let killTimer;
+  let stopReason;
+  let forceStopRequested = false;
+  const instanceId = randomUUID();
+  const startedAt = performance.now();
+  const lifecycle = (event, fields = {}) => {
+    try {
+      console.error(JSON.stringify({ timestamp: new Date().toISOString(), event,
+        level: event === "pi_process_exit" && (!stopping || failed) ? "error" : "info",
+        instanceId, pid: process.pid, piPid: child.pid, uptimeMs: Math.round(performance.now() - startedAt), ...fields }));
+    } catch { /* Diagnostics must not interrupt process supervision. */ }
+  };
   const devWatchers = [];
   let devReloadTimer;
   let devReloadCount = 0;
   let devReloadCommand;
-  const shutdown = () => {
+  const shutdown = (reason) => {
     if (stopping) return;
     stopping = true;
+    stopReason = reason;
+    lifecycle("launcher_stop_requested", { reason });
     child.stdin?.end();
-    killTimer = setTimeout(() => child.kill("SIGTERM"), 5000);
+    killTimer = setTimeout(() => {
+      forceStopRequested = true;
+      lifecycle("pi_force_stop", { reason, signal: "SIGTERM" });
+      child.kill("SIGTERM");
+    }, 5000);
     killTimer.unref();
   };
   const fail = (message) => {
     if (failed || ready) return;
     failed = true;
     notifyParent({ type: "error", message });
-    shutdown();
+    shutdown("startup_failure");
   };
   const startupTimer = setTimeout(() => fail(`Pi 启动超时。日志：${logPath}`), 60000);
   const stopTimer = setInterval(async () => {
-    try { if ((await readFile(stopPath, "utf8")).trim() === nonce) shutdown(); }
+    try { if ((await readFile(stopPath, "utf8")).trim() === nonce) shutdown("stop_request"); }
     catch { /* No stop request. */ }
     if (stopping) return;
     try {
@@ -158,12 +175,12 @@ async function serve(pi, args) {
       const prepared = JSON.parse(await readFile(updatePath, "utf8"));
       if (request.nonce === nonce && request.launcher === prepared.launcher && existsSync(request.launcher)) {
         restartRequest = request;
-        shutdown();
+        shutdown("restart_request");
       }
     } catch { /* No valid restart request. */ }
   }, 400);
-  process.on("SIGTERM", shutdown);
-  process.on("SIGINT", shutdown);
+  process.on("SIGTERM", () => shutdown("signal_sigterm"));
+  process.on("SIGINT", () => shutdown("signal_sigint"));
   child.stdout?.on("data", (chunk) => {
     if (failed) return;
     buffer += chunk.toString("utf8");
@@ -210,6 +227,7 @@ async function serve(pi, args) {
           if (closed || failed) return;
           ready = true;
           clearTimeout(startupTimer);
+          lifecycle("launcher_ready", { port: Number(url.port) });
           notifyParent({ type: "ready", pid: process.pid, url: url.href });
           for (const root of pluginRoots) {
             try {
@@ -233,8 +251,11 @@ async function serve(pi, args) {
   child.stdin?.write(JSON.stringify({ id: "list-commands", type: "get_commands" }) + "\n");
   await new Promise((resolveExit) => {
     child.once("error", (error) => { fail(`无法启动 Pi：${error.message}`); resolveExit(); });
-    child.once("close", (code) => {
+    child.once("close", (code, signal) => {
       closed = true;
+      lifecycle("pi_process_exit", { ready, exitCode: code, signal,
+        reason: stopReason ?? (ready ? "unexpected_exit" : "startup_failure"), forceStopRequested,
+        port: runningUrl ? Number(new URL(runningUrl).port) : null });
       if (!ready) fail(`Pi 提前退出（代码 ${code ?? "未知"}）。日志：${logPath}`);
       resolveExit();
     });