pi-web-ui 0.83.0 → 0.84.0

package/CHANGELOG.md

@@ -10,7 +10,29 @@
 
 ## [Unreleased]
 
-暂无其他未发布内容。
+## [0.84.0] — 2026-09-13
+
+### Added
+
+- **Git 视图的左栏可以拖宽了**（issue #139）—— 改动文件 / 提交历史那一栏原来固定 300px，路径或分支名一长就被截断且无处可展。现在拖它右边的分隔条即可调宽（**双击复位**），宽度**跨会话记住**（`localStorage`）；拖动时按容器宽度收敛，保证 diff 区不会被挤没（额外还有一条 `max-width` 兜底）。
+  - 与左右主面板同一套手感（拖动分隔条、双击复位、松开才写存档）；纯函数 `web/src/scm-sidebar.ts` + 单测 `tests/unit/scm-sidebar.test.ts`，真浏览器回归 `tests/scm-test.mjs`（拖 +120px → 刷新后保持 → 双击回 300px）。
+
+### Fixed
+
+- **正在聊的那条对话不再从左栏「运行的对话」里消失**（issue #140）—— 原来新对话只有「被换到后台且仍在流式输出」时才入列，于是你在当前对话里发消息时，左栏里根本没有它；只开一条对话时连「运行的对话」这个标题都不渲染，观感像是对话丢了。现在**当前对话一旦有内容**（有消息、或已被首条提示词命名）就立刻出现在列表里（还在流式输出时也会亮起绿点），行上标「当前」、点击是安全的空动作。
+  - **空白新对话仍然不入列**（连点「新建对话」不会堆出一排空条目），历史对话列表也不受影响。
+  - 这是**纯展示口径**：`listed` 的语义，以及「被挤出后台时是保留还是释放 runtime」「每项目 8 个上限」这些规则完全没变（换走时该释放的仍然释放）；列表里当前对话那一行的 ✕ 按同一口径判定，真能移出（不再静默无反应）。
+  - 回归：`tests/unit/…` 无（口径在服务端），零 token 协议测试 `tests/running-list-test.mjs`（空白不入列 / 流式中入列 / 跑完留住 / 当前行 ✕ 可移出 / 后台运行语义不变），真浏览器 `tests/panel-layout-test.mjs`（区标题、「当前」副标签、流式绿点、只有一行）。DSH 引擎同口径一并改了（共用同一套左栏与 wire 协议）。
+
+- **切项目时左栏不再闪一下项目名**（#140 那个改动的回归）—— 切项目会自动切到该项目的对话；如果切过去时那个项目只有一条对话（就是这条当前对话），列表里只有一组，它顶上原来会闪出一行项目名再消失（实测约 8ms 一帧）。原因是两个信号不同时到达：`conversations` 推送先到（activeId 已是新项目的对话），带新 `cwd` 的快照后到，只按 `cwd` 分组的那一帧就把当前项目当成了「别的项目」。
+  - 现在**只要当前对话在列表里，就认它所在的分组为当前项目**（`currentCwd` 只在它不在列表里时——空白新对话——作为回落），并直接置顶，顺带免掉随后的位置跳动；其他项目的后台运行照旧显示项目名。
+  - 分组逻辑抽成纯函数 `web/src/conv-groups.ts` + 单测 `tests/unit/conv-groups.test.ts`，另有真浏览器逐帧回归 `tests/conv-group-flash-test.mjs`（MutationObserver 记录每一帧 DOM，两个方向都断言不再渲染项目名；改回只看 `cwd` 即变红）。
+
+<!-- auto-i18n:start -->
+### i18n
+
+- 服务端新增 key（1）：`terminals.cwd.outside.workspace`
+<!-- auto-i18n:end -->
 
 ## [0.83.0] — 2026-09-13
 
