pi-web-ui 0.76.0 → 0.77.0

package/dist/server/subagent-templates.js

@@ -32,8 +32,6 @@ export function pickTemplatePrompt(t, lang) {
 }
 /** 名字去空白折叠后非空且 ≤ 60 字符（工具参数可读，允许中文）。 */
 const NAME_MAX = 60;
-/** 模型 id 上限（"provider/id"，含斜杠与自定义模型目录 id）。 */
-const MODEL_MAX = 200;
 /**
  * 内置默认模板（第一次运行时种子进列表；用户改动后以 <dataDir> 文件为准）。
  * 文案改编自 pi-subagents 社区项目（tintinweb / nicobailon）的角色提示词,
@@ -264,6 +262,200 @@ export const DEFAULT_TEMPLATES = [
         model: "",
         enabled: true,
     },
+    // ---- oh-my-pi specialist 系列（移植自 oh-my-pi 内置 agents + persona 包装模板，
+    // 见 tests/scratch/ohmy-essence.md §2-§3）：oh-my-pi 的 subagent 只是 persona 自演，
+    // 这里是真子代理（独立会话、可继续追问），提示词按 persona 模板改写（角色 + 只读约束 +
+    // 输出格式 + 回报纪律）。全部 model:"" = 跟随主对话模型，白名单留空 = 跟随主会话开关。
+    {
+        name: "oracle",
+        description: "只读高智顾问：架构设计、难调的 bug、多系统权衡，复杂决策前先咨询",
+        descriptionEn: "Read-only high-IQ consultant for architecture design, hard debugging, and multi-system tradeoffs. Use when stuck on complex decisions.",
+        promptMode: "replace",
+        systemPrompt: "你是 oracle specialist 子代理：只读的高智顾问，只给分析和建议，不直接改文件。\n\n" +
+            "适用：复杂架构设计、2 次以上没修好的 bug、不熟悉的代码模式、安全/性能顾虑、多系统权衡。\n" +
+            "简单文件操作、第一次尝试的修复、看看代码就能回答的问题——不需要你，直接做的人自己处理。\n\n" +
+            "工作方式：\n" +
+            "- 先读相关代码再下结论，引用具体文件路径和行号；不要臆测没读过的代码。\n" +
+            "- 给出结构化分析：现状、候选方案与权衡、推荐方案及理由。\n" +
+            "- 只描述该改什么、怎么改，不直接做文件编辑——执行留给主 agent 或 implement。\n" +
+            "- 结尾给可执行的建议清单，主 agent 看完就能动手。\n\n" +
+            "你是经 subagent_spawn 派生的子代理：汇报要简洁具体，主 agent 会基于你的结论决策。",
+        systemPromptEn: "You are an oracle specialist subagent: a read-only, high-IQ consultant. Analyze and recommend; do not edit files directly.\n\n" +
+            "Use for: complex architecture design, bugs that survived 2+ fix attempts, unfamiliar code patterns, security/performance concerns, multi-system tradeoffs.\n" +
+            "Simple file operations, first-attempt fixes, or questions answerable from code already read do not need you.\n\n" +
+            "Working rules:\n" +
+            "- Read the relevant code before concluding; cite exact file paths and line numbers. Never speculate about unread code.\n" +
+            "- Deliver structured analysis: current state, candidate options with trade-offs, recommended option with reasons.\n" +
+            "- Describe what should change and how; leave the edits to the main agent or implement.\n" +
+            "- End with an actionable recommendation list the main agent can execute.\n\n" +
+            "You are a subagent spawned via subagent_spawn: report back concisely; the main agent decides based on your conclusions.",
+        enabledSkills: [],
+        enabledExtensions: [],
+        model: "",
+        enabled: true,
+    },
+    {
+        name: "librarian",
+        description: "外部调研专员：不熟的库/API/文档、开源实现参考，多仓库找资料",
+        descriptionEn: "Multi-repository research specialist. Finds documentation, usage examples, and open-source implementations. Use for unfamiliar libraries and APIs.",
+        promptMode: "replace",
+        systemPrompt: "你是 librarian specialist 子代理：外部资料调研专员，只给研究结论，不直接改本地文件。\n\n" +
+            "适用：不熟悉的第三方库、框架特性的最佳实践、外部依赖的异常行为、找开源用法示例。\n\n" +
+            "工作方式：\n" +
+            "- 广撒网：文档、官方示例、开源实现多角度找，交叉验证后再下结论。\n" +
+            "- 每条结论给出来源（链接或包路径+版本），区分“文档原话”和“你的推断”。\n" +
+            "- 结尾给综合结论：可直接用的 API/模式 + 最小示例 + 注意事项。\n\n" +
+            "你是经 subagent_spawn 派生的子代理：汇报要简洁具体，附来源。",
+        systemPromptEn: "You are a librarian specialist subagent: an external-research specialist. Deliver research conclusions; do not edit local files directly.\n\n" +
+            "Use for: unfamiliar third-party libraries, framework best practices, odd external-dependency behavior, open-source usage examples.\n\n" +
+            "Working rules:\n" +
+            "- Cast a wide net: docs, official examples, and open-source implementations; cross-check before concluding.\n" +
+            "- Cite a source (link or package path + version) per conclusion; separate what the docs say from your inferences.\n" +
+            "- End with a synthesis: directly usable API/pattern + minimal example + caveats.\n\n" +
+            "You are a subagent spawned via subagent_spawn: report back concisely, with sources.",
+        enabledSkills: [],
+        enabledExtensions: [],
+        model: "",
+        enabled: true,
+    },
+    {
+        name: "explore",
+        description: "代码库快速侦察：“X 在哪、Y 在哪个文件”，给路径+关键代码",
+        descriptionEn: "Fast contextual grep specialist for codebase exploration. Answers 'Where is X?' and 'Which file has Y?' questions.",
+        promptMode: "replace",
+        systemPrompt: "你是 explore specialist 子代理：代码库侦察员，回答“X 在哪、Y 在哪个文件”这类问题。\n\n" +
+            "工作方式：\n" +
+            "- 先按任务给的精确路径/符号/文件名定位，再读相关文件；需要穷尽（调用点、import、模式不存在）时才宽泛搜索。\n" +
+            "- 只做侦察和汇报，不改文件、不重构。\n" +
+            "- 引用代码给准确路径和行区间，保持简洁。\n\n" +
+            "输出格式：\n" +
+            "# Code Context\n" +
+            "## Files Retrieved\n准确文件与行区间、为什么重要。\n" +
+            "## Key Code\n关键类型/接口/函数与小段代码。\n" +
+            "## Architecture\n各部分如何连接。\n" +
+            "## Start Here\n另一个 agent 应最先打开的文件及原因。",
+        systemPromptEn: "You are an explore specialist subagent: a codebase scout answering 'Where is X?' and 'Which file has Y?' questions.\n\n" +
+            "Working rules:\n" +
+            "- Locate via the exact paths/symbols/filenames given in the task first, then read; use broad search only when exhaustive verification is needed (call sites, imports, absence of a pattern).\n" +
+            "- Reconnoiter and report only: no file edits, no refactoring.\n" +
+            "- Cite exact paths with line ranges; keep output concise.\n\n" +
+            "Output format:\n" +
+            "# Code Context\n" +
+            "## Files Retrieved\nExact files with line ranges and why they matter.\n" +
+            "## Key Code\nKey types/interfaces/functions with short snippets.\n" +
+            "## Architecture\nHow the parts connect.\n" +
+            "## Start Here\nWhich files another agent should open first and why.",
+        enabledSkills: [],
+        enabledExtensions: [],
+        model: "",
+        enabled: true,
+    },
+    {
+        name: "metis",
+        description: "计划前分析：挖隐含意图、歧义和 AI 易错点，复杂任务先澄清范围",
+        descriptionEn: "Pre-planning consultant that analyzes requests to identify hidden intentions, ambiguities, and AI failure points. Use before complex tasks where scope is unclear.",
+        promptMode: "replace",
+        systemPrompt: "你是 metis specialist 子代理：动工前的预分析顾问，不实现，只澄清。\n\n" +
+            "工作方式：\n" +
+            "- 把表面需求映射到真实意图（调研/实现/排查/评估/修 bug/开放式），说出你的判断和依据。\n" +
+            "- 找出隐藏假设、歧义点（多种理解且工作量差 2 倍以上必须问）、缺失的关键信息、AI 易错点。\n" +
+            "- 不确定的地方先给合理默认并注明假设，而不是停下来什么都不产出。\n\n" +
+            "输出格式：\n" +
+            "## Intent\n真实意图一句话。\n" +
+            "## Scope\n做什麽、不做什麽。\n" +
+            "## Risks\n歧义与易错点。\n" +
+            "## Questions\n必须向用户确认的问题（没有就写无）。",
+        systemPromptEn: "You are a metis specialist subagent: a pre-planning consultant. Clarify, do not implement.\n\n" +
+            "Working rules:\n" +
+            "- Map the surface request to its true intent (research/implementation/investigation/evaluation/fix/open-ended) and state your judgment with reasons.\n" +
+            "- Surface hidden assumptions, ambiguities (multiple readings with 2x+ effort difference MUST be asked), missing critical info, and AI failure points.\n" +
+            "- Where uncertain, proceed with a reasonable default and note the assumption instead of stalling.\n\n" +
+            "Output format:\n" +
+            "## Intent\nThe true intent in one sentence.\n" +
+            "## Scope\nWhat to do and what not to do.\n" +
+            "## Risks\nAmbiguities and failure points.\n" +
+            "## Questions\nQuestions that must be confirmed with the user (or none).",
+        enabledSkills: [],
+        enabledExtensions: [],
+        model: "",
+        enabled: true,
+    },
+    {
+        name: "momus",
+        description: "计划评审：按清晰可验证完备三标准审计划，实现前先查缺补漏",
+        descriptionEn: "Expert reviewer for evaluating work plans against rigorous clarity, verifiability, and completeness standards. Use after creating a plan to catch gaps, ambiguities, and missing context before implementation.",
+        promptMode: "replace",
+        systemPrompt: "你是 momus specialist 子代理：计划评审员。实现前先审计划，只评审不实现。\n\n" +
+            "评审三标准：清晰（每步可执行、无歧义）、可验证（完成标准明确）、完备（无缺失步骤、上下文齐全）。\n" +
+            "工作方式：\n" +
+            "- 逐条过计划：可行性、缺失步骤、隐藏风险、与现有架构是否一致、范围是否合适。\n" +
+            "- 只报有证据的问题（对照代码/需求/约束），不要臆测。\n" +
+            "- 引用计划原文_Number_或标题定位问题。\n\n" +
+            "输出格式：\n" +
+            "## Verdict\nGO / GO with notes / NO-GO。\n" +
+            "## Gaps\n缺失的步骤和上下文。\n" +
+            "## Risks\n隐藏风险与歧义。",
+        systemPromptEn: "You are a momus specialist subagent: a plan reviewer. Review the plan before implementation; do not implement.\n\n" +
+            "Review against three standards: clarity (each step executable, unambiguous), verifiability (explicit done criteria), completeness (no missing steps, full context).\n" +
+            "Working rules:\n" +
+            "- Walk the plan step by step: feasibility, missing steps, hidden risks, consistency with existing architecture, appropriate scope.\n" +
+            "- Only raise evidence-backed issues (against code/requirements/constraints); do not speculate.\n" +
+            "- Locate issues by quoting the plan's step numbers or headings.\n\n" +
+            "Output format:\n" +
+            "## Verdict\nGO / GO with notes / NO-GO.\n" +
+            "## Gaps\nMissing steps and context.\n" +
+            "## Risks\nHidden risks and ambiguities.",
+        enabledSkills: [],
+        enabledExtensions: [],
+        model: "",
+        enabled: true,
+    },
+    {
+        name: "multimodal-looker",
+        description: "媒体解读：PDF/图片/图表里提取指定信息，描述视觉内容",
+        descriptionEn: "Analyze media files (PDFs, images, diagrams) that require interpretation beyond raw text. Extracts specific information or summaries from documents, describes visual content.",
+        promptMode: "replace",
+        systemPrompt: "你是 multimodal-looker specialist 子代理：解读 PDF、图片、图表等多媒体文件。\n\n" +
+            "工作方式：\n" +
+            "- 紧扣任务指定的提取目标（goal），只提取被要求的信息，不要全文转写。\n" +
+            "- 图片/图表：描述视觉内容（布局、关键元素、数据趋势），再给结论。\n" +
+            "- 文本类 PDF：给出结构化摘要 + 关键原文引用（含页码/位置）。\n" +
+            "- 读不到或格式不支持时如实说，不要编造内容。\n\n" +
+            "你是经 subagent_spawn 派生的子代理：汇报简洁，结论先行。",
+        systemPromptEn: "You are a multimodal-looker specialist subagent: interpret PDFs, images, and diagrams.\n\n" +
+            "Working rules:\n" +
+            "- Stick to the extraction goal given in the task; extract only what was asked, do not transcribe everything.\n" +
+            "- Images/diagrams: describe the visual content (layout, key elements, data trends), then conclude.\n" +
+            "- Text PDFs: structured summary + key verbatim quotes (with page/location).\n" +
+            "- If a file cannot be read or the format is unsupported, say so honestly; never fabricate content.\n\n" +
+            "You are a subagent spawned via subagent_spawn: report concisely, conclusion first.",
+        enabledSkills: [],
+        enabledExtensions: [],
+        model: "",
+        enabled: true,
+    },
+    {
+        name: "sisyphus-junior",
+        description: "单点执行：范围已定好的实现任务，同等纪律、不再委派",
+        descriptionEn: "Focused task executor. Same discipline, no delegation. Use for well-defined, single-scope implementation tasks where the orchestrator has already done the research and planning.",
+        promptMode: "replace",
+        systemPrompt: "你是 sisyphus-junior specialist 子代理：单点任务执行者。范围已经定好，你只管高质量做完，不再对外委派。\n\n" +
+            "工作方式：\n" +
+            "- 只做派单词范围内的事，不扩大范围；先读相关文件再动手，沿用代码库既有模式。\n" +
+            "- 不压类型错误、不空 catch、不删失败的测试；修 bug 时不顺手重构。\n" +
+            "- 做完必须验证：改动文件的诊断干净，相关构建/测试通过（或注明本就失败的项）。\n\n" +
+            "汇报格式：做了什么、证据（路径/行号/命令输出）、遇到的问题、下一步建议。简洁具体。",
+        systemPromptEn: "You are a sisyphus-junior specialist subagent: a focused task executor. The scope is already defined; execute it well and do not delegate further.\n\n" +
+            "Working rules:\n" +
+            "- Only do what the delegation prompt specifies; do not expand scope. Read the relevant files first and follow existing codebase patterns.\n" +
+            "- No type-error suppression, no empty catch blocks, no deleting failing tests; never refactor while fixing a bug.\n" +
+            "- Verify when done: diagnostics clean on changed files, related build/tests pass (or note pre-existing failures).\n\n" +
+            "Report format: what was done, evidence (paths/line numbers/command output), problems encountered, suggested next steps. Concise and concrete.",
+        enabledSkills: [],
+        enabledExtensions: [],
+        model: "",
+        enabled: true,
+    },
 ];
 /** 容忍脏数据/旧版本：非法条目整体丢弃。 */
 function normalize(raw) {
@@ -316,6 +508,27 @@ export class SubagentTemplatesStore {
                 enabledExtensions: [...t.enabledExtensions],
             }));
         }
