pi-web-ui 0.20.0 → 0.21.0

package/dist/server/agent-service.js

@@ -12,7 +12,7 @@
  */
 import { spawn } from "node:child_process";
 import { existsSync, readFileSync, statSync, writeFileSync, mkdirSync, watch, } from "node:fs";
-import { dirname, join, relative, resolve, sep } from "node:path";
+import { basename, dirname, join, relative, resolve, sep } from "node:path";
 import { fileURLToPath } from "node:url";
 import { createAgentSessionFromServices, createAgentSessionRuntime, createAgentSessionServices, createBashTool, createLocalBashOperations, defineTool, getAgentDir, ModelRuntime, SessionManager, } from "@earendil-works/pi-coding-agent";
 import { Type } from "typebox";
@@ -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
@@ -750,6 +750,15 @@ async function readDirForUI(abs, rel) {
         out.length = MAX;
     return { entries: out, truncated };
 }
+/** Stable identity of an extension for the enable/disable toggle: the npm
+ *  spec for packages (survives version bumps), the resolved entry path
+ *  otherwise. */
+function extensionKey(e) {
+    const src = e.sourceInfo;
+    if (src?.origin === "package" && src.source)
+        return src.source;
+    return src?.path ?? e.path;
+}
 /**
  * Persists which workspace each browser client last used + which workspaces it
  * has opened, so a server restart / page reload restores the same project and
@@ -820,6 +829,40 @@ class ClientStateStore {
         };
         this.save();
     }
+    /** Last-used settings-panel state for a client, or defaults. */
+    getSettings(clientId) {
+        const s = this.load()[clientId];
+        return {
+            promptMode: s?.settings?.promptMode === "replace" ? "replace" : "append",
+            customSystemPrompt: s?.settings?.customSystemPrompt ?? "",
+            disabledSkills: s?.settings?.disabledSkills ?? [],
+            disabledExtensions: s?.settings?.disabledExtensions ?? [],
+        };
+    }
+    /** Persist the client's settings-panel state (partial merge). */
+    saveSettings(clientId, settings) {
+        const all = this.load();
+        const state = (all[clientId] ??= { projects: [] });
+        const cur = state.settings ?? {};
+        state.settings = {
+            promptMode: settings.promptMode ?? cur.promptMode ?? "append",
+            customSystemPrompt: settings.customSystemPrompt ?? cur.customSystemPrompt ?? "",
+            disabledSkills: settings.disabledSkills ?? cur.disabledSkills ?? [],
+            disabledExtensions: settings.disabledExtensions ?? cur.disabledExtensions ?? [],
+        };
+        this.save();
+    }
+    /** Named settings presets for a client (empty if never saved). */
+    getPresets(clientId) {
+        return this.load()[clientId]?.presets ?? [];
+    }
+    /** Persist the client's named settings presets. */
+    savePresets(clientId, presets) {
+        const all = this.load();
+        const state = (all[clientId] ??= { projects: [] });
+        state.presets = presets;
+        this.save();
+    }
 }
 /** Hard cap on how long ONE tool call may run before the watchdog aborts the
  *  session. The SDK bash tool has NO default timeout, so a command that never
@@ -914,6 +957,20 @@ export class ClientSession {
     /** Guard: the goal wizard and the review loop are mutually exclusive — a
      *  wizard in flight stops review triggers (and vice versa). */
     goalWizardRunning = false;
+    /** Settings-panel state (system prompt + disabled skills/extensions). The
+     *  resource-loader overrides in makeRuntimeFactory() read this at every
+     *  reload(), so session.reload() applies changes to the running runtime. */
+    settings;
+    /** Named settings presets (saved combos the user can re-apply). */
+    presets = [];
+    /** Settings changed while the run was streaming — the runtime reload is
+     *  deferred to the next agent_end so an in-flight run is never torn down. */
+    pendingSettingsReload = false;
+    /** Full (incl. disabled) skill/extension lists seen so far — disabled
+     *  entries disappear from the loader after reload, so this cache keeps them
+     *  visible (and re-enableable) in the settings panel. */
+    knownSkills = new Map();
+    knownExtensions = new Map();
     /** Aborts the currently-running goal wizard (user clicked ✗ / timed out). Drives
      *  the in-flight goal_ask dialog to resolve as cancelled and (via the run
      *  signal) stops the wizard session's agent run. Recreated per wizard. */