@@ -686,7 +708,8 @@
 - 0.35.1（2026-08-27）：编辑重问保留附件（#18）+ 全窗口拖放（#19）。
 - 0.29.0（2026-08-23）：全局搜索弹窗（Ctrl+K）+ 消息列表惰性窗口化。
 
-[Unreleased]: https://github.com/xing-shuyin/pi-web-ui/compare/v0.83.0...main
+[Unreleased]: https://github.com/xing-shuyin/pi-web-ui/compare/v0.84.0...main
+[0.84.0]: https://github.com/xing-shuyin/pi-web-ui/releases/tag/v0.84.0
 [0.83.0]: https://github.com/xing-shuyin/pi-web-ui/releases/tag/v0.83.0
 [0.80.1]: https://github.com/xing-shuyin/pi-web-ui/releases/tag/v0.80.1
 [0.80.0]: https://github.com/xing-shuyin/pi-web-ui/releases/tag/v0.80.0

package/dist/server/agent-service.js

@@ -20,7 +20,7 @@ import { createRequire } from "node:module";
 import { existsSync, readFileSync, rmSync, statSync, mkdirSync, watch } from "node:fs";
 import { basename, delimiter, dirname, join, resolve, sep } from "node:path";
 import { fileURLToPath } from "node:url";
-import { createAgentSessionFromServices, createAgentSessionRuntime, createAgentSessionServices, createBashTool, createLocalBashOperations, getAgentDir, SessionManager, VERSION, } from "@earendil-works/pi-coding-agent";
+import { createAgentSessionFromServices, createAgentSessionRuntime, createAgentSessionServices, createBashToolDefinition, createLocalBashOperations, getAgentDir, SessionManager, VERSION, } from "@earendil-works/pi-coding-agent";
 import { Type } from "typebox";
 import { BgServerTracker } from "./bg-servers.js";
 import { checkAll as checkAllUpdates, collectTargets, compareVersions as compareSemver, } from "./update-check.js";
