pi-web-ui 0.65.0 → 0.67.0

package/dist/server/prompt-composer.js

@@ -0,0 +1,180 @@
+/**
+ * 主会话系统提示词 = 自由组合模板（compose）。
+ *
+ * 模板里的 `{{token}}` 在每次 agent run 前展开为对应「来源」的提示词块；每个
+ * token 可单独覆盖——overrides 里有内容就用覆盖文本，否则用该来源的自动内容。
+ * 这样既可自由排序/增删/穿插自己的话，也可只替换某一个来源而不影响其他自动段
+ * （工具列表、项目上下文等仍由 SDK 用最新数据重新生成）。
+ *
+ * token 列表及默认顺序镜像 buildSystemPrompt（SDK dist/core/system-prompt.js）
+ * 默认分支的拼装顺序：
+ *     soul → tools → guidelines → pi_docs → append → persona → terminal →
+ *     markers → context → skills → cwd
+ *
+ * （bash 管道限制不需要独立段：它属于 bash 工具的用法说明，已写进工具自身
+ *  description，随工具走；compose 里不再单设 {{pipe}} 来源。）
+ *
+ * 本模块是纯函数（不 import SDK / node），浏览器端可复用（SettingsModal 需要
+ * DEFAULT_PROMPT_TEMPLATE 与 token 元数据）。
+ */
+/** 全部来源 token。默认模板顺序即此数组顺序。 */
+export const PROMPT_TOKENS = [
+    "soul", // 内置灵魂提示词（persona；有 SYSTEM.md 时其内容）
+    "tools", // Available tools 工具列表（含各工具 snippet + "In addition…" 句）
+    "guidelines", // Guidelines 行为准则段
+    "pi_docs", // Pi documentation 文档指引（指向 pi 包路径）
+    "append", // 追加段（APPEND_SYSTEM.md 内容；覆盖 = 自定义追加文字）
+    "persona", // Windows persona（仅 win32）
+    "terminal", // 终端工具使用引导（「终端工具」开关开时）
+    "markers", // 内置标记工具引导（markers 开启时）
+    "context", // 项目上下文 <project_context>（AGENTS.md 等）
+    "skills", // 技能段 <available_skills>
+    "cwd", // Current working directory 行
+];
+/** 默认模板：全部 token 按自然顺序以空行连接 —— 无覆盖、不改动时渲染结果 ≈
+ *  SDK 默认拼装的完整提示词。 */
+export const DEFAULT_PROMPT_TEMPLATE = PROMPT_TOKENS.map((t) => `{{${t}}}`).join("\n\n");
+const TOKEN_RE = /\{\{\s*([A-Za-z_][A-Za-z0-9_]*)\s*\}\}/g;
+export function isKnownToken(name) {
+    return PROMPT_TOKENS.includes(name);
+}
+/** 模板里出现的全部 token（含未知名，供 UI 提示）。 */
+export function collectTemplateTokens(template) {
+    const out = [];
+    for (const m of template.matchAll(TOKEN_RE)) {
+        if (!out.includes(m[1]))
+            out.push(m[1]);
+    }
+    return out;
+}
+/** 空模板 = 默认模板。 */
+export function effectiveTemplate(template) {
+    const t = (template ?? "").trim();
+    return t || DEFAULT_PROMPT_TEMPLATE;
+}
+/** 该来源是否有「自动内容」之外的覆盖。 */
+export function overrideOf(overrides, token) {
+    const v = overrides?.[token];
+    return v && v.trim() ? v : "";
+}
+/** 内置默认灵魂段落（buildSystemPrompt 默认分支的开头，与 SDK 同步维护）。 */
+export const BUILTIN_SOUL = "You are an expert coding assistant operating inside pi, a coding agent harness. You help users by reading files, executing commands, editing code, and writing new files.";
+/** Pi documentation 段模板 —— 与 SDK buildSystemPrompt 默认分支一致（路径由调用方注入）。 */
+export function buildPiDocsText(readme, docs, examples) {
+    return [
+        "Pi documentation (read only when the user asks about pi itself, its SDK, extensions, themes, skills, or TUI):",
+        `- Main documentation: ${readme}`,
+        `- Additional docs: ${docs}`,
+        `- Examples: ${examples} (extensions, custom tools, SDK)`,
+        "- When reading pi docs or examples, resolve docs/... under Additional docs and examples/... under Examples, not the current working directory",
+        "- When asked about: extensions (docs/extensions.md, examples/extensions/), themes (docs/themes.md), skills (docs/skills.md), prompt templates (docs/prompt-templates.md), TUI components (docs/tui.md), keybindings (docs/keybindings.md), SDK integrations (docs/sdk.md), custom providers (docs/custom-provider.md), adding models (docs/models.md), pi packages (docs/packages.md), environment variables (docs/environment-variables.md)",
+        "- When working on pi topics, read the docs and examples, and follow .md cross-references before implementing",
+        "- Always read pi .md files completely and follow links to related docs (e.g., tui.md for TUI API details)",
+    ].join("\n");
+}
+/** Guidelines 段：文件探索引导 + 工具 promptGuidelines（去重）+ 固定两行。
+ *  与 buildSystemPrompt 默认分支的聚合规则一致。 */
+function buildGuidelinesText(inputs) {
+    const selected = new Set(inputs.selectedTools);
+    const lines = [];
+    const add = (g) => {
+        const t = g.trim();
+        if (t && !lines.includes(t))
+            lines.push(t);
+    };
+    const has = (n) => selected.has(n);
+    if ((has("bash") || has("powershell")) && !has("grep") && !has("find") && !has("ls")) {
+        add(has("bash") && has("powershell")
+            ? "Use bash or PowerShell for file operations like listing, searching, and finding files"
+            : "Use bash for file operations like ls, rg, find");
+    }
+    for (const g of inputs.toolGuidelines)
+        add(g);
+    add("Be concise in your responses");
+    add("Show file paths clearly when working with files");
+    return `Guidelines:\n${lines.map((l) => `- ${l}`).join("\n")}`;
+}
+function escapeXml(s) {
+    return s
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;")
+        .replace(/'/g, "&apos;");
+}
+/** 技能段文本（不含前导空行）。与 SDK formatSkillsForPrompt 一致。 */
+export function buildSkillsText(skills) {
+    const visible = skills.filter((s) => !s.disableModelInvocation);
+    if (visible.length === 0)
+        return "";
+    const lines = [
+        "The following skills provide specialized instructions for specific tasks.",
+        "Use the read tool to load a skill's file when the task matches its description.",
+        "When a skill file references a relative path, resolve it against the skill directory (parent of SKILL.md / dirname of the path) and use that absolute path in tool commands.",
+        "",
+        "<available_skills>",
+    ];
+    for (const skill of visible) {
+        lines.push("  <skill>");
+        lines.push(`    <name>${escapeXml(skill.name)}</name>`);
+        lines.push(`    <description>${escapeXml(skill.description)}</description>`);
+        lines.push(`    <location>${escapeXml(skill.filePath)}</location>`);
+        lines.push("  </skill>");
+    }
+    lines.push("</available_skills>");
+    return lines.join("\n");
+}
+/** 项目上下文块（不含前导空行）。 */
+function buildContextText(files) {
+    if (files.length === 0)
+        return "";
+    return [
+        "<project_context>",
+        "",
+        "Project-specific instructions and guidelines:",
+        "",
+        ...files.map((f) => `<project_instructions path="${f.path}">\n${f.content}\n</project_instructions>`),
+        "",
+        "</project_context>",
+    ].join("\n");
+}
+/** 工具列表块：工具列表 + "In addition…" 句。 */
+function buildToolsText(inputs) {
+    const visible = inputs.selectedTools.filter((n) => !!inputs.toolSnippets[n]);
+    const toolsList = visible.length > 0 ? visible.map((n) => `- ${n}: ${inputs.toolSnippets[n]}`).join("\n") : "(none)";
+    return [
+        `Available tools:\n${toolsList}`,
+        "In addition to the tools above, you may have access to other custom tools depending on the project.",
+    ].join("\n\n");
+}
+/** 计算每个 token 的自动内容（无覆盖时的展开值）。 */
+export function resolveSectionTexts(inputs) {
+    const cwd = inputs.cwd.replace(/\\/g, "/");
+    return {
+        soul: inputs.systemPromptFile?.trim() ? inputs.systemPromptFile : inputs.builtinSoul,
+        tools: buildToolsText(inputs),
+        guidelines: buildGuidelinesText(inputs),
+        pi_docs: buildPiDocsText(inputs.piReadme, inputs.piDocs, inputs.piExamples),
+        append: inputs.appendFiles.join("\n\n"),
+        persona: inputs.windowsPersona,
+        terminal: inputs.terminalGuidance,
+        markers: inputs.markersGuidance,
+        context: buildContextText(inputs.contextFiles),
+        skills: buildSkillsText(inputs.skills),
+        cwd: `Current working directory: ${cwd}`,
+    };
+}
+/** 渲染模板：{{token}} → 覆盖文本（有）或自动内容（无/空覆盖）；未知名 token
+ *  保留原文；没有 content 的 token 展开为空串。 */
+export function renderPromptTemplate(template, texts, overrides) {
+    return effectiveTemplate(template).replace(TOKEN_RE, (full, name) => {
+        const ov = overrideOf(overrides, name);
+        if (ov)
+            return ov;
+        return Object.prototype.hasOwnProperty.call(texts, name) ? (texts[name] ?? "") : full;
+    });
+}
+/** 用默认模板渲染（不覆盖）——等价于「恢复默认」后的成品。 */
+export function renderDefaultPrompt(texts) {
+    return renderPromptTemplate(DEFAULT_PROMPT_TEMPLATE, texts, undefined);
+}

package/dist/server/settings-service.js

@@ -180,14 +180,19 @@ export class SettingsService {
         const extensions = [...this.knownExtensions.values()]
             .map((e) => ({ ...e, enabled: !disabledExts.has(e.id) }))
             .sort((a, b) => a.name.localeCompare(b.name));
+        // 当前会话提示词快照：完整生效文本 + 各来源默认（自动）内容（只读预览）。
+        const promptSnap = this.host.promptSnapshot();
         this.host.emit({
             type: "settings_state",
             settings: {
                 promptMode: this.settings.promptMode,
                 customSystemPrompt: this.settings.customSystemPrompt,
+                promptTemplate: this.settings.promptTemplate ?? "",
+                promptOverrides: { ...this.settings.promptOverrides },
                 terminalToolsEnabled: this.settings.terminalToolsEnabled,
                 terminalBash: this.settings.terminalBash,
                 terminalBashIdleMs: this.settings.terminalBashIdleMs,
+                editSoftEnabled: this.settings.editSoftEnabled,
                 thinkingWrap: this.settings.thinkingWrap,
                 toolsWrap: this.settings.toolsWrap,
                 visionBridgeEnabled: this.settings.visionBridgeEnabled,
@@ -197,11 +202,10 @@ export class SettingsService {
                 reviewPrompt: this.settings.reviewPrompt,
                 reviewDisabledSkills: [...this.settings.reviewDisabledSkills],
                 disabledPlugins: [...(this.settings.disabledPlugins ?? [])],
-                // The built-in prompts, so the replace-mode editors can prefill the
-                // text they would otherwise replace (empty until the resource-loader
-                // has run once for the system prompt).
-                defaultSystemPrompt: this.host.effectiveDefaultSystemPrompt(),
-                effectiveSystemPrompt: this.host.effectiveSystemPrompt(),
+                // The composed system prompt actually in effect (read-only view).
+                effectiveSystemPrompt: promptSnap.full,
+                // 每个来源未覆盖时的默认（自动）内容（「各来源」行预览用）。
+                promptSourceDefaults: promptSnap.texts,
                 visionBridgeDefaultPrompt: SYSTEM_PROMPT,
                 visionModels: this.collectVisionModels(),
                 disabledSkills: [...this.settings.disabledSkills],
@@ -262,18 +266,36 @@ export class SettingsService {
             return [];
         }
     }
-    /** Persist + apply a partial settings update (prompt text/mode, toggles). */
+    /** Persist + apply a partial settings update (compose template / per-source
+     *  overrides, skill/extension toggles). */
     async set(partial) {
         const needsReload = partial.promptMode !== undefined ||
             partial.customSystemPrompt !== undefined ||
+            partial.promptTemplate !== undefined ||
+            partial.promptOverrides !== undefined ||
             partial.disabledSkills !== undefined ||
             partial.disabledExtensions !== undefined ||
-            partial.terminalToolsEnabled !== undefined;
+            partial.terminalToolsEnabled !== undefined ||
+            partial.editSoftEnabled !== undefined;
         if (partial.promptMode !== undefined)
             this.settings.promptMode = partial.promptMode;
         if (partial.customSystemPrompt !== undefined) {
             this.settings.customSystemPrompt = partial.customSystemPrompt;
         }
+        if (partial.promptTemplate !== undefined) {
+            this.settings.promptTemplate = partial.promptTemplate;
+        }
+        if (partial.promptOverrides !== undefined) {
+            // 只合并给出的 key；空串 = 清除该来源覆盖。
+            const next = { ...this.settings.promptOverrides };
+            for (const [k, v] of Object.entries(partial.promptOverrides)) {
+                if (v && v.trim())
+                    next[k] = v;
+                else
+                    delete next[k];
+            }
+            this.settings.promptOverrides = next;
+        }
         if (partial.disabledSkills !== undefined) {
             this.settings.disabledSkills = partial.disabledSkills;
         }
@@ -293,6 +315,9 @@ export class SettingsService {
         if (partial.terminalBashIdleMs !== undefined) {
             this.settings.terminalBashIdleMs = Math.max(0, Math.floor(partial.terminalBashIdleMs) || 0);
         }
+        if (partial.editSoftEnabled !== undefined) {
+            this.settings.editSoftEnabled = partial.editSoftEnabled;
+        }
         if (partial.thinkingWrap !== undefined) {
             this.settings.thinkingWrap = partial.thinkingWrap;
         }
@@ -343,11 +368,14 @@ export class SettingsService {
             name: n,
             promptMode: this.settings.promptMode,
             customSystemPrompt: this.settings.customSystemPrompt,
+            promptTemplate: this.settings.promptTemplate ?? "",
+            promptOverrides: { ...this.settings.promptOverrides },
             disabledSkills: [...this.settings.disabledSkills],
             disabledExtensions: [...this.settings.disabledExtensions],
             terminalToolsEnabled: this.settings.terminalToolsEnabled,
             terminalBash: this.settings.terminalBash,
             terminalBashIdleMs: this.settings.terminalBashIdleMs,
+            editSoftEnabled: this.settings.editSoftEnabled,
             reviewPrompt: this.settings.reviewPrompt,
             reviewDisabledSkills: [...this.settings.reviewDisabledSkills],
         };
@@ -374,6 +402,8 @@ export class SettingsService {
         this.settings = {
             promptMode: p.promptMode,
             customSystemPrompt: p.customSystemPrompt,
+            promptTemplate: p.promptTemplate ?? this.settings.promptTemplate ?? "",
+            promptOverrides: { ...(p.promptOverrides ?? this.settings.promptOverrides) },
             disabledSkills: [...p.disabledSkills],
             disabledExtensions: [...p.disabledExtensions],
             // 旧版持久化的预设可能没有该字段——保留当前值。
@@ -381,6 +411,7 @@ export class SettingsService {
             // 终端接管偏好随预设走；旧预设缺字段时保留当前值。
             terminalBash: p.terminalBash ?? this.settings.terminalBash,
             terminalBashIdleMs: p.terminalBashIdleMs ?? this.settings.terminalBashIdleMs,
+            editSoftEnabled: p.editSoftEnabled ?? this.settings.editSoftEnabled,
             reviewPrompt: p.reviewPrompt ?? this.settings.reviewPrompt,
             reviewDisabledSkills: [...(p.reviewDisabledSkills ?? this.settings.reviewDisabledSkills)],
             // 纯 UI 偏好不进预设——保留当前值。

package/dist/server/system-prompt-soul.js

@@ -0,0 +1,41 @@
+/**
+ * 灵魂提示词（persona）替换纯函数。
+ *
+ * pi 的 buildSystemPrompt（SDK dist/core/system-prompt.js）【默认分支】把系统
+ * 提示词拼成：
+ *
+ *     <人物设定/soul>
+ *     \n\nAvailable tools:\n<工具列表>
+ *     \n\nIn addition to the tools above…\n\nGuidelines:\n<指南>
+ *     \n\nPi documentation (…):\n<文档路径提示>
+ *     [追加段] [<project_context>] [技能段] \nCurrent working directory: <cwd>
+ *
+ * 「灵魂提示词」= 开头的人物设定段落（内置模板的 "You are an expert coding
+ * assistant operating inside pi…"）。设置面板的「替换」模式只替换这一段落——
+ * 工具列表 / Guidelines / 文档指引 / 项目上下文 / 技能段属于自动拼装段，每次由
+ * SDK 用最新数据重新生成，不进入被替换的内容（见 docs/architecture-system-prompt.md）。
+ *
+ * 这两个纯函数以 "\n\nAvailable tools:" 为边界完成 提取/替换：该边界只在默认
+ * 分支出现（存在 SYSTEM.md / 自定义 base 时走 customPrompt 分支、没有工具列表），
+ * 因此天然区分「可做灵魂替换」与「base 已整体替换、无需再动」两种情形。
+ */
+/** 默认模板中分割「灵魂提示词」与自动拼装段的固定标记。 */
+export const SYSTEM_PROMPT_SOUL_BOUNDARY = "\n\nAvailable tools:";
+/** 从（默认分支拼出的）系统提示词里提取内置灵魂提示词段落——replace 模式编辑器
+ *  的种子。找不到边界（customPrompt 分支）返回 undefined，调用方此时退回
+ *  SYSTEM.md 文件内容作种子。 */
+export function extractSystemPromptSoul(composed) {
+    const boundary = composed.indexOf(SYSTEM_PROMPT_SOUL_BOUNDARY);
+    if (boundary === -1)
+        return undefined;
+    return composed.slice(0, boundary);
+}
+/** 把系统提示词开头的灵魂段落替换为自定义内容，其余自动拼装段原样保留。
+ *  找不到边界返回 undefined = 本次替换不适用（调用方原样使用）。 */
+export function swapSystemPromptSoul(composed, soul) {
+    const boundary = composed.indexOf(SYSTEM_PROMPT_SOUL_BOUNDARY);
+    if (boundary === -1)
+        return undefined;
+    const next = soul.trimEnd() + composed.slice(boundary);
+    return next === composed ? undefined : next;
+}

package/dist/server/terminals.js

@@ -1542,11 +1542,11 @@ export const TERMINAL_TOOL_NAMES = [
 /** System-prompt guidance teaching the model WHEN to prefer the terminal tools
  *  over one-shot bash. Without it models almost never pick them — bash returns
  *  complete output in a single call, so it always wins on convenience. */
-export const TERMINAL_TOOLS_GUIDANCE = `Persistent interactive terminal tools are available (terminal_create / terminal_list / terminal_close / terminal_input / terminal_key / terminal_read / terminal_wait). The bash tool stays the DEFAULT for ordinary commands - it runs in a visible terminal and returns the full output (persist=false, one-shot terminal that exits when the command finishes). Switch to the bash tool's persist=true, or to the terminal tools, when:
-- The program is interactive or TUI-based (REPLs like python/node, vim/htop, installers asking y/n, anything waiting on stdin). For these, prefer bash({ persist: true }) which runs it in the persistent 'ai-bash' terminal and returns immediately; then drive it with terminal_input / terminal_key (and terminal_read) on terminalId='ai-bash'.
-- You start a long-running server or watcher and want to keep watching its output (terminal_read with waitMs), send keys to it later (e.g. interrupt via terminal_key with Ctrl+c), or block until a backgrounded command finishes without polling (terminal_wait).
-- The user explicitly asks you to work in the visible terminal panel.
-Use head/tail on bash to trim verbose output instead of piping through head/tail. Liveness watchdog: terminals you touched (create/input/key) are monitored - if one goes silent with no new output while you are working (default 15s), an automatic system reminder is injected into the conversation. Treat it as a prompt to check that terminal (terminal_read), respond to an input prompt (terminal_input / terminal_key), or close it (terminal_close) if it is no longer needed.`;
+export const TERMINAL_TOOLS_GUIDANCE = `Persistent interactive terminal tools are available (terminal_create / terminal_list / terminal_close / terminal_input / terminal_key / terminal_read / terminal_wait). The bash tool stays the DEFAULT for ordinary commands - it runs in a visible terminal and returns the full output (persist=false, one-shot terminal that exits when the command finishes). Switch to the bash tool's persist=true, or to the terminal tools, when:
+- The program is interactive or TUI-based (REPLs like python/node, vim/htop, installers asking y/n, anything waiting on stdin). For these, prefer bash({ persist: true }) which runs it in the persistent 'ai-bash' terminal and returns immediately; then drive it with terminal_input / terminal_key (and terminal_read) on terminalId='ai-bash'.
+- You start a long-running server or watcher and want to keep watching its output (terminal_read with waitMs), send keys to it later (e.g. interrupt via terminal_key with Ctrl+c), or block until a backgrounded command finishes without polling (terminal_wait).
+- The user explicitly asks you to work in the visible terminal panel.
+Liveness watchdog: terminals you touched (create/input/key) are monitored - if one goes silent with no new output while you are working (default 15s), an automatic system reminder is injected into the conversation. Treat it as a prompt to check that terminal (terminal_read), respond to an input prompt (terminal_input / terminal_key), or close it (terminal_close) if it is no longer needed.`;
 /** Build the agent-facing persistent terminal tools for one conversation. */
 export function makePersistentTerminalTools(terminals, cwd) {
     const result = (text, details = {}) => ({ content: [{ type: "text", text }], details });

package/dist/server/update-check.js

@@ -7,7 +7,7 @@
  * (and an injected pi-core probe); ClientSession only wires it to the wire
  * protocol.
  */
-import { spawnSync } from "node:child_process";
+import { spawn } from "node:child_process";
 import { readdirSync, readFileSync } from "node:fs";
 import { join } from "node:path";
 const PI_CORE_PACKAGE = "@earendil-works/pi-coding-agent";
@@ -154,32 +154,71 @@ function readLocalPackage(dir) {
         return null;
     }
 }
-/** Uncached pi core probe (memoized machine-wide below). */
-function rawProbePiCore() {
+/** How long a pi probe result stays hot (mirrors ClientSession.piCliProbe). */
+const PI_PROBE_TTL_MS = 10_000;
+let piCoreProbe = null;
+let piCoreProbePending = false;
+function refreshPiCoreProbe() {
+    if (piCoreProbePending)
+        return;
+    piCoreProbePending = true;
+    let proc;
     try {
-        const res = spawnSync("pi", ["--version"], {
-            timeout: 5000,
-            stdio: "pipe",
+        proc = spawn("pi", ["--version"], {
+            stdio: ["ignore", "pipe", "pipe"],
+            // Windows: `pi` resolves to a pi.cmd shim — spawn can only
+            // exec those through a shell (else ENOENT).
             shell: process.platform === "win32",
         });
-        if (res.error || res.status !== 0)
-            return null;
-        return parsePiVersionOutput(res.stdout?.toString() ?? "");
     }
     catch {
-        return null;
+        piCoreProbe = { at: Date.now(), version: null };
+        piCoreProbePending = false;
+        return;
     }
+    let out = "";
+    const finish = (version) => {
+        piCoreProbe = { at: Date.now(), version };
+        piCoreProbePending = false;
+    };
+    const timer = setTimeout(() => {
+        try {
+            proc.kill();
+        }
+        catch {
+            /* already exited */
+        }
+        finish(null);
+    }, 5000);
+    proc.stdout?.on("data", (d) => (out += d.toString()));
+    proc.on("error", () => {
+        clearTimeout(timer);
+        finish(null);
+    });
+    proc.on("close", (code) => {
+        clearTimeout(timer);
+        finish(code === 0 ? parsePiVersionOutput(out) : null);
+    });
 }
-/** How long a pi probe result stays hot (mirrors ClientSession.piCliProbe). */
-const PI_PROBE_TTL_MS = 10_000;
 /**
  * Default pi core probe: run the globally installed `pi --version`, memoized
  * machine-wide for PI_PROBE_TTL_MS so repeated collectTargets calls never
- * re-block the event loop on a 5s spawnSync. Null on any failure or absence.
- * Mirrors ClientSession.isPiCliInstalled() (same spawnSync shape; Windows
- * resolves `pi` to a pi.cmd shim that only execs through a shell).
+ * re-probe. Serves the last known value and refreshes ASYNCHRONOUSLY in the
+ * background — never blocks the event loop. (It previously used spawnSync
+ * here, which can deadlock the whole server on Android/Termux: fork() in a
+ * multi-threaded process occasionally leaves the forked child stuck between
+ * fork and exec while the main thread sits in spawnSync's pipe_read. Mirrors
+ * ClientSession.isPiCliInstalled(); Windows resolves `pi` to a pi.cmd shim
+ * that only execs through a shell.)
  */
-export const defaultProbePiCore = memoizeWithTtl(rawProbePiCore, PI_PROBE_TTL_MS);
+export function defaultProbePiCore() {
+    const now = Date.now();
+    const cached = piCoreProbe;
+    if (cached && now - cached.at < PI_PROBE_TTL_MS)
+        return cached.version;
+    refreshPiCoreProbe();
+    return cached?.version ?? null;
+}
 /**
  * Fallback when the CLI probe yields nothing: the version of the vendored pi
  * core copy in <agentDir>/npm/node_modules, or null if that is absent too.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pi-web-ui",
-	"version": "0.65.0",
+	"version": "0.67.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-B_ACe6Lp.js → TerminalPanel-B-4FU7T5.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-CaJbqnT7.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-CqXS2SQU.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