+        // 老用户已有文件时：把「从未播种过」的内置模板合并进来（发版新增的内置
+        // 模板才能送达）。seeded 名单记在同目录 sidecar 文件里：用户删掉的内置模板
+        // 已在名单里，不会复活；sidecar 缺失的老用户做一次性全量补齐。
+        // name 即去重键，用户改过的同名条目原样保留。
+        const names = new Set(this.templates.map((t) => t.name));
+        const seeded = this.loadSeeded();
+        let grown = false;
+        for (const t of DEFAULT_TEMPLATES) {
+            if (!names.has(t.name) && !seeded.has(t.name)) {
+                this.templates.push({
+                    ...t,
+                    enabledSkills: [...t.enabledSkills],
+                    enabledExtensions: [...t.enabledExtensions],
+                });
+                names.add(t.name);
+                grown = true;
+            }
+            seeded.add(t.name);
+        }
+        if (grown || seeded.size > 0)
+            this.saveSeeded(seeded);
         return this.templates;
     }
     persist() {
@@ -329,6 +542,42 @@ export class SubagentTemplatesStore {
             // best effort
         }
     }
+    /** 已播种过的内置模板名（sidecar 文件，best-effort；缺失=老用户，做一次性补齐）。 */
+    seededNames = null;
+    seededPath() {
+        return /\.json$/i.test(this.filePath)
+            ? this.filePath.replace(/\.json$/i, ".seeded.json")
+            : `${this.filePath}.seeded.json`;
+    }
+    loadSeeded() {
+        if (this.seededNames)
+            return this.seededNames;
+        const out = new Set();
+        try {
+            const parsed = JSON.parse(readFileSync(this.seededPath(), "utf8"));
+            if (Array.isArray(parsed))
+                for (const n of parsed)
+                    if (typeof n === "string" && n)
+                        out.add(n);
+        }
+        catch {
+            // 无 sidecar：老用户，返回空集触发一次性补齐（下次 load 即建档）。
+        }
+        this.seededNames = out;
+        return out;
+    }
+    saveSeeded(names) {
+        this.seededNames = names;
+        try {
+            mkdirSync(dirname(this.seededPath()), { recursive: true });
+            const tmp = `${this.seededPath()}.tmp`;
+            writeFileSync(tmp, JSON.stringify([...names].sort(), null, 2));
+            renameSync(tmp, this.seededPath());
+        }
+        catch {
+            // best effort
+        }
+    }
     /** 全部模板（含停用的）。设置面板展示用。 */
     list() {
         return this.load().map((t) => ({

package/dist/server/terminals.js

@@ -1559,16 +1559,8 @@ function backgroundResult(terminals, opts, command, partialText, silentSeconds,
         details: { running: true, terminalId: "ai-bash", silentSeconds },
     };
 }
-/** Names of the agent-facing persistent-terminal tools（设置开关门控用）。 */
-export const TERMINAL_TOOL_NAMES = [
-    "terminal_create",
-    "terminal_list",
-    "terminal_close",
-    "terminal_input",
-    "terminal_key",
-    "terminal_read",
-    "terminal_wait",
-];
+/** Agent 持久终端工具名（唯一登记见 tool-manager.ts；此处 re-export 保兼容）。 */
+export { TERMINAL_TOOL_NAMES } from "./tool-manager.js";
 /** 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. */

package/dist/server/tool-manager.js

@@ -0,0 +1,217 @@
+/**
+ * tool-manager.ts — Agent 工具开关的唯一事实源 + 统一出入口（tool_manage）。
+ *
+ * 背景：工具启用散在 4 种写法里——applyToolGating 只会 terminal_* + edit_soft、
+ * “子代理系列”/delegate_task/ask_user_question/markers_list 注册即常驻（无开关）、
+ * skills/extensions 走 resourceLoader 过滤（要 reload）、terminalBash 等是行为
+ * 分支。本模块只收 **ActiveSet 层**（SDK customTools 经
+ * getActiveToolNames/setActiveToolsByName 的启用/禁用，live 生效、无需 reload）；
+ * skills/extensions（资源过滤，另一生命周期）与行为开关不进此表。
+ *
+ * 持久化只有 `ClientSettings.disabledAgentTools: string[]`（禁用的工具名）；
+ * 旧的 terminalToolsEnabled/editSoftEnabled/questionnaireEnabled 作为遗留别名
+ * 保留（协议兼容），由本模块的 legacy*  helper 双向同步。
+ *
+ * 纯模块：零 node 依赖（不 import 任何 server 模块），前端可直接 import
+ * （vite 构建不断），单测零开销。
+ */
+/** 持久终端工具（定义见 terminals.ts，工具名在此唯一登记）。 */
+export const TERMINAL_TOOL_NAMES = [
+    "terminal_create",
+    "terminal_list",
+    "terminal_close",
+    "terminal_input",
+    "terminal_key",
+    "terminal_read",
+    "terminal_wait",
+];
+/** 第一方子代理工具（定义见 subagents.ts，逐个可关）。 */
+export const SUBAGENT_TOOL_NAMES = [
+    "subagent_spawn",
+    "subagent_get_result",
+    "subagent_steer",
+    "subagent_list",
+    "subagent_stop",
+    "subagent_wait_all",
+    "subagent_templates",
+];
+/** 独立宽松编辑工具（定义见 edit-soft-tool.ts）。 */
+export const EDIT_SOFT_TOOL_NAME = "edit_soft";
+/** 结构化派单工具（定义见 delegate-task.ts，执行体复用子代理 spawn 通道）。 */
+export const DELEGATE_TASK_TOOL_NAME = "delegate_task";
+/** 问卷提问工具（定义见 agent-service.ts makeAskUserQuestionTool）。 */
+export const ASK_USER_QUESTION_TOOL_NAME = "ask_user_question";
+/** 任务列表只读查询工具（定义见 agent-service.ts makeMarkersListTool；只服务 todo）。
+ * 曾用名 markers_list（名过其实，已迁移，见 normalizeDisabledAgentTools）。 */
+export const MARKERS_LIST_TOOL_NAME = "todo_list";
+/** 旧工具名（持久化迁移用；新代码一律用 MARKERS_LIST_TOOL_NAME）。 */
+export const LEGACY_MARKERS_LIST_TOOL_NAME = "markers_list";
+/** 可开关的 Agent 工具总目录（共 18 个；bash 本体与 SDK 内置 edit/read
+ *  不进目录——关了 agent 就残了，不给关）。 */
+export const AGENT_TOOL_CATALOG = [
+    ...TERMINAL_TOOL_NAMES.map((name) => ({
+        name,
+        group: "terminal",
+        defaultOn: false,
+        dshVisible: true,
+    })),
+    ...SUBAGENT_TOOL_NAMES.map((name) => ({
+        name,
+        group: "subagent",
+        defaultOn: true,
+        dshVisible: false,
+    })),
+    { name: EDIT_SOFT_TOOL_NAME, group: "other", defaultOn: false, dshVisible: false },
+    { name: DELEGATE_TASK_TOOL_NAME, group: "other", defaultOn: true, dshVisible: false },
+    { name: ASK_USER_QUESTION_TOOL_NAME, group: "other", defaultOn: true, dshVisible: true },
+    { name: MARKERS_LIST_TOOL_NAME, group: "other", defaultOn: true, dshVisible: true },
+];
+const KNOWN_NAMES = new Set(AGENT_TOOL_CATALOG.map((t) => t.name));
+/** 是否为本表登记的可开关工具（未知名一律 false，不抛错）。 */
+export function isKnownAgentTool(name) {
+    return KNOWN_NAMES.has(name);
+}
+/** 归一化禁用名单：非数组回落默认（= 默认关的那些）；数组则只保留已知工具名
+ *  （去重；未知名丢弃，防旧文件/手写脏数据污染）。 */
+export function normalizeDisabledAgentTools(v) {
+    if (!Array.isArray(v))
+        return defaultDisabledAgentTools();
+    const out = [];
+    for (const x of v) {
+        // 旧名迁移：markers_list → todo_list（改名前已关闭的用户保持关闭）。
+        const name = x === LEGACY_MARKERS_LIST_TOOL_NAME ? MARKERS_LIST_TOOL_NAME : x;
+        if (typeof name === "string" && KNOWN_NAMES.has(name) && !out.includes(name))
+            out.push(name);
+    }
+    return out;
+}
+/** 默认禁用名单（= 目录里 defaultOn=false 的那些）。 */
+export function defaultDisabledAgentTools() {
+    return AGENT_TOOL_CATALOG.filter((t) => !t.defaultOn).map((t) => t.name);
+}
+/** 单个工具是否启用（禁用名单里没有 = 启用）。 */
+export function isAgentToolEnabled(name, disabled) {
+    return !disabled.includes(name);
+}
+/**
+ * 统一出入口 tool_manage：开关任意一个已登记的工具（live 生效，无需 reload；
+ * 工具仍留在注册表，重开可直接加回）。未知工具名返回 false（不抛错，
+ * 调用方据此给 AI/用户报错）；session 未就绪同样返回 false。
+ */
+export function setAgentToolEnabled(session, name, on) {
+    if (!isKnownAgentTool(name))
+        return false;
+    try {
+        const names = new Set(session.getActiveToolNames());
+        if (on)
+            names.add(name);
+        else
+            names.delete(name);
+        session.setActiveToolsByName([...names]);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** 批量版（组头全开/全关用；含未知名时照常处理已知部分，返回实际处理数）。 */
+export function setAgentToolsEnabled(session, names, on) {
+    const known = names.filter(isKnownAgentTool);
+    if (known.length === 0)
+        return 0;
+    try {
+        const active = new Set(session.getActiveToolNames());
+        for (const n of known) {
+            if (on)
+                active.add(n);
+            else
+                active.delete(n);
+        }
+        session.setActiveToolsByName([...active]);
+        return known.length;
+    }
+    catch {
+        return 0;
+    }
+}
+/**
+ * 全量重放（创建会话 / reload 后 / 设置变更后调）：按禁用名单把目录内工具
+ * 逐个加回或剔除；目录外的工具（bash/SDK 内置/插件工具）原样不动。
+ * Session 未就绪时静默跳过（下次创建/reload 会再应用）。
+ */
+export function applyAgentToolsGating(session, disabled) {
+    try {
+        const off = new Set(disabled);
+        const names = new Set(session.getActiveToolNames());
+        for (const t of AGENT_TOOL_CATALOG) {
+            if (off.has(t.name))
+                names.delete(t.name);
+            else
+                names.add(t.name);
+        }
+        session.setActiveToolsByName([...names]);
+    }
+    catch {
+        // Session 未就绪——下次创建/reload 会再应用。
+    }
+}
+/**
+ * 旧存档迁移：已有新字段直接归一化；否则按遗留三开关折算
+ * （语义与改动前一致：terminal/edit 未设/关 = 禁用对应组；问卷未设/开 = 启用）。
+ */
+export function legacyToDisabled(s) {
+    if (Array.isArray(s.disabledAgentTools))
+        return normalizeDisabledAgentTools(s.disabledAgentTools);
+    const off = [];
+    if (s.terminalToolsEnabled !== true)
+        off.push(...TERMINAL_TOOL_NAMES);
+    if (s.editSoftEnabled !== true)
+        off.push(EDIT_SOFT_TOOL_NAME);
+    if (s.questionnaireEnabled === false)
+        off.push(ASK_USER_QUESTION_TOOL_NAME);
+    return normalizeDisabledAgentTools(off);
+}
+/** 由禁用名单推导遗留三开关（协议兼容用；终端组按“全开才算开”的全有/全无视图）。 */
+export function deriveLegacy(disabled) {
+    const off = new Set(disabled);
+    return {
+        terminalToolsEnabled: TERMINAL_TOOL_NAMES.every((n) => !off.has(n)),
+        editSoftEnabled: !off.has(EDIT_SOFT_TOOL_NAME),
+        questionnaireEnabled: !off.has(ASK_USER_QUESTION_TOOL_NAME),
+    };
+}
+/**
+ * 遗留单开关写入时折回新字段（只动开关覆盖的组，其余条目原样保留）：
+ * 传 true = 把该组从禁用名单移除，false = 加入，未传 = 不动。
+ */
+export function foldLegacyIntoDisabled(current, legacy) {
+    const next = new Set(normalizeDisabledAgentTools(current));
+    const applyGroup = (names, v) => {
+        if (v === undefined)
+            return;
+        for (const n of names) {
+            if (v)
+                next.delete(n);
+            else
+                next.add(n);
+        }
+    };
+    applyGroup(TERMINAL_TOOL_NAMES, legacy.terminalToolsEnabled);
+    applyGroup([EDIT_SOFT_TOOL_NAME], legacy.editSoftEnabled);
+    applyGroup([ASK_USER_QUESTION_TOOL_NAME], legacy.questionnaireEnabled);
+    return [...next];
+}
+/**
+ * 门控实效名单：新字段 + 问卷别名合并（问卷关 = ask 工具必关，双保险；
+ * 两处平时由 set() 同步一致，合并只防陈旧会话/旧客户端的半边状态）。
+ */
+export function effectiveDisabledAgentTools(s) {
+    const next = new Set(legacyToDisabled({ ...s, disabledAgentTools: s.disabledAgentTools }));
+    if (s.questionnaireEnabled === false)
+        next.add(ASK_USER_QUESTION_TOOL_NAME);
+    return [...next];
+}
+/** 终端使用引导是否注入（组内有任一工具启用才教 AI 用，否则就是教不存在的工具）。 */
+export function isTerminalGuidanceOn(disabled) {
+    return TERMINAL_TOOL_NAMES.some((n) => !disabled.includes(n));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pi-web-ui",
-	"version": "0.76.0",
+	"version": "0.77.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-CDsBHVQ5.js

@@ -0,0 +1,6 @@
+import{a as l,j as n}from"./markdown-Cpo0pNcR.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-BsATrxLx.js";import{D as re,o as ie}from"./xterm-B96xOxS9.js";import"./react-CtudoG1_.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
+`)},[f,c,k]),n.jsx("div",{ref:C,className:`term-xterm ${w?"":"hidden"}`})}const q={name:"",command:"",cwd:"${pwd}"};function pe({chat:t,terminal:c}){const s=W(),[h,u]=l.useState(null),[w,f]=l.useState(!1),[k,g]=l.useState(!1),[C,j]=l.useState(null),[o,y]=l.useState(q),[E,F]=l.useState(null),x=l.useRef(null),[m,r]=l.useState(!0),[v,b]=l.useState(null),[_,$]=l.useState("");l.useEffect(()=>{t.terminals.length===0?u(null):t.terminals.some(e=>e.id===h)||u(t.terminals[t.terminals.length-1].id)},[t.terminals,h]),l.useEffect(()=>{t.terminalActiveId&&(u(t.terminalActiveId),f(!1))},[t.terminalActiveId]),l.useEffect(()=>()=>{x.current&&clearTimeout(x.current)},[]);const B=t.terminals.filter(e=>!e.agentBash),R=t.terminals.filter(e=>e.agentBash),T=e=>{if(!t.ready)return;const a=ae(),i=t.activeConversationId||t.state?.conversationId||"";c.create({...e,id:a,conversationId:i,cols:e.cols??80,rows:e.rows??24,running:!0,exitCode:null}),u(a),f(!1)},d=()=>T({title:s("terminalTitle",{n:B.length+1}),cwd:t.state?.cwd??""}),S=e=>{const a=e.name||e.command,i=t.terminals.find(N=>N.title===a);if(i){c.restart(i.id),u(i.id),p({type:"run_command",terminalId:i.id,conversationId:i.conversationId,command:e,cols:80,rows:24});return}T({title:a,cwd:t.state?.cwd??"",command:e})},D=e=>{const a=t.terminals.find(i=>i.id===e);if(a&&p({type:"terminal_kill",terminalId:e,conversationId:a.conversationId}),c.close(e),h===e){const i=t.terminals.filter(N=>N.id!==e);u(i.length>0?i[i.length-1].id:null)}},I=e=>n.jsxs("div",{className:`term-tab ${e.id===h?"active":""}`,children:[n.jsxs("button",{type:"button",className:"term-tab-main",title:`${e.cwd}${e.command?`
+> ${e.command.command}`:""}`,onClick:()=>{v||(u(e.id),f(!1))},children:[n.jsx("span",{className:`term-tab-dot ${e.running?"run":"exit"}`}),n.jsxs("span",{className:"term-tab-title",children:[v===e.id?n.jsx("input",{autoFocus:!0,className:"term-tab-rename-input",value:_,placeholder:e.title,onClick:a=>a.stopPropagation(),onChange:a=>$(a.target.value),onKeyDown:a=>{if(a.stopPropagation(),a.key==="Enter"&&!a.nativeEvent.isComposing){const i=_.trim();i&&p({type:"rename_terminal",terminalId:e.id,conversationId:e.conversationId,title:i}),b(null)}else a.key==="Escape"&&b(null)},onBlur:()=>b(null)}):e.title,!e.running&&n.jsx("span",{className:"term-tab-exit",children:s("exited",{code:e.exitCode===null?"":` ${e.exitCode}`})})]})]}),n.jsx("button",{type:"button",className:"term-tab-close term-tab-rename",title:s("renameTerminal"),onClick:a=>{a.stopPropagation(),$(e.title),b(e.id)},children:n.jsx(H,{})}),n.jsx("button",{type:"button",className:"term-tab-close",title:s("closeTerminal"),onClick:()=>D(e.id),children:n.jsx(se,{})})]},e.id),G=()=>{g(!0),j(null),y(q)},L=e=>{const a=t.commands[e];a&&(g(!1),j(e),y({name:a.name,command:a.command,cwd:a.cwd??""}))},K=()=>{g(!1),j(null)},A=()=>{const e=o.name.trim(),a=o.command.trim();if(!e||!a)return;const i=o.cwd.trim(),N={name:e,command:a,cwd:i||void 0},Q=k?[...t.commands,N]:C!==null?t.commands.map((U,V)=>V===C?N:U):t.commands;p({type:"save_commands",commands:Q}),K()},J=e=>{if(E===e){const a=t.commands.filter((i,N)=>N!==e);p({type:"save_commands",commands:a}),F(null),x.current&&clearTimeout(x.current)}else F(e),x.current&&clearTimeout(x.current),x.current=setTimeout(()=>F(null),2500)},X=k||C!==null;return n.jsxs("div",{className:"terminal-view",children:[n.jsxs("aside",{className:`term-side term-commands ${w?"open":""}`,children:[n.jsxs("div",{className:"panel-header",children:[n.jsx("span",{className:"panel-title",children:s("commands")}),n.jsxs("div",{className:"panel-header-actions",children:[n.jsx("button",{type:"button",className:"panel-refresh",title:s("rerun"),onClick:()=>p({type:"list_commands"}),children:n.jsx(Y,{})}),n.jsx("button",{type:"button",className:"panel-new",title:s("newCommand"),onClick:G,children:n.jsx(z,{})})]})]}),n.jsx("div",{className:"panel-body",children:X?n.jsxs("div",{className:"cmd-form",children:[n.jsx("label",{htmlFor:"cmd-name",children:s("name")}),n.jsx("input",{id:"cmd-name",className:"cmd-input",value:o.name,placeholder:s("exampleName"),autoFocus:!0,onChange:e=>y({...o,name:e.target.value})}),n.jsx("label",{htmlFor:"cmd-command",children:s("command")}),n.jsx("input",{id:"cmd-command",className:"cmd-input",value:o.command,placeholder:s("exampleCommand"),onChange:e=>y({...o,command:e.target.value}),onKeyDown:e=>{e.key==="Enter"&&!e.nativeEvent.isComposing&&A()}}),n.jsxs("label",{htmlFor:"cmd-cwd",children:[s("directory")," ",n.jsx("span",{className:"cmd-hint",children:s("cwdHint")})]}),n.jsx("input",{id:"cmd-cwd",className:"cmd-input",value:o.cwd,placeholder:"${pwd}",onChange:e=>y({...o,cwd:e.target.value}),onKeyDown:e=>{e.key==="Enter"&&!e.nativeEvent.isComposing&&A()}}),n.jsxs("div",{className:"cmd-form-actions",children:[n.jsx("button",{type:"button",className:"btn",onClick:K,children:s("cancel")}),n.jsx("button",{type:"button",className:"btn primary",disabled:!o.name.trim()||!o.command.trim(),onClick:A,children:s("save")})]})]}):n.jsxs(n.Fragment,{children:[t.commands.length===0&&n.jsx("div",{className:"panel-empty",children:s("noCommands")}),t.commands.map((e,a)=>n.jsxs("div",{className:"cmd-item",children:[n.jsx("button",{type:"button",className:"cmd-run",title:s("clickToRun"),onClick:()=>S(e),children:n.jsx(Z,{})}),n.jsxs("button",{type:"button",className:"cmd-main",title:s("clickToRun"),onClick:()=>S(e),children:[n.jsx("span",{className:"cmd-name",children:e.name}),n.jsx("span",{className:"cmd-command",children:e.command}),e.cwd&&n.jsx("span",{className:"cmd-cwd",children:e.cwd})]}),n.jsx("button",{type:"button",className:"cmd-act",title:s("edit"),onClick:()=>L(a),children:n.jsx(H,{})}),n.jsx("button",{type:"button",className:`cmd-act del ${E===a?"confirm":""}`,title:s("delete"),onClick:()=>J(a),children:E===a?s("confirmQ"):n.jsx(ee,{})})]},a))]})}),n.jsxs("div",{className:"term-tabs-block",children:[n.jsxs("div",{className:"panel-header",children:[n.jsx("span",{className:"panel-title",children:s("terminal")}),n.jsx("button",{type:"button",className:"panel-new",title:s("newTerminal"),onClick:d,children:n.jsx(z,{})})]}),n.jsxs("div",{className:"panel-body",children:[t.terminals.length===0&&n.jsx("div",{className:"panel-empty",children:s("noTerminal")}),B.map(I),R.length>0&&n.jsxs("div",{className:"term-folder",children:[n.jsxs("button",{type:"button",className:`term-folder-header ${m?"open":""}`,title:s("aiBashGroup"),onClick:()=>r(e=>!e),children:[n.jsx("span",{className:"term-folder-caret",children:m?"▾":"▸"}),n.jsx("span",{className:"term-folder-title",children:s("aiBashGroup")}),n.jsx("span",{className:"term-folder-count",children:R.length})]}),m&&n.jsx("div",{className:"term-folder-body",children:R.map(I)})]})]})]})]}),n.jsxs("div",{className:"term-main",children:[w&&n.jsx("div",{className:"drawer-backdrop",onClick:()=>f(!1)}),n.jsx("button",{type:"button",className:"term-side-toggle",title:s("commands"),onClick:()=>f(e=>!e),children:n.jsx(ne,{})}),t.terminals.length===0?n.jsxs("div",{className:"term-empty",children:[n.jsx(te,{className:"term-empty-icon"}),n.jsx("div",{className:"term-empty-title",children:s("builtinTerminal")}),n.jsx("div",{className:"term-empty-sub",children:s("termEmptySub")})]}):t.terminals.map(e=>n.jsx(ce,{conversationId:e.conversationId,terminalId:e.id,command:e.command,cwd:e.cwd,title:e.title,active:e.id===h,running:e.running,exitCode:e.exitCode,register:c.register},`${e.conversationId}:${e.id}`))]})]})}export{pe as TerminalPanel};