pi-web-ui 0.68.0 → 0.68.1

package/dist/server/index.js

@@ -36,7 +36,7 @@ import { startControlServer } from "./control-socket.js";
 import { scheduleUploadCleanup } from "./uploads.js";
 import { ensureWindowsBash, windowsBashDir } from "./ensure-bash.js";
 import { listThemes, resolveThemeFile } from "./themes.js";
-import { PluginManager, resolvePluginClientFile } from "./plugins.js";
+import { PluginManager, resolvePluginClientFile, } from "./plugins.js";
 import { McpBridge } from "./mcp-bridge.js";
 /** 从 CLI 参数中取 flag 值：支持 --flag value 与 --flag=value 两种写法。
  *  让 `node dist/server/index.js --host 0.0.0.0 --port 9000` 这类直接启动也能生效，
@@ -447,6 +447,12 @@ void mcpBridge.load().then(() => {
 });
 // 插件扩展点：SDK 工具执行事件（bash/读文件等 start+end）转发给已注册的插件。
 service.onToolEvent = (ev) => pluginMgr.emitToolEvent(ev);
+service.onRunEvent = (ev) => pluginMgr.emitRunEvent(ev);
+// 插件扩展点：对话切换通知（轨迹视图切会话后即重拉；dsh 引擎暂无）。
+service.onConversationChanged = () => pluginMgr.emitConversationChanged();
+// 插件扩展点：当前打开对话的快照（轨迹视图直接显示打开对话的时间线；
+// dsh 引擎无此方法时回退 null，插件显示空态）。
+pluginMgr.conversationProvider = () => service.readConversationForPlugins?.() ?? null;
 // 插件扩展点：插件注册的 AI 工具（registerAgentTool）+ MCP 桥工具 → 会话创建时
 // 带上 + 变化时动态注入/移除已有会话。
 service.pluginToolsProvider = () => [...pluginMgr.getAgentTools(), ...mcpBridge.getTools()];

package/dist/server/plugins.js

@@ -457,6 +457,50 @@ export class PluginManager {
             }
         }
     }
+    /** index.ts 注入：读取当前打开对话的快照（轨迹类插件经 host.getActiveConversation 调用）。 */
+    conversationProvider = undefined;
+    /** 当前打开对话的快照（无提供者/暂无对话时返回 null）。 */
+    getActiveConversation() {
+        try {
+            return this.conversationProvider?.() ?? null;
+        }
+        catch (err) {
+            console.error("[plugins] conversationProvider failed:", err);
+            return null;
+        }
+    }
+    /** agent-service 调：当前打开对话变了（切历史会话/切 running 对话/新对话）——
+     *  轨迹类插件靠它重拉时间线（异常隔离）。 */
+    emitConversationChanged() {
+        for (const p of this.loaded.values()) {
+            if (p.convChangeHandlers.size === 0)
+                continue;
+            for (const h of p.convChangeHandlers) {
+                try {
+                    h();
+                }
+                catch (err) {
+                    console.error(`[plugin:${p.info.id}] conversation-changed handler failed:`, err);
+                }
+            }
+        }
+    }
+    /** agent-service 调：把运行轨迹事件扇出给所有插件（异常隔离，
+     *  与 emitToolEvent 同级；订阅者崩了只记日志，不影响主流程）。 */
+    emitRunEvent(ev) {
+        for (const p of this.loaded.values()) {
+            if (p.runHandlers.size === 0)
+                continue;
+            for (const h of p.runHandlers) {
+                try {
+                    h(ev);
+                }
+                catch (err) {
+                    console.error(`[plugin:${p.info.id}] run-event handler failed:`, err);
+                }
+            }
+        }
+    }
     /** 当前全部插件注册的 AI 工具（扁平化，按插件 id 稳定排序）。 */
     getAgentTools() {
         const out = [];
@@ -697,6 +741,8 @@ export class PluginManager {
         const handlers = new Set();
         this.messageHandlers.set(info.id, handlers);
         const toolHandlers = new Set();
+        const runHandlers = new Set();
+        const convChangeHandlers = new Set();
         const attachHandlers = new Set();
         const cwdHandlers = new Set();
         const httpRoutes = new Map();
@@ -717,6 +763,8 @@ export class PluginManager {
             this.loaded.set(info.id, {
                 info: { ...info, error: msg },
                 toolHandlers,
+                runHandlers,
+                convChangeHandlers,
                 attachHandlers,
                 cwdHandlers,
                 httpRoutes,
@@ -732,6 +780,8 @@ export class PluginManager {
         const p = {
             info,
             toolHandlers,
+            runHandlers,
+            convChangeHandlers,
             attachHandlers,
             cwdHandlers,
             commandUnsubscribers: unregisterCommands,
@@ -774,6 +824,15 @@ export class PluginManager {
                 toolHandlers.add(h);
                 return () => toolHandlers.delete(h);
             },
+            onRunEvent: (h) => {
+                runHandlers.add(h);
+                return () => runHandlers.delete(h);
+            },
+            onConversationChanged: (h) => {
+                convChangeHandlers.add(h);
+                return () => convChangeHandlers.delete(h);
+            },
+            getActiveConversation: () => self.getActiveConversation(),
             onAttach: (h) => {
                 attachHandlers.add(h);
                 return () => attachHandlers.delete(h);
@@ -893,6 +952,8 @@ export class PluginManager {
                 info: { ...info },
                 deactivate: typeof ret === "function" ? ret : undefined,
                 toolHandlers,
+                runHandlers,
+                convChangeHandlers,
                 attachHandlers,
                 cwdHandlers,
                 agentToolUnsubscribers: unregisterTools,
@@ -911,6 +972,8 @@ export class PluginManager {
             this.loaded.set(info.id, {
                 info: { ...info, error: err.message },
                 toolHandlers,
+                runHandlers,
+                convChangeHandlers,
                 attachHandlers,
                 cwdHandlers,
                 httpRoutes,

package/dist/server/serialize.js

@@ -59,6 +59,30 @@ function serializeAssistantContent(content) {
         return { type: "unknown", ...b };
     });
 }
+/**
+ * Hide transient LLM failures while an auto-retry is pending.
+ *
+ * The SDK finalizes the failed assistant message (message_end, then agent_end
+ * with willRetry) BEFORE it slices the message out of state and backs off, so
+ * a snapshot taken in between would paint a red error that vanishes one frame
+ * later. While `retryActive` the trailing stopReason=error assistant messages
+ * are intermediate state: dropped here (retry success → the user never sees
+ * them; exhaustion → auto_retry_end clears the flag and the message renders
+ * red permanently). Non-trailing content is never touched.
+ */
+export function stripTransientRetryErrors(messages, retryActive) {
+    if (!retryActive)
+        return messages;
+    let end = messages.length;
+    while (end > 0) {
+        const m = messages[end - 1];
+        if (m.role === "assistant" && m.stopReason === "error")
+            end -= 1;
+        else
+            break;
+    }
+    return end === messages.length ? messages : messages.slice(0, end);
+}
 export function serializeMessage(m, seq) {
     switch (m.role) {
         case "user":

package/dist/server/vision-bridge.js

@@ -35,15 +35,15 @@ export function findVisionModels(runtime) {
  * Exported so the settings panel can offer a custom prompt (append to this
  * default or replace it entirely).
  */
-export const SYSTEM_PROMPT = `You are a vision bridge for a text-only language model. You receive one or more images and must transcribe them into precise, structured text evidence so another model that cannot see images can answer questions about them accurately.
-
-Follow these rules:
-1. Transcribe ALL visible text verbatim, preserving wording, spelling, punctuation and line breaks. This is the most important part — the reader relies on your transcription, not on the image.
-2. Describe the layout in reading order: headers, paragraphs, lists, tables, buttons, panels — say what appears where.
-3. For tables/charts/diagrams: read axes, scales (note log scale), legend entries, series names, highlighted points and their coordinates, and any data values you can discern.
-4. Name entities: people, products, companies, colors, style, objects, actions.
-5. If part of the image is too blurry/low-resolution to read, say "（读不清）" or "unclear" for that part — NEVER invent or guess content you cannot see.
-6. If there are multiple images, address them in order (图 1 / Image 1, 图 2 / Image 2, ...).
+export const SYSTEM_PROMPT = `You are a vision bridge for a text-only language model. You receive one or more images and must transcribe them into precise, structured text evidence so another model that cannot see images can answer questions about them accurately.
+
+Follow these rules:
+1. Transcribe ALL visible text verbatim, preserving wording, spelling, punctuation and line breaks. This is the most important part — the reader relies on your transcription, not on the image.
+2. Describe the layout in reading order: headers, paragraphs, lists, tables, buttons, panels — say what appears where.
+3. For tables/charts/diagrams: read axes, scales (note log scale), legend entries, series names, highlighted points and their coordinates, and any data values you can discern.
+4. Name entities: people, products, companies, colors, style, objects, actions.
+5. If part of the image is too blurry/low-resolution to read, say "（读不清）" or "unclear" for that part — NEVER invent or guess content you cannot see.
+6. If there are multiple images, address them in order (图 1 / Image 1, 图 2 / Image 2, ...).
 7. Output only the transcript. No preamble, no commentary about the image itself.`;
 /**
  * Assemble the final vision-model system prompt from the settings-panel prefs.

package/extensions/webui.ts

@@ -1,190 +1,190 @@
-/**
- * pi-web-ui 的 pi 扩展 —— 提供命令行集成。
- *
- * 能力：
- *   /webui                      启动本机 pi-web-ui 服务器，打开浏览器访问
- *   /webui --port 9000          指定端口启动
- *   /webui --no-browser         启动但不开浏览器
- *   /webui stop                 停止已启动的服务器
- *   /webui status               查看运行状态 / URL
- *
- * 实现说明：
- *   - 不依赖全局 bin（pi install 后 pi-web-ui 命令不一定在 PATH），直接用
- *     node 调包内 dist/server/index.js，通过环境变量 PORT / PI_WEB_CWD /
- *     PI_WEB_DATA_DIR 控制。
- *   - 工作目录默认用当前 pi 会话的 ctx.cwd；可用 --cwd / path 覆盖。
- *   - 服务器作为子进程后台运行，/webui 不阻塞 pi。
- *   - 每个 pi 会话管理一个子进程；session_shutdown 时清理，避免孤儿进程。
- */
-
-import { spawn } from "node:child_process";
-import { existsSync } from "node:fs";
-import { dirname, join, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-import net from "node:net";
-import type { ExtensionAPI, ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
-
-// 本文件位于 <pkg>/extensions/webui.ts → 包根在上一级
-const PKG_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), "..");
-const SERVER_ENTRY = join(PKG_ROOT, "dist", "server", "index.js");
-const NODE = process.execPath;
-
-/** 每个会话的服务器子进程 + 元数据 */
-interface RunningServer {
-	proc: ReturnType<typeof spawn>;
-	port: number;
-	cwd: string;
-	url: string;
-}
-
-// 会话 → 运行实例（模块级 Map；每会话一个会话对象，无需清理全局）
-const running = new Map<string, RunningServer>();
-
-/** 找一个空闲端口 */
-function findFreePort(from = 8787): Promise<number> {
-	return new Promise((resolve_, reject) => {
-		const srv = net.createServer();
-		srv.listen(from, () => {
-			const port = (srv.address() as net.AddressInfo).port;
-			srv.close(() => resolve_(port));
-		});
-		srv.on("error", () => {
-			// 端口被占则顺延
-			findFreePort(from + 1).then(resolve_, reject);
-		});
-	});
-}
-
-/** 解析 --key value / --flag 参数 */
-function parseArgs(args: string): { port?: number; cwd?: string; noBrowser: boolean } {
-	const out: { port?: number; cwd?: string; noBrowser: boolean } = { noBrowser: false };
-	const toks = args.split(/\s+/).filter(Boolean);
-	for (let i = 0; i < toks.length; i++) {
-		const t = toks[i];
-		if ((t === "--port" || t === "-p") && toks[i + 1]) {
-			const n = Number(toks[++i]);
-			if (Number.isInteger(n) && n > 0 && n < 65536) out.port = n;
-		} else if (t === "--cwd" && toks[i + 1]) {
-			out.cwd = resolve(toks[++i]);
-		} else if (t === "--no-browser") {
-			out.noBrowser = true;
-		}
-	}
-	return out;
-}
-
-/** 打开浏览器 */
-async function openBrowser(url: string): Promise<void> {
-	const { platform } = process;
-	const [cmd, ...rest] =
-		platform === "darwin" ? ["open", url] : platform === "win32" ? ["cmd", "/c", "start", "", url] : ["xdg-open", url];
-	// 无界面环境缺少 xdg-open 等打开器时，ENOENT 以异步 'error' 事件触发，
-	// try/catch 拦不住会崩掉整个进程 —— 必须挂 error 监听。
-	spawn(cmd, rest, { stdio: "ignore", detached: true })
-		.on("error", (err) => {
-			if ((err as NodeJS.ErrnoException)?.code === "ENOENT") {
-				console.warn(
-					`[webui] 未找到浏览器打开器 (${(err as NodeJS.ErrnoException).path || "command not found"})，请用 --no-browser 关闭自动打开`,
-				);
-			} else {
-				console.warn("[webui] 打开浏览器失败:", err.message);
-			}
-		})
-		.unref();
-}
-
-export default function (pi: ExtensionAPI): void {
-	pi.registerCommand("webui", {
-		description: "启动本机 pi-web-ui Web 界面（/webui [--port N] [--cwd PATH] [--no-browser] | stop | status）",
-		handler: async (args: string, ctx: ExtensionCommandContext) => {
-			const sid = ctx.sessionManager.getSessionId();
-			const opts = parseArgs(args);
-			const action = (args.split(/\s+/)[0] || "start").toLowerCase();
-
-			// 停止
-			if (action === "stop" || action === "kill") {
-				const inst = running.get(sid);
-				if (!inst) {
-					ctx.ui.notify("没有正在运行的本机 pi-web-ui 服务器", "info");
-					return;
-				}
-				inst.proc.kill("SIGTERM");
-				running.delete(sid);
-				ctx.ui.notify(`已停止 pi-web-ui (${inst.url})`, "info");
-				return;
-			}
-
-			// 状态
-			if (action === "status") {
-				const inst = running.get(sid);
-				if (!inst) {
-					ctx.ui.notify("本机 pi-web-ui 未运行", "info");
-					return;
-				}
-				const alive = inst.proc.exitCode === null;
-				ctx.ui.notify(
-					alive
-						? `pi-web-ui 运行中 → ${inst.url}\n端口 ${inst.port} · cwd ${inst.cwd}`
-						: `已退出(exit=${inst.proc.exitCode})`,
-					alive ? "info" : "warning",
-				);
-				return;
-			}
-
-			// 默认 start
-			if (action !== "start" && action !== "run") {
-				ctx.ui.notify(`未知动作 ${action}（可用 start|stop|status）`, "warning");
-				return;
-			}
-
-			// 已运行则提示
-			const existing = running.get(sid);
-			if (existing && existing.proc.exitCode === null) {
-				ctx.ui.notify(`pi-web-ui 已在运行 → ${existing.url}`, "info");
-				return;
-			}
-
-			// 检查是否已构建
-			if (!existsSync(SERVER_ENTRY)) {
-				ctx.ui.notify(
-					"缺少 dist/ 产物（当前安装未包含已构建前端）。请运行 `npm run build` 后重试，或用 pi-web-ui 官方 npm 包。",
-					"warning",
-				);
-				return;
-			}
-
-			const port = opts.port ?? (await findFreePort());
-			const cwd = opts.cwd ?? ctx.cwd;
-			const url = `http://localhost:${port}`;
-
-			const env = {
-				...process.env,
-				PORT: String(port),
-				PI_WEB_CWD: cwd,
-				...(process.env.PI_WEB_DATA_DIR ? {} : { PI_WEB_DATA_DIR: join(cwd, ".pi-web") }),
-			};
-			const proc = spawn(NODE, [SERVER_ENTRY], { cwd, env, stdio: "ignore", detached: true });
-			proc.unref();
-			running.set(sid, { proc, port, cwd, url });
-
-			ctx.ui.notify(`pi-web-ui 启动中 → ${url}\n端口 ${port} · cwd ${cwd}\n(几秒后可用，/webui status 查看)`);
-
-			if (!opts.noBrowser) await openBrowser(url);
-
-			// 进程退出时清理
-			proc.on("exit", () => {
-				if (running.get(sid)?.proc === proc) running.delete(sid);
-			});
-		},
-	});
-
-	// 会话结束清理子进程，避免孤儿
-	pi.on("session_shutdown", async (_event, ctx) => {
-		const sid = ctx.sessionManager.getSessionId();
-		const inst = running.get(sid);
-		if (inst && inst.proc.exitCode === null) {
-			inst.proc.kill("SIGTERM");
-			running.delete(sid);
-		}
-	});
-}
+/**
+ * pi-web-ui 的 pi 扩展 —— 提供命令行集成。
+ *
+ * 能力：
+ *   /webui                      启动本机 pi-web-ui 服务器，打开浏览器访问
+ *   /webui --port 9000          指定端口启动
+ *   /webui --no-browser         启动但不开浏览器
+ *   /webui stop                 停止已启动的服务器
+ *   /webui status               查看运行状态 / URL
+ *
+ * 实现说明：
+ *   - 不依赖全局 bin（pi install 后 pi-web-ui 命令不一定在 PATH），直接用
+ *     node 调包内 dist/server/index.js，通过环境变量 PORT / PI_WEB_CWD /
+ *     PI_WEB_DATA_DIR 控制。
+ *   - 工作目录默认用当前 pi 会话的 ctx.cwd；可用 --cwd / path 覆盖。
+ *   - 服务器作为子进程后台运行，/webui 不阻塞 pi。
+ *   - 每个 pi 会话管理一个子进程；session_shutdown 时清理，避免孤儿进程。
+ */
+
+import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import net from "node:net";
+import type { ExtensionAPI, ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
+
+// 本文件位于 <pkg>/extensions/webui.ts → 包根在上一级
+const PKG_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), "..");
+const SERVER_ENTRY = join(PKG_ROOT, "dist", "server", "index.js");
+const NODE = process.execPath;
+
+/** 每个会话的服务器子进程 + 元数据 */
+interface RunningServer {
+	proc: ReturnType<typeof spawn>;
+	port: number;
+	cwd: string;
+	url: string;
+}
+
+// 会话 → 运行实例（模块级 Map；每会话一个会话对象，无需清理全局）
+const running = new Map<string, RunningServer>();
+
+/** 找一个空闲端口 */
+function findFreePort(from = 8787): Promise<number> {
+	return new Promise((resolve_, reject) => {
+		const srv = net.createServer();
+		srv.listen(from, () => {
+			const port = (srv.address() as net.AddressInfo).port;
+			srv.close(() => resolve_(port));
+		});
+		srv.on("error", () => {
+			// 端口被占则顺延
+			findFreePort(from + 1).then(resolve_, reject);
+		});
+	});
+}
+
+/** 解析 --key value / --flag 参数 */
+function parseArgs(args: string): { port?: number; cwd?: string; noBrowser: boolean } {
+	const out: { port?: number; cwd?: string; noBrowser: boolean } = { noBrowser: false };
+	const toks = args.split(/\s+/).filter(Boolean);
+	for (let i = 0; i < toks.length; i++) {
+		const t = toks[i];
+		if ((t === "--port" || t === "-p") && toks[i + 1]) {
+			const n = Number(toks[++i]);
+			if (Number.isInteger(n) && n > 0 && n < 65536) out.port = n;
+		} else if (t === "--cwd" && toks[i + 1]) {
+			out.cwd = resolve(toks[++i]);
+		} else if (t === "--no-browser") {
+			out.noBrowser = true;
+		}
+	}
+	return out;
+}
+
+/** 打开浏览器 */
+async function openBrowser(url: string): Promise<void> {
+	const { platform } = process;
+	const [cmd, ...rest] =
+		platform === "darwin" ? ["open", url] : platform === "win32" ? ["cmd", "/c", "start", "", url] : ["xdg-open", url];
+	// 无界面环境缺少 xdg-open 等打开器时，ENOENT 以异步 'error' 事件触发，
+	// try/catch 拦不住会崩掉整个进程 —— 必须挂 error 监听。
+	spawn(cmd, rest, { stdio: "ignore", detached: true })
+		.on("error", (err) => {
+			if ((err as NodeJS.ErrnoException)?.code === "ENOENT") {
+				console.warn(
+					`[webui] 未找到浏览器打开器 (${(err as NodeJS.ErrnoException).path || "command not found"})，请用 --no-browser 关闭自动打开`,
+				);
+			} else {
+				console.warn("[webui] 打开浏览器失败:", err.message);
+			}
+		})
+		.unref();
+}
+
+export default function (pi: ExtensionAPI): void {
+	pi.registerCommand("webui", {
+		description: "启动本机 pi-web-ui Web 界面（/webui [--port N] [--cwd PATH] [--no-browser] | stop | status）",
+		handler: async (args: string, ctx: ExtensionCommandContext) => {
+			const sid = ctx.sessionManager.getSessionId();
+			const opts = parseArgs(args);
+			const action = (args.split(/\s+/)[0] || "start").toLowerCase();
+
+			// 停止
+			if (action === "stop" || action === "kill") {
+				const inst = running.get(sid);
+				if (!inst) {
+					ctx.ui.notify("没有正在运行的本机 pi-web-ui 服务器", "info");
+					return;
+				}
+				inst.proc.kill("SIGTERM");
+				running.delete(sid);
+				ctx.ui.notify(`已停止 pi-web-ui (${inst.url})`, "info");
+				return;
+			}
+
+			// 状态
+			if (action === "status") {
+				const inst = running.get(sid);
+				if (!inst) {
+					ctx.ui.notify("本机 pi-web-ui 未运行", "info");
+					return;
+				}
+				const alive = inst.proc.exitCode === null;
+				ctx.ui.notify(
+					alive
+						? `pi-web-ui 运行中 → ${inst.url}\n端口 ${inst.port} · cwd ${inst.cwd}`
+						: `已退出(exit=${inst.proc.exitCode})`,
+					alive ? "info" : "warning",
+				);
+				return;
+			}
+
+			// 默认 start
+			if (action !== "start" && action !== "run") {
+				ctx.ui.notify(`未知动作 ${action}（可用 start|stop|status）`, "warning");
+				return;
+			}
+
+			// 已运行则提示
+			const existing = running.get(sid);
+			if (existing && existing.proc.exitCode === null) {
+				ctx.ui.notify(`pi-web-ui 已在运行 → ${existing.url}`, "info");
+				return;
+			}
+
+			// 检查是否已构建
+			if (!existsSync(SERVER_ENTRY)) {
+				ctx.ui.notify(
+					"缺少 dist/ 产物（当前安装未包含已构建前端）。请运行 `npm run build` 后重试，或用 pi-web-ui 官方 npm 包。",
+					"warning",
+				);
+				return;
+			}
+
+			const port = opts.port ?? (await findFreePort());
+			const cwd = opts.cwd ?? ctx.cwd;
+			const url = `http://localhost:${port}`;
+
+			const env = {
+				...process.env,
+				PORT: String(port),
+				PI_WEB_CWD: cwd,
+				...(process.env.PI_WEB_DATA_DIR ? {} : { PI_WEB_DATA_DIR: join(cwd, ".pi-web") }),
+			};
+			const proc = spawn(NODE, [SERVER_ENTRY], { cwd, env, stdio: "ignore", detached: true });
+			proc.unref();
+			running.set(sid, { proc, port, cwd, url });
+
+			ctx.ui.notify(`pi-web-ui 启动中 → ${url}\n端口 ${port} · cwd ${cwd}\n(几秒后可用，/webui status 查看)`);
+
+			if (!opts.noBrowser) await openBrowser(url);
+
+			// 进程退出时清理
+			proc.on("exit", () => {
+				if (running.get(sid)?.proc === proc) running.delete(sid);
+			});
+		},
+	});
+
+	// 会话结束清理子进程，避免孤儿
+	pi.on("session_shutdown", async (_event, ctx) => {
+		const sid = ctx.sessionManager.getSessionId();
+		const inst = running.get(sid);
+		if (inst && inst.proc.exitCode === null) {
+			inst.proc.kill("SIGTERM");
+			running.delete(sid);
+		}
+	});
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pi-web-ui",
-	  "version": "0.68.0",
+	"version": "0.68.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",
 	"author": {
@@ -51,11 +51,12 @@
 		"dev": "concurrently -k -n server,web -c blue,green \"npm:dev:server\" \"npm:dev:web\"",
 		"dev:server": "cross-env PI_WEB_PORT=8788 PI_WEB_ALLOW_ORIGINS=http://localhost:5173,http://127.0.0.1:5173 node --watch --import tsx server/index.ts",
 		"dev:web": "vite --config web/vite.config.ts",
-		"build": "npm run build:web && npm run build:server && npm run build:dsh-runtime && npm run build:mermaid-vendor",
+		"build": "npm run build:web && npm run build:server && npm run build:dsh-runtime && npm run build:mermaid-vendor && npm run build:runtrace-vendor",
 		"build:web": "vite build --config web/vite.config.ts",
 		"build:server": "tsc -p tsconfig.server.json",
 		"build:dsh-runtime": "node scripts/copy-dsh-runtime.mjs",
 		"build:mermaid-vendor": "node scripts/build-mermaid-vendor.mjs",
+		"build:runtrace-vendor": "node scripts/build-runtrace-vendor.mjs",
 		"typecheck": "tsc -p tsconfig.server.json --noEmit && tsc -p web/tsconfig.json --noEmit && tsc -p tsconfig.tests.json --noEmit",
 		"test": "vitest run",
 		"test:unit": "vitest run",
@@ -104,6 +105,7 @@
 		"prettier": "^3.9.6",
 		"tsx": "^4.19.2",
 		"typescript": "^5.7.2",
+		"vis-timeline": "^8.5.4",
 		"vite": "^6.0.3",
 		"vitest": "^4.1.11"
 	},

package/plugins/catalog.json

@@ -34,5 +34,14 @@
 		"descriptionEn": "Renders ```mermaid fences in messages to SVG diagrams (fenced-code renderer plugin, offline-first local engine).",
 		"source": "xing-shuyin/pi-web-ui/plugins/mermaid",
 		"homepage": "https://github.com/xing-shuyin/pi-web-ui/tree/main/plugins/mermaid"
+	},
+	{
+		"id": "run-trace",
+		"name": "run-trace",
+		"icon": "🧭",
+		"description": "运行轨迹：任务 → 思考 → 工具 → 文件改动 → 结果的时间线聚合视图，支持回放与节点详情。",
+		"descriptionEn": "Run trajectory: task → thinking → tools → file changes → result timeline with replay and node details.",
+		"source": "xing-shuyin/pi-web-ui/plugins/run-trace",
+		"homepage": "https://github.com/xing-shuyin/pi-web-ui/tree/main/plugins/run-trace"
 	}
 ]

package/web/dist/assets/{TerminalPanel-CTY_LN4U.js → TerminalPanel-IJF_fssI.js}

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