@@ -993,6 +1050,8 @@ export class ClientSession {
         this.cwd = cwd;
         this.agentDir = agentDir;
         this.stateStore = stateStore;
+        this.settings = stateStore.getSettings(clientId);
+        this.presets = stateStore.getPresets(clientId);
     }
     static async create(clientId, cwd, stateStore) {
         const agentDir = process.env.PI_CODING_AGENT_DIR ?? getAgentDir();
@@ -1040,16 +1099,41 @@ export class ClientSession {
             const services = await createAgentSessionServices({
                 cwd: effectiveCwd,
                 modelRuntime: this.sharedModelRuntime,
-                ...(process.platform === "win32"
-                    ? {
-                        // Windows 专属 persona：bash 工具跑 Git Bash 且无默认超时、终端是
-                        // 交互式 TTY——注入约束避免 heredoc/交互/长驻命令挂死整个会话；
-                        // GBK 老中文文件让模型改用终端按正确编码读（iconv/chcp/Get-Content）。
-                        resourceLoaderOptions: {
-                            systemPromptOverride: (base) => base ? `${base}\n\n${WINDOWS_PERSONA}` : WINDOWS_PERSONA,
-                        },
-                    }
-                    : {}),
+                // 设置面板钩子（官方 SDK 的 resourceLoader overrides）：三个 override
+                // 在每次 resourceLoader.reload() 时重放，且读取 this.settings 的当前
+                // 值——因此 session.reload() 即可让系统提示词 / 技能 / 插件开关生效，
+                // 新对话（新 runtime）也会自动带上当前设置。
+                resourceLoaderOptions: {
+                    // 系统提示词：replace 模式整体替换；append 模式追加到提示词末尾。
+                    systemPromptOverride: (base) => this.settings.promptMode === "replace" &&
+                        this.settings.customSystemPrompt.trim()
+                        ? this.settings.customSystemPrompt
+                        : base,
+                    appendSystemPromptOverride: (base) => {
+                        const out = [...base];
+                        const custom = this.settings.customSystemPrompt.trim();
+                        if (this.settings.promptMode === "append" && custom) {
+                            out.push(custom);
+                        }
+                        if (process.platform === "win32") {
+                            // Windows 专属 persona：bash 工具跑 Git Bash 且无默认超时、终端
+                            // 是交互式 TTY——注入约束避免 heredoc/交互/长驻命令挂死整个会话；
+                            // GBK 老中文文件让模型改用终端按正确编码读（iconv/chcp/Get-Content）。
+                            out.push(WINDOWS_PERSONA);
+                        }
+                        return out;
+                    },
+                    // 技能开关：禁用的技能从系统提示词和 /skill: 目录中剔除。
+                    skillsOverride: (res) => ({
+                        ...res,
+                        skills: res.skills.filter((s) => !this.settings.disabledSkills.includes(s.name)),
+                    }),
+                    // 插件开关：禁用的扩展整个卸载（工具 / 命令随之消失）。
+                    extensionsOverride: (res) => ({
+                        ...res,
+                        extensions: res.extensions.filter((e) => !this.settings.disabledExtensions.includes(extensionKey(e))),
+                    }),
+                },
             });
             return {
                 ...(await createAgentSessionFromServices({
@@ -1117,6 +1201,9 @@ export class ClientSession {
         // Reconnect: push the remembered goal prefs (model choice, rounds cap,
         // locked) so the goal bar restores them on reload — "全局记忆".
         this.emitGoalStatus();
+        // Reconnect: push the settings panel state (prompt text/mode, skill &
+        // extension toggles, saved presets).
+        this.pushSettings();
     }
     detachSink(send) {
         this.sinks.delete(send);
@@ -1327,6 +1414,13 @@ export class ClientSession {
                     !this.disposed) {
                     void this.runGoalReview(conv);
                 }
+                // Deferred settings reload: settings (system prompt / skills /
+                // extensions) changed while the run was streaming — applying now
+                // would have torn down the in-flight run.
+                if (this.pendingSettingsReload && !this.disposed) {
+                    this.pendingSettingsReload = false;
+                    void this.applySettingsReload();
+                }
                 break;
             }
             case "entry_appended":
@@ -1565,6 +1659,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 +2134,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 +2289,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;
@@ -2256,6 +2369,174 @@ export class ClientSession {
         this.emit({ type: "slash_commands", commands });
     }
     // ---------------------------------------------------------------------------
+    // Settings (system prompt / skills / extensions / presets)
+    // ---------------------------------------------------------------------------
+    /** Push the full settings state (current settings + loaded skills/extensions
+     *  with enabled flags + saved presets). Pushed on attach and after every
+     *  settings change. */
+    pushSettings() {
+        const disabledSkills = new Set(this.settings.disabledSkills);
+        const disabledExts = new Set(this.settings.disabledExtensions);
+        try {
+            // Refresh the cache with the CURRENTLY loaded set (post-filter).
+            for (const s of this.session.resourceLoader.getSkills().skills) {
+                this.knownSkills.set(s.name, {
+                    name: s.name,
+                    description: s.description,
+                    enabled: true,
+                });
+            }
+            for (const e of this.session.resourceLoader.getExtensions().extensions) {
+                const id = extensionKey(e);
+                const p = e.sourceInfo?.path ?? e.path;
+                this.knownExtensions.set(id, {
+                    id,
+                    name: e.sourceInfo?.origin === "package" && e.sourceInfo.source
+                        ? e.sourceInfo.source
+                        : basename(p),
+                    path: p,
+                    enabled: true,
+                });
+            }
+        }
+        catch {
+            // Session not ready yet — keep whatever we already know.
+        }
+        // Disabled entries are filtered out of the loader — keep them in the
+        // panel (with the last-known description) so they can be re-enabled.
+        for (const name of this.settings.disabledSkills) {
+            if (!this.knownSkills.has(name)) {
+                this.knownSkills.set(name, { name, description: "", enabled: false });
+            }
+        }
+        for (const id of this.settings.disabledExtensions) {
+            if (!this.knownExtensions.has(id)) {
+                this.knownExtensions.set(id, {
+                    id,
+                    name: id.startsWith("npm:") ? id : basename(id),
+                    path: "",
+                    enabled: false,
+                });
+            }
+        }
+        const skills = [...this.knownSkills.values()]
+            .map((s) => ({ ...s, enabled: !disabledSkills.has(s.name) }))
+            .sort((a, b) => a.name.localeCompare(b.name));
+        const extensions = [...this.knownExtensions.values()]
+            .map((e) => ({ ...e, enabled: !disabledExts.has(e.id) }))
+            .sort((a, b) => a.name.localeCompare(b.name));
+        this.emit({
+            type: "settings_state",
+            settings: {
+                promptMode: this.settings.promptMode,
+                customSystemPrompt: this.settings.customSystemPrompt,
+                disabledSkills: [...this.settings.disabledSkills],
+                disabledExtensions: [...this.settings.disabledExtensions],
+                skills,
+                extensions,
+                presets: this.presets.map((p) => ({ ...p })),
+            },
+        });
+    }
+    /** Persist + apply a partial settings update (prompt text/mode, toggles). */
+    async setSettings(partial) {
+        if (partial.promptMode !== undefined)
+            this.settings.promptMode = partial.promptMode;
+        if (partial.customSystemPrompt !== undefined) {
+            this.settings.customSystemPrompt = partial.customSystemPrompt;
+        }
+        if (partial.disabledSkills !== undefined) {
+            this.settings.disabledSkills = partial.disabledSkills;
+        }
+        if (partial.disabledExtensions !== undefined) {
+            this.settings.disabledExtensions = partial.disabledExtensions;
+        }
+        this.stateStore.saveSettings(this.clientId, this.settings);
+        this.pushSettings();
+        await this.applyRuntimeSettings();
+    }
+    /** Save the CURRENT settings as a named preset (overwrites if exists). */
+    async savePreset(name) {
+        const n = name.trim();
+        if (!n) {
+            this.emit({ type: "notice", level: "error", text: "预设名称不能为空" });
+            return;
+        }
+        const preset = {
+            name: n,
+            promptMode: this.settings.promptMode,
+            customSystemPrompt: this.settings.customSystemPrompt,
+            disabledSkills: [...this.settings.disabledSkills],
+            disabledExtensions: [...this.settings.disabledExtensions],
+        };
+        const existing = this.presets.findIndex((p) => p.name === n);
+        if (existing >= 0)
+            this.presets[existing] = preset;
+        else
+            this.presets.push(preset);
+        this.stateStore.savePresets(this.clientId, this.presets);
+        this.pushSettings();
+    }
+    /** Replace the current settings with the named preset and apply it. */
+    async applyPreset(name) {
+        const p = this.presets.find((x) => x.name === name);
+        if (!p) {
+            this.emit({ type: "notice", level: "error", text: `预设不存在：${name}` });
+            return;
+        }
+        this.settings = {
+            promptMode: p.promptMode,
+            customSystemPrompt: p.customSystemPrompt,
+            disabledSkills: [...p.disabledSkills],
+            disabledExtensions: [...p.disabledExtensions],
+        };
+        this.stateStore.saveSettings(this.clientId, this.settings);
+        this.pushSettings();
+        await this.applyRuntimeSettings();
+    }
+    /** Remove a named preset. */
+    async deletePreset(name) {
+        this.presets = this.presets.filter((p) => p.name !== name);
+        this.stateStore.savePresets(this.clientId, this.presets);
+        this.pushSettings();
+    }
+    /**
+     * Make settings changes effective in the running runtime. The resource-loader
+     * overrides read this.settings at call time, so a reload re-applies them.
+     * Reloading mid-stream would tear down the in-flight run — defer instead.
+     */
+    async applyRuntimeSettings() {
+        if (this.disposed)
+            return;
+        if (this.session.isStreaming) {
+            this.pendingSettingsReload = true;
+            this.emit({
+                type: "notice",
+                level: "info",
+                text: "当前回复进行中，设置将在回复结束后自动应用",
+            });
+            return;
+        }
+        await this.applySettingsReload();
+    }
+    /** session.reload() + refresh the slash-command catalog + push state. */
+    async applySettingsReload() {
+        try {
+            await this.session.reload();
+            await this.pushSlashCommands();
+            this.pushSettings();
+            this.flushSnapshot();
+            this.emit({ type: "notice", level: "info", text: "设置已应用" });
+        }
+        catch (err) {
+            this.emit({
+                type: "notice",
+                level: "error",
+                text: `设置应用失败：${err.message}`,
+            });
+        }
+    }
+    // ---------------------------------------------------------------------------
     // Commands
     // ---------------------------------------------------------------------------
     async prompt(text, attachments) {
@@ -4349,6 +4630,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 +4677,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;
@@ -343,6 +363,26 @@ wss.on("connection", (ws) => {
                     locked: msg.locked,
                 });
                 break;
+            case "get_settings":
+                cs.pushSettings();
+                break;
+            case "set_settings":
+                void cs.setSettings({
+                    promptMode: msg.promptMode,
+                    customSystemPrompt: msg.customSystemPrompt,
+                    disabledSkills: msg.disabledSkills,
+                    disabledExtensions: msg.disabledExtensions,
+                });
+                break;
+            case "save_preset":
+                void cs.savePreset(msg.name);
+                break;
+            case "apply_preset":
+                void cs.applyPreset(msg.name);
+                break;
+            case "delete_preset":
+                void cs.deletePreset(msg.name);
+                break;
             default:
                 break;
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-web-ui",
-  "version": "0.20.0",
+  "version": "0.21.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",
   "type": "module",