@@ -133,7 +133,7 @@ export function makeKillableBashTool(cwd, kills,
 /** per-call 返回文本的服务端语言（默认英文）；工具 definition 走 bilingual 内联双语。 */
 lang = () => "en") {
     const base = createLocalBashOperations();
-    const tool = createBashTool(cwd, {
+    const tool = createBashToolDefinition(cwd, {
         operations: {
             exec: async (command, c, opts) => {
                 const ac = new AbortController();
@@ -151,7 +151,7 @@ lang = () => "en") {
             },
         },
     });
-    // AgentTool → ToolDefinition (same fields; customTools expects definitions).
+    // Keep the SDK definition so execute receives the current session context.
     return {
         name: tool.name,
         label: tool.label,
@@ -175,8 +175,8 @@ lang = () => "en") {
         }),
         prepareArguments: tool.prepareArguments,
         executionMode: tool.executionMode,
-        execute: async (toolCallId, params, signal, onUpdate) => {
-            const result = (await tool.execute(toolCallId, params, signal, onUpdate));
+        execute: async (toolCallId, params, signal, onUpdate, ctx) => {
+            const result = (await tool.execute(toolCallId, params, signal, onUpdate, ctx));
             // head/tail 后处理（native 无终端，直接截返回行即可）。
             const p = params;
             if ((p?.head || p?.tail) && result?.content?.[0]?.text != null) {
@@ -1740,8 +1740,12 @@ export class ClientSession {
             session: runtime.session,
             cwd: runtime.cwd,
             createdAt: Date.now(),
-            // A brand-new conversation is not yet in the running list — it enters
-            // only when it is displaced to the background while still streaming.
+            // A brand-new conversation is not yet LISTED — it enters the running
+            // list only when it is displaced to the background while still
+            // streaming (its runtime is what `listed` protects). A blank chat is
+            // also kept out of the left panel's running list; it shows up there as
+            // soon as it has content while it is the active chat — see
+            // shownInRunningList (#140).
             listed: false,
             promptedSinceActive: false,
             lastActiveAt: Date.now(),
@@ -2327,6 +2331,10 @@ export class ClientSession {
                 const task = conv.pendingTask;
                 conv.pendingTask = undefined;
                 this.emitRun(conv, task ? { type: "run_start", task } : { type: "run_start" });
+                // #140：本轮真的开跑了（session.isStreaming 此刻已为 true）—— 左栏
+                // 那行的「流式中」标识要立刻亮起来：首条提示词的入列 emit 早于本轮
+                // 启动，那时它还是 false；后台对话被唤醒重跑也靠这里刷新。
+                this.emitConversations();
                 break;
             }
             case "turn_start": {
@@ -3523,6 +3531,8 @@ export class ClientSession {
             if (conv.title === DEFAULT_CONV_TITLE && text.trim() && !conv.session.sessionName?.trim()) {
                 const trimmed = text.trim().replace(/\s+/g, " ");
                 conv.title = trimmed.length > 30 ? `${trimmed.slice(0, 30)}…` : trimmed;
+                // 同时也是 #140 的入列时刻：这条对话从此有内容了，左栏「运行的对话」
+                // 立刻要有它（此刻还在流式输出，不能等 agent_end 的防抖刷新）。
                 this.emitConversations();
             }
             // Attach files as independent nextTurn context messages (asides) so the
@@ -4128,10 +4138,40 @@ export class ClientSession {
         this.notifyConversationChanged();
         this.flushSnapshot();
     }
+    /** 左栏「运行的对话」的展示口径（issue #140）。
+     *
+     *  老口径只有 listed：新对话要等「被换到后台且仍在跑」才入列 —— 用户正在聊的
+     *  那条反而不在列表里（只有它一条时，左栏连「运行的对话」标题都不渲染，观感
+     *  像是对话丢了）。新口径把「当前对话 + 已经有内容」也算进来：有消息的对话
+     *  （或已被首条提示词命名 —— 命名与首条消息是同一时刻，见 prompt() 里的
+     *  rename 块）立刻出现在列表里；空白新对话仍然不入列（防连点「新建对话」
+     *  堆出一排空条目）。
+     *
+     *  只影响「列表里推什么」：listed 本身的语义、以及 displaceActive /
+     *  shouldRetainActive / MAX_OPEN_CONVERSATIONS 那套「什么算运行中」的规则
+     *  完全不变（换走时该释放的仍然释放，不会被这次展示口径改动永久钉在列表里）。
+     *  Display-only: retention and disposal rules are deliberately untouched. */
+    shownInRunningList(conv) {
+        if (conv.listed)
+            return true;
+        if (conv.id !== this.activeId)
+            return false;
+        // 首条提示词给对话命名 = 用户真的开始聊了（此刻消息可能还没落进会话统计）。
+        if (conv.title !== DEFAULT_CONV_TITLE)
+            return true;
+        try {
+            return conv.session.getSessionStats().totalMessages > 0;
+        }
+        catch {
+            // 会话替换中 —— 先不列，下一次 emit 会补上
+            return false;
+        }
+    }
     /** Push every running conversation across ALL projects to the client. The
      *  running-conversation list is global so a background run from another
      *  workspace stays visible; clicking one switches both the conversation and
-     *  its project (see switchConversation). The client groups the list by cwd. */
+     *  its project (see switchConversation). The client groups the list by cwd.
+     *  推什么见 shownInRunningList（listed + 当前对话有内容时）。 */
     emitConversations() {
         const conversations = [];
         // Active parents are normally absent from Running. Keep them visible while
@@ -4141,7 +4181,7 @@ export class ClientSession {
             .map((conv) => conv.parentId)
             .filter(Boolean));
         for (const conv of this.convs.values()) {
-            if (!conv.listed && !visibleParents.has(conv.id))
+            if (!this.shownInRunningList(conv) && !visibleParents.has(conv.id))
                 continue;
             let messageCount = 0;
             let isStreaming = false;
@@ -4462,8 +4502,9 @@ export class ClientSession {
             });
             return;
         }
-        if (!conv.listed) {
-            // Not in list anyway — nothing to do.
+        if (!this.shownInRunningList(conv)) {
+            // Not in list anyway — nothing to do. 展示口径见 shownInRunningList
+            // （当前对话有内容时也在列表里，对它的 ✕ 必须真的移出，不能静默 no-op）。
             this.emitConversations();
             return;
         }

package/dist/server/dsh/dsh-agent-service.js

@@ -1121,11 +1121,18 @@ export class DshClientSession {
     pendingMessages() {
         return 0;
     }
+    /** 左栏展示口径（issue #140，与 pi 引擎同义）：listed 之外，当前对话只要有
+     *  内容（DSH 的对话消息全在内存里，直接数 messages）也在列表里；空白新对话
+     *  不入列。只影响展示，不动 listed 的语义。 */
+    shownInRunningList(conv) {
+        return conv.id === this.activeId && conv.messages.length > 0;
+    }
     emitConversations() {
         const list = [];
         for (const conv of this.convs.values()) {
-            // 只列被置换到后台的运行中会话（与 pi 一致）；active 会话不进“运行的对话”。
-            if (!conv.listed)
+            // 被置换到后台的会话 + 当前对话（一旦有内容就是用户正在聊的那条，
+            // 不该在列表里缺席——issue #140；空白新对话仍然不入列）。
+            if (!conv.listed && !this.shownInRunningList(conv))
                 continue;
             list.push({
                 id: conv.id,
@@ -1797,7 +1804,7 @@ export class DshClientSession {
             });
             return;
         }
-        if (!conv.listed) {
+        if (!conv.listed && !this.shownInRunningList(conv)) {
             this.emitConversations();
             return;
         }

package/dist/server/terminals.js

@@ -678,7 +678,7 @@ export class TerminalManager {
         this.history.delete(id);
         const safeCwd = this.safeCwd(cwd || fallbackCwd);
         if (!safeCwd) {
-            this.fail(id, "终端工作目录必须位于当前工作区内", "Terminal cwd must be inside the current workspace");
+            this.fail(id, pick(this.lang?.() ?? "en", "终端工作目录必须位于当前工作区内", "Terminal cwd must be inside the current workspace", "terminals.cwd.outside.workspace"), "Terminal cwd must be inside the current workspace");
             return null;
         }
         if (this.spawnShell(id, safeCwd, cols, rows, title || `终端 ${++this.seq}`, undefined, opts?.forceBash, opts?.agentBash, opts?.locale)) {
@@ -720,7 +720,7 @@ export class TerminalManager {
         const command = expandPwd(def.command.trim(), pwd);
         const title = def.name || command || `终端 ${++this.seq}`;
         if (!dir) {
-            this.fail(id, "终端工作目录必须位于当前工作区内", "Terminal cwd must be inside the current workspace");
+            this.fail(id, pick(this.lang?.() ?? "en", "终端工作目录必须位于当前工作区内", "Terminal cwd must be inside the current workspace", "terminals.cwd.outside.workspace"), "Terminal cwd must be inside the current workspace");
             return;
         }
         if (existing) {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pi-web-ui",
-	"version": "0.83.0",
+	"version": "0.84.0",
 	"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",
 	"author": {

package/web/dist/assets/{TerminalPanel-BF99sld0.js → TerminalPanel-B7W10RgC.js}

@@ -1,4 +1,4 @@
-import{a as l,j as n}from"./markdown-D3PKeHAZ.js";import{u as P,b as O,T as M,a as p,c as W,F as Y,d as z,e as Z,f as H,g as ee,h as ne,i as te,j as se,r as ae}from"./index-D__1RagK.js";import{D as re,o as ie}from"./xterm-B96xOxS9.js";import"./react-w24rH0km.js";function le(t){let c=null;return{clean:t.replace(/\r?\n?\[pi-term-exit:(-?\d+)\]\r?\n?/g,(h,u)=>(c=Number(u),`\r
+import{a as l,j as n}from"./markdown-D3PKeHAZ.js";import{u as P,b as O,T as M,a as p,c as W,F as Y,d as z,e as Z,f as H,g as ee,h as ne,i as te,j as se,r as ae}from"./index-B1_0cm7B.js";import{D as re,o as ie}from"./xterm-B96xOxS9.js";import"./react-w24rH0km.js";function le(t){let c=null;return{clean:t.replace(/\r?\n?\[pi-term-exit:(-?\d+)\]\r?\n?/g,(h,u)=>(c=Number(u),`\r
 `)).replace(/\r?\n?\x1b\[90m\[(?:进程已退出，退出码 |Process exited with code )-?\d+\]\x1b\[0m\r?\n?/g,`\r
 `),exitCode:c}}function ce({conversationId:t,terminalId:c,command:s,cwd:h,title:u,active:w,running:f,exitCode:k,register:g}){const C=l.useRef(null),j=l.useRef(null),{locale:o}=P(),y=l.useRef(o);y.current=o;const E=s?JSON.stringify(s):"";l.useEffect(()=>{const m=C.current;if(!m)return;const r=new re({theme:O(),fontFamily:'"SF Mono", "JetBrains Mono", ui-monospace, Menlo, Consolas, monospace',fontSize:13,cursorBlink:!0,scrollback:8e3}),v=new ie;r.loadAddon(v),r.open(m),j.current={term:r,fit:v},w&&r.focus();const b=()=>{r.options.theme=O()};window.addEventListener(M,b),r.attachCustomKeyEventHandler(d=>{if(d.type!=="keydown")return!0;const S=d.key?.toLowerCase();if((d.ctrlKey||d.metaKey)&&S==="v")return!1;if(d.ctrlKey&&!d.shiftKey&&!d.altKey&&S==="c"&&r.hasSelection()){const D=r.textarea;return D&&(D.value=r.getSelection(),D.select()),!1}return!0});const _=g(t,c,{write:d=>r.write(le(d).clean),dispose:()=>r.dispose()}),$=()=>{try{v.fit(),p({type:"terminal_resize",terminalId:c,conversationId:t,cols:r.cols,rows:r.rows})}catch{}},B=requestAnimationFrame(()=>{try{v.fit()}catch{}s?p({type:"run_command",terminalId:c,conversationId:t,command:s,cols:r.cols,rows:r.rows}):p({type:"terminal_create",terminalId:c,title:u,locale:y.current,conversationId:t,cwd:h,cols:r.cols,rows:r.rows})}),R=r.onData(d=>{p({type:"terminal_input",terminalId:c,conversationId:t,data:d})});let T=null;return typeof ResizeObserver<"u"&&(T=new ResizeObserver(()=>{m.offsetWidth>0&&m.offsetHeight>0&&$()}),T.observe(m)),()=>{cancelAnimationFrame(B),R.dispose(),window.removeEventListener(M,b),T?.disconnect(),_(),r.dispose(),j.current=null}},[t,c,E,g]),l.useEffect(()=>{if(!w)return;const m=requestAnimationFrame(()=>{const r=j.current;if(r){try{r.fit.fit(),p({type:"terminal_resize",terminalId:c,conversationId:t,cols:r.term.cols,rows:r.term.rows})}catch{}r.term.focus()}});return()=>cancelAnimationFrame(m)},[w]);const{t:F}=P(),x=l.useRef(void 0);return l.useEffect(()=>{if(f===x.current||(x.current=f,f!==!1))return;const m=j.current;m&&m.term.write(`\r
 \x1B[90m${F("exitBanner",{code:k??""})}\x1B[0m\r