From e40fb2b673dac1c06aeae8a36c13f12ee0c87c2c Mon Sep 17 00:00:00 2001
From: Sopaco <dokhell@live.cn>
Date: Mon, 30 Mar 2026 00:32:42 +0800
Subject: [PATCH 1/7] Add AI context maintenance guidelines

---
 litho.docs/context-aware/adr-guide.md   | 105 +++++++++++
 litho.docs/context-aware/maintenance.md | 158 ++++++++++++++++
 litho.docs/context-aware/methodology.md | 180 +++++++++++++++++++
 litho.docs/context-aware/templates.md   | 229 ++++++++++++++++++++++++
 4 files changed, 672 insertions(+)
 create mode 100644 litho.docs/context-aware/adr-guide.md
 create mode 100644 litho.docs/context-aware/maintenance.md
 create mode 100644 litho.docs/context-aware/methodology.md
 create mode 100644 litho.docs/context-aware/templates.md

diff --git a/litho.docs/context-aware/adr-guide.md b/litho.docs/context-aware/adr-guide.md
new file mode 100644
index 0000000..369fcbc
--- /dev/null
+++ b/litho.docs/context-aware/adr-guide.md
@@ -0,0 +1,105 @@
+# Architecture Decisions Record (ADR) 编写指南
+
+## 什么是ADR？
+
+记录**反直觉的设计决策**——那些AI无法从代码推断的"为什么"。
+
+## 什么需要记录？
+
+| 需要记录 | 不需要记录 |
+|---------|-----------|
+| 违反常见模式 | 遵循最佳实践 |
+| 有非显而易见的原因 | 原因显而易见 |
+| 会让人困惑的设计 | 直观的设计 |
+| 有替代方案但放弃了 | 没有其他选择 |
+
+## ADR模板
+
+```markdown
+## ADR-XXX: [简短标题]
+
+**Decision**: 做了什么决定
+
+**Reason**: 为什么这样做（最重要）
+
+**Impact**: 影响哪些代码/模块
+
+**Do not**: 什么不要做（可选）
+
+**Limitation**: 有什么限制（可选）
+```
+
+## 示例
+
+### ✅ 好的ADR
+
+```markdown
+## ADR-001: LoopAgent max_iterations=1
+
+**Decision**: 所有Actor-Critic循环使用max_iterations=1
+
+**Reason**: SequentialAgent有bug，exit_loop()会终止整个链而非仅循环。
+用max_iterations=1让LoopAgent自然完成。
+
+**Impact**: 所有critical stages (PRD, Design, Plan, Coding)
+
+**Do not**: 修改此参数或迁移到SequentialAgent
+```
+
+### ❌ 不需要记录的
+
+```markdown
+## ADR-XXX: 使用async/await
+
+**Decision**: 使用async/await处理异步
+
+**Reason**: 这是Rust标准做法
+
+→ 这是最佳实践，不需要记录
+```
+
+## 示例场景
+
+### 场景1：性能换简洁
+
+```markdown
+## ADR-XXX: JSON存储而非SQLite
+
+**Decision**: 用JSON文件存储数据
+
+**Reason**: 简化调试、易于检查、无外部依赖。数据量小、无并发需求。
+
+**Limitation**: 不适合大规模并发场景
+```
+
+### 场景2：Bug workaround
+
+```markdown
+## ADR-XXX: 两步知识提升
+
+**Decision**: Insight→Decision需要两个工具
+
+**Reason**: 并非所有insight都应成为decision。
+中间步骤让人review确保质量。
+
+**Impact**: memory tools, knowledge workflow
+```
+
+### 场景3：安全权衡
+
+```markdown
+## ADR-XXX: HITL超时默认Pass
+
+**Decision**: HITL确认超时时默认继续(Pass)
+
+**Reason**: 比无限阻塞好。用户可用PM Agent回退。
+
+**Impact**: Stage执行, GUI超时处理
+```
+
+## 维护原则
+
+1. **只加不减**：ADR是历史记录，不建议删除
+2. **简短有力**：每个ADR不超过100字
+3. **聚焦原因**：Reason字段最重要
+4. **保持数量少**：一个项目通常只有5-15个ADR
diff --git a/litho.docs/context-aware/maintenance.md b/litho.docs/context-aware/maintenance.md
new file mode 100644
index 0000000..867724b
--- /dev/null
+++ b/litho.docs/context-aware/maintenance.md
@@ -0,0 +1,158 @@
+# AI上下文维护实践
+
+## 会话启动检测
+
+在AGENTS.md中添加启动检测指令：
+
+```markdown
+## 每次开始编程任务前
+
+1. 运行: git diff --name-only HEAD~10
+2. 如果变更涉及关键目录，提醒用户更新文档
+```
+
+### 关键目录映射
+
+| 目录变更 | 提醒更新 |
+|---------|---------|
+| `tools/*.rs` | tools.md |
+| `pipeline/stages/*.rs` | pipeline.md |
+| `domain/*.rs` | domain-logic.md |
+| 新增安全规则 | constraints.md |
+
+---
+
+## 更新工作流
+
+### 用户主动更新
+
+```
+用户: "Update .ai-context because I added a new tool"
+
+Agent执行：
+1. 读取 manifest.yaml 了解更新规则
+2. 读取对应文件（如 tools.md）
+3. 添加条目到合适位置
+4. 保持格式一致
+```
+
+### Agent检测更新
+
+```
+Agent在会话启动时：
+1. git diff --name-only HEAD~10
+2. 检查是否涉及关键目录
+3. 如有，提醒："检测到[目录]变更，是否更新.ai-context？"
+```
+
+---
+
+## 文档一致性检查
+
+### 手动检查清单
+
+- [ ] 新增工具是否在tools.md中有条目？
+- [ ] 新增Stage是否在pipeline.md中有记录？
+- [ ] 架构决策是否记录在architecture-decisions.md？
+- [ ] 文档中的路径是否仍然有效？
+
+### 自动化检查（可选）
+
+```bash
+# 检查tools.md中提到的文件是否存在
+grep -o "tools/[^.]*\.rs" .ai-context/domains/tools.md | while read f; do
+  [ -f "crates/cowork-core/src/$f" ] || echo "Missing: $f"
+done
+```
+
+---
+
+## 常见更新场景
+
+### 场景1：新增工具
+
+```
+用户: "我刚加了一个ValidateSchemaTool"
+
+Agent:
+1. 读取 tools.md
+2. 判断工具属于哪个分类（Validation）
+3. 在对应表格添加：| ValidateSchemaTool | Validate JSON schema |
+```
+
+### 场景2：架构决策
+
+```
+用户: "我决定用Redis替代内存缓存"
+
+Agent:
+1. 读取 architecture-decisions.md
+2. 添加ADR：
+   ## ADR-XXX: Redis for Caching
+   Decision: 使用Redis替代进程内缓存
+   Reason: 需要跨进程共享、持久化
+   Impact: memory模块
+```
+
+### 场景3：新增模块
+
+```
+用户: "我加了一个新的reporting模块"
+
+Agent:
+1. 更新 modules.map 模块列表
+2. 更新 project.snapshot 结构说明
+3. 如有新的Store，更新 storage structure
+```
+
+---
+
+## 不需要更新的场景
+
+| 场景 | 原因 |
+|------|------|
+| 重命名变量 | AI读代码即可 |
+| 提取函数 | 不影响结构 |
+| struct增减字段 | 文档不记录字段 |
+| 函数签名变化 | AI直接看代码 |
+| 移动文件位置 | 如不影响模块关系，可不更新 |
+
+---
+
+## 文档过时了怎么办？
+
+### 轻度过时（10-20%）
+
+不影响使用，AI能从代码推断正确信息。
+
+### 中度过时（20-40%）
+
+AI可能定位错误，需要用户手动更新。
+
+### 重度过时（>40%）
+
+建议重新生成文档或手动全面更新。
+
+---
+
+## CI集成（可选）
+
+```yaml
+# .github/workflows/ai-context-check.yml
+name: AI Context Check
+on: [pull_request]
+
+jobs:
+  check:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Check for significant changes
+        run: |
+          CHANGED=$(git diff --name-only origin/main)
+          if echo "$CHANGED" | grep -q "tools/\|pipeline/stages/\|domain/"; then
+            echo "::warning::Significant changes detected. Consider updating .ai-context/"
+          fi
+```
+
+这只是提醒，不阻塞CI。
diff --git a/litho.docs/context-aware/methodology.md b/litho.docs/context-aware/methodology.md
new file mode 100644
index 0000000..ec19ce4
--- /dev/null
+++ b/litho.docs/context-aware/methodology.md
@@ -0,0 +1,180 @@
+# AI友好的项目上下文方法论
+
+## 核心理念
+
+让Coding Agent理解项目，不需要每次都消耗大量Token从头阅读代码。
+
+### 关键矛盾
+
+| 需求 | 约束 |
+|------|------|
+| 信息足够让AI理解代码 | 文档不能太细，维护成本高 |
+| 保持准确性 | 更新本身消耗Token |
+| 覆盖关键决策 | 不能每次都从头读代码 |
+
+### 解决思路：分层 + 衰减
+
+```
+高价值/低变化 → 详细文档，长期有效
+高价值/高变化 → 简要索引，指向代码
+低价值/低变化 → 不记录
+低价值/高变化 → 不记录（AI直接读代码）
+```
+
+---
+
+## 设计原则
+
+### 1. 记录"为什么"，不记录"是什么"
+
+AI可以从代码读出"是什么"，但无法推断"为什么"。
+
+```
+❌ 不记录：
+struct Iteration {
+    id: String,
+    number: u32,
+    ...
+}
+
+✅ 记录：
+为什么LoopAgent用max_iterations=1？
+因为SequentialAgent有bug，exit_loop会提前终止整个链。
+```
+
+### 2. 删除精确引用
+
+精确行号容易过时，用概念定位代替。
+
+```
+❌ 位置: crates/cowork-core/src/pipeline/executor/mod.rs:72
+
+✅ 入口函数: IterationExecutor::execute()
+   AI可以通过grep自己定位
+```
+
+### 3. 合并相关内容
+
+减少文件跳转，降低认知负担。
+
+```
+合并前：
+- domains/pipeline.md (Pipeline)
+- domains/agents.md (Agents)
+- domains/interaction.md (Interaction)
+
+合并后：
+- domains/pipeline.md (Pipeline + Agents)
+- core/constraints.md (约束 + Interaction规则)
+```
+
+### 4. 精简工具列表
+
+工具名已经足够说明功能。
+
+```
+❌ | ReadFileTool | 读取文件内容 |
+   | WriteFileTool | 写入文件内容 |
+
+✅ File Tools: ReadFile, WriteFile, ListFiles
+```
+
+---
+
+## 文档结构
+
+### 最小化结构
+
+```
+.ai-context/
+├── manifest.yaml          # 索引 + 维护指南
+├── project.snapshot       # 项目结构 + 存储 + 配置
+├── architecture-decisions.md  # 反直觉设计决策
+├── core/
+│   ├── modules.map        # 模块依赖 + 导航
+│   └── constraints.md     # 安全约束 + 限制规则
+├── domains/
+│   ├── pipeline.md        # 流程 + Agent
+│   ├── domain-logic.md    # 核心实体关系
+│   └── tools.md           # 工具分类
+└── prompts/
+    └── coding-context.md  # 代码风格
+```
+
+### Token预算
+
+| 文件 | 预算 | 用途 |
+|------|------|------|
+| project.snapshot | ~800 | 项目概览 |
+| modules.map | ~800 | 导航定位 |
+| constraints.md | ~400 | 约束规则 |
+| pipeline.md | ~500 | 流程理解 |
+| domain-logic.md | ~400 | 实体关系 |
+| tools.md | ~400 | 工具索引 |
+| architecture-decisions.md | ~500 | 决策理解 |
+| **总计** | **~4000** | |
+
+---
+
+## 维护策略
+
+### 需要更新 vs 不需要更新
+
+| 变化类型 | 是否更新文档 |
+|---------|-------------|
+| 新增工具 | ✅ 更新 tools.md |
+| 新增Stage | ✅ 更新 pipeline.md |
+| 新增模块 | ✅ 更新 modules.map |
+| 新增约束 | ✅ 更新 constraints.md |
+| 架构决策 | ✅ 更新 architecture-decisions.md |
+| struct字段变化 | ❌ 不更新 |
+| 函数签名变化 | ❌ 不更新 |
+| 重构代码 | ❌ 不更新 |
+| 行号变化 | ❌ 不记录 |
+
+### 更新指令
+
+```
+用户: "Update .ai-context because I added a new tool"
+用户: "Update .ai-context because I made an architecture decision"
+```
+
+### 变更检测
+
+Agent可在会话启动时检测：
+```bash
+git diff --name-only HEAD~10
+```
+
+检测到关键目录变更时提醒用户更新文档。
+
+---
+
+## 实践检查清单
+
+### 创建AI上下文时
+
+- [ ] 是否只记录"为什么"而非"是什么"？
+- [ ] 是否删除了精确行号引用？
+- [ ] 是否合并了相关内容？
+- [ ] 是否删除了struct字段定义？
+- [ ] 总Token是否控制在4000以内？
+
+### 维护AI上下文时
+
+- [ ] 是否只在高价值变化时更新？
+- [ ] 是否避免了结构体字段的同步？
+- [ ] 是否保持了"指向代码"的原则？
+
+---
+
+## 效果评估
+
+| 准确度 | 效果 |
+|--------|------|
+| 70% | Agent能理解项目结构 |
+| 80% | Agent能找到关键代码 |
+| 90% | Agent能遵循核心约束 |
+| 100% | 不现实，维护成本过高 |
+
+**核心目标**：让Agent快速定位，需要精确信息时自己去读代码。
diff --git a/litho.docs/context-aware/templates.md b/litho.docs/context-aware/templates.md
new file mode 100644
index 0000000..dfa6ffb
--- /dev/null
+++ b/litho.docs/context-aware/templates.md
@@ -0,0 +1,229 @@
+# AI上下文模板
+
+## 项目快照模板 (project.snapshot)
+
+```markdown
+# [项目名] - AI Context Snapshot
+
+## PROJECT OVERVIEW
+
+name: [项目名]
+type: [rust-workspace | monorepo | single-app]
+version: [版本]
+description: [一句话描述]
+
+## STRUCTURE
+
+### [核心模块名]
+path: [路径]
+key_modules:
+  - [模块1]: [作用]
+  - [模块2]: [作用]
+
+### [CLI/前端等其他模块]
+path: [路径]
+
+---
+
+## STORAGE STRUCTURE
+
+[存储目录结构，简化版]
+
+| Store | File | Purpose |
+|-------|------|---------|
+| [Store名] | [文件路径] | [用途] |
+
+---
+
+## CONFIGURATION
+
+[配置文件位置和关键字段]
+
+---
+
+## EXTERNAL INTEGRATIONS
+
+[外部集成，如API、SDK等]
+
+---
+**Note**: For detailed implementations, see corresponding source files.
+```
+
+---
+
+## 模块地图模板 (modules.map)
+
+```markdown
+# Module Dependency Map
+# Note: For detailed function signatures, grep the code directly
+
+## ARCHITECTURE LAYERS
+
+```
+[ASCII架构图，展示分层]
+```
+
+## MODULE DEPENDENCY FLOW
+
+```
+[依赖流向，一行表示]
+```
+
+## KEY TRAITS
+
+| Trait | Location | Purpose |
+|-------|----------|---------|
+| [Trait名] | [位置] | [用途] |
+
+## CORE FLOWS
+
+### [流程名]
+```
+[流程步骤]
+```
+
+## MODULE FILES REFERENCE
+
+### [模块名]
+`[路径]`
+- [文件1] - [作用]
+- [文件2] - [作用]
+
+## QUICK NAVIGATION BY TASK
+
+| Task | Location |
+|------|----------|
+| [任务描述] | [文件路径] |
+```
+
+---
+
+## 约束模板 (constraints.md)
+
+```markdown
+# Constraints & Boundaries
+
+## Security Constraints
+
+| Constraint | Rule |
+|------------|------|
+| [约束名] | [规则] |
+
+## Rate Limiting
+
+| Resource | Limit |
+|----------|-------|
+| [资源名] | [限制] |
+
+## [业务] Constraints
+
+| Constraint | Value |
+|------------|-------|
+| [约束] | [值] |
+
+## Error Handling
+
+| Type | Behavior |
+|------|----------|
+| [错误类型] | [处理方式] |
+```
+
+---
+
+## 领域文档模板 (domains/*.md)
+
+```markdown
+# [领域名] Domain
+
+## Core Concepts
+
+| Concept | Location | Purpose |
+|---------|----------|---------|
+| [概念] | [位置] | [用途] |
+
+## Relationships
+
+```
+[实体关系图]
+```
+
+## [关键机制]
+
+| Type | Description |
+|------|-------------|
+| [类型] | [描述] |
+
+## Code Locations
+
+| Component | Location |
+|-----------|----------|
+| [组件] | [位置] |
+
+---
+**Note**: For details, read source files directly.
+```
+
+---
+
+## 工具索引模板 (tools.md)
+
+```markdown
+# Tools Domain
+
+## Tool Categories
+
+| Category | File | Key Tools |
+|----------|------|-----------|
+| [分类] | [文件] | [工具列表] |
+
+## Security
+
+[安全约束摘要]
+
+## Location
+
+[工具目录路径]
+```
+
+---
+
+## Manifest模板 (manifest.yaml)
+
+```yaml
+# AI Context Manifest
+# Version: [版本]
+# Project: [项目名]
+
+manifest_version: "[版本]"
+project:
+  name: [项目名]
+  version: [版本]
+  language: [语言]
+
+documents:
+  - path: [文件路径]
+    purpose: [用途]
+    tokens: ~[估算]
+
+usage:
+  coding_context:
+    - [文件列表]
+  
+  debug_context:
+    - [文件列表]
+
+total_tokens: ~[总计]
+
+# =============================================================================
+# MAINTENANCE GUIDE
+# =============================================================================
+#
+# | Code Change              | Update File            |
+# |--------------------------|------------------------|
+# | [变更类型]               | [更新文件]             |
+#
+# | NO UPDATE: [不需要更新的情况] |
+#
+# Command: "Update .ai-context because I [action] [thing]"
+# =============================================================================
+```

From 77918a54040a5df66473df211c7fe6557e9f2827 Mon Sep 17 00:00:00 2001
From: Sopaco <dokhell@hotmail.com>
Date: Mon, 30 Mar 2026 15:22:04 +0800
Subject: [PATCH 2/7] Add expandable modal textarea to chat input

---
 .../src/components/chat/InputArea.tsx         | 231 +++++++++++++++---
 1 file changed, 203 insertions(+), 28 deletions(-)

diff --git a/crates/cowork-gui/src/components/chat/InputArea.tsx b/crates/cowork-gui/src/components/chat/InputArea.tsx
index 72adb9a..b409651 100644
--- a/crates/cowork-gui/src/components/chat/InputArea.tsx
+++ b/crates/cowork-gui/src/components/chat/InputArea.tsx
@@ -1,8 +1,10 @@
-import React, { memo, useCallback } from 'react';
-import { Button, Space, Input } from 'antd';
-import { CopyOutlined } from '@ant-design/icons';
+import React, { memo, useCallback, useState, useRef, useEffect } from 'react';
+import { Button, Space, Input, Modal } from 'antd';
+import { CopyOutlined, ExpandOutlined, CompressOutlined } from '@ant-design/icons';
 import type { InputRequest, InputOption } from '../../stores';
 
+const { TextArea } = Input;
+
 interface InputAreaProps {
   userInput: string;
   onUserInputChange: (value: string) => void;
@@ -28,27 +30,158 @@ const InputAreaInner: React.FC<InputAreaProps> = ({
   disabled,
   mode,
 }) => {
-  const handleInputChange = useCallback((e: React.ChangeEvent<HTMLInputElement>) => {
+  const [expanded, setExpanded] = useState(false);
+  const textAreaRef = useRef<HTMLTextAreaElement>(null);
+  const modalTextAreaRef = useRef<HTMLTextAreaElement>(null);
+
+  const handleInputChange = useCallback((e: React.ChangeEvent<HTMLTextAreaElement>) => {
     onUserInputChange(e.target.value);
   }, [onUserInputChange]);
 
+  const handleKeyDown = useCallback((e: React.KeyboardEvent<HTMLTextAreaElement>) => {
+    // Shift + Enter: 展开输入框
+    if (e.shiftKey && e.key === 'Enter') {
+      e.preventDefault();
+      setExpanded(true);
+      return;
+    }
+    // Enter alone: 发送消息
+    if (!e.shiftKey && e.key === 'Enter') {
+      e.preventDefault();
+      if (userInput.trim() && !disabled) {
+        onSend();
+      }
+    }
+  }, [userInput, disabled, onSend]);
+
+  const handleExpandClick = useCallback(() => {
+    setExpanded(true);
+  }, []);
+
+  const handleCollapse = useCallback(() => {
+    setExpanded(false);
+    // 折叠后聚焦回主输入框
+    setTimeout(() => {
+      textAreaRef.current?.focus();
+    }, 100);
+  }, []);
+
+  const handleModalSend = useCallback(() => {
+    if (userInput.trim() && !disabled) {
+      onSend();
+      setExpanded(false);
+    }
+  }, [userInput, disabled, onSend]);
+
+  // 展开时聚焦 Modal 内的 TextArea
+  useEffect(() => {
+    if (expanded) {
+      setTimeout(() => {
+        modalTextAreaRef.current?.focus();
+        // 将光标移到末尾
+        const len = userInput.length;
+        modalTextAreaRef.current?.setSelectionRange(len, len);
+      }, 100);
+    }
+  }, [expanded, userInput]);
+
+  const handleModalKeyDown = useCallback((e: React.KeyboardEvent<HTMLTextAreaElement>) => {
+    // Shift + Enter: 在展开模式下输入换行
+    if (e.shiftKey && e.key === 'Enter') {
+      // 默认行为，输入换行
+      return;
+    }
+    // Ctrl/Cmd + Enter: 发送消息
+    if ((e.ctrlKey || e.metaKey) && e.key === 'Enter') {
+      e.preventDefault();
+      if (userInput.trim() && !disabled) {
+        onSend();
+        setExpanded(false);
+      }
+    }
+    // Escape: 关闭展开模式
+    if (e.key === 'Escape') {
+      e.preventDefault();
+      setExpanded(false);
+    }
+  }, [userInput, disabled, onSend]);
+
+  const renderInputWithExpand = (placeholder: string) => (
+    <div style={{ display: 'flex', gap: '8px', alignItems: 'flex-end' }}>
+      <TextArea
+        ref={textAreaRef}
+        value={userInput}
+        onChange={handleInputChange}
+        onKeyDown={handleKeyDown}
+        placeholder={placeholder}
+        disabled={disabled}
+        autoSize={{ minRows: 1, maxRows: 4 }}
+        style={{ resize: 'none' }}
+      />
+      <Button
+        icon={<ExpandOutlined />}
+        onClick={handleExpandClick}
+        title="展开输入框 (Shift + Enter)"
+        style={{ flexShrink: 0 }}
+      />
+    </div>
+  );
+
   if (mode === 'pm_agent') {
     return (
-      <div style={{ display: 'flex', gap: '8px' }}>
-        <Input
-          value={userInput}
-          onChange={handleInputChange}
-          onPressEnter={onSend}
-          placeholder="Ask about the project or request changes..."
-          disabled={disabled}
-        />
-        <Button onClick={onSend} type="primary" disabled={!userInput.trim() || disabled}>
-          Send
-        </Button>
-        <Button onClick={onDumpChat} icon={<CopyOutlined />} title="Copy chat to clipboard">
-          Dump
-        </Button>
-      </div>
+      <>
+        <div style={{ display: 'flex', gap: '8px', alignItems: 'flex-end' }}>
+          <div style={{ flex: 1 }}>
+            {renderInputWithExpand('Ask about the project or request changes...')}
+          </div>
+          <Button onClick={onSend} type="primary" disabled={!userInput.trim() || disabled}>
+            Send
+          </Button>
+          <Button onClick={onDumpChat} icon={<CopyOutlined />} title="Copy chat to clipboard">
+            Dump
+          </Button>
+        </div>
+
+        <Modal
+          open={expanded}
+          onCancel={handleCollapse}
+          title={
+            <span>
+              <CompressOutlined style={{ marginRight: 8 }} />
+              展开输入
+            </span>
+          }
+          width={700}
+          footer={[
+            <Button key="dump" onClick={onDumpChat} icon={<CopyOutlined />}>
+              Dump
+            </Button>,
+            <Button key="cancel" onClick={handleCollapse}>
+              取消
+            </Button>,
+            <Button key="send" type="primary" onClick={handleModalSend} disabled={!userInput.trim() || disabled}>
+              发送 (Ctrl+Enter)
+            </Button>,
+          ]}
+          styles={{
+            body: { padding: '16px' },
+          }}
+        >
+          <TextArea
+            ref={modalTextAreaRef}
+            value={userInput}
+            onChange={handleInputChange}
+            onKeyDown={handleModalKeyDown}
+            placeholder="输入内容，按 Ctrl+Enter 发送，按 Escape 关闭..."
+            disabled={disabled}
+            autoSize={{ minRows: 8, maxRows: 20 }}
+            style={{ resize: 'none' }}
+          />
+          <div style={{ marginTop: 8, color: '#888', fontSize: '12px' }}>
+            提示：Shift+Enter 换行，Ctrl+Enter 发送，Escape 关闭
+          </div>
+        </Modal>
+      </>
     );
   }
 
@@ -82,14 +215,10 @@ const InputAreaInner: React.FC<InputAreaProps> = ({
         </div>
       )}
 
-      <div style={{ display: 'flex', gap: '8px' }}>
-        <Input
-          value={userInput}
-          onChange={handleInputChange}
-          onPressEnter={onSend}
-          placeholder={inputRequest ? 'Type your response...' : 'Type a message...'}
-          disabled={disabled && !inputRequest}
-        />
+      <div style={{ display: 'flex', gap: '8px', alignItems: 'flex-end' }}>
+        <div style={{ flex: 1 }}>
+          {renderInputWithExpand(inputRequest ? 'Type your response...' : 'Type a message...')}
+        </div>
         {inputRequest ? (
           <Button onClick={onSubmitFeedback} type="primary" disabled={!userInput.trim()}>
             Send Feedback
@@ -106,8 +235,54 @@ const InputAreaInner: React.FC<InputAreaProps> = ({
           <Button onClick={onCancelFeedback}>Cancel</Button>
         )}
       </div>
+
+      <Modal
+        open={expanded}
+        onCancel={handleCollapse}
+        title={
+          <span>
+            <CompressOutlined style={{ marginRight: 8 }} />
+            展开输入
+          </span>
+        }
+        width={700}
+        footer={[
+          <Button key="dump" onClick={onDumpChat} icon={<CopyOutlined />}>
+            Dump
+          </Button>,
+          <Button key="cancel" onClick={handleCollapse}>
+            取消
+          </Button>,
+          inputRequest ? (
+            <Button key="send" type="primary" onClick={() => { onSubmitFeedback(); setExpanded(false); }} disabled={!userInput.trim()}>
+              Send Feedback
+            </Button>
+          ) : (
+            <Button key="send" type="primary" onClick={handleModalSend} disabled={!userInput.trim()}>
+              发送 (Ctrl+Enter)
+            </Button>
+          ),
+        ]}
+        styles={{
+          body: { padding: '16px' },
+        }}
+      >
+        <TextArea
+          ref={modalTextAreaRef}
+          value={userInput}
+          onChange={handleInputChange}
+          onKeyDown={handleModalKeyDown}
+          placeholder={inputRequest ? 'Type your response...' : '输入内容，按 Ctrl+Enter 发送，按 Escape 关闭...'}
+          disabled={disabled && !inputRequest}
+          autoSize={{ minRows: 8, maxRows: 20 }}
+          style={{ resize: 'none' }}
+        />
+        <div style={{ marginTop: 8, color: '#888', fontSize: '12px' }}>
+          提示：Shift+Enter 换行，Ctrl+Enter 发送，Escape 关闭
+        </div>
+      </Modal>
     </>
   );
 };
 
-export const InputArea = memo(InputAreaInner);
+export const InputArea = memo(InputAreaInner);
\ No newline at end of file

From 6668aa78d03a6bfbf8ca947a338c1a97f0702edf Mon Sep 17 00:00:00 2001
From: Sopaco <dokhell@hotmail.com>
Date: Mon, 30 Mar 2026 15:45:01 +0800
Subject: [PATCH 3/7] Handle IME composition in chat input

---
 .../src/components/chat/InputArea.tsx         | 47 +++++++++++++++++++
 1 file changed, 47 insertions(+)

diff --git a/crates/cowork-gui/src/components/chat/InputArea.tsx b/crates/cowork-gui/src/components/chat/InputArea.tsx
index b409651..571b405 100644
--- a/crates/cowork-gui/src/components/chat/InputArea.tsx
+++ b/crates/cowork-gui/src/components/chat/InputArea.tsx
@@ -33,12 +33,41 @@ const InputAreaInner: React.FC<InputAreaProps> = ({
   const [expanded, setExpanded] = useState(false);
   const textAreaRef = useRef<HTMLTextAreaElement>(null);
   const modalTextAreaRef = useRef<HTMLTextAreaElement>(null);
+  // 跟踪 IME 输入法组合状态，用于中文输入法等场景
+  const isComposingRef = useRef(false);
+  // 记录 compositionend 触发的时间，用于防止在 IME 刚结束时误触发发送
+  const compositionEndTimeRef = useRef(0);
 
   const handleInputChange = useCallback((e: React.ChangeEvent<HTMLTextAreaElement>) => {
     onUserInputChange(e.target.value);
   }, [onUserInputChange]);
 
+  const handleCompositionStart = useCallback(() => {
+    isComposingRef.current = true;
+  }, []);
+
+  const handleCompositionEnd = useCallback(() => {
+    // 延迟设置状态，防止在同一个事件循环中被 keydown 误判
+    compositionEndTimeRef.current = Date.now();
+    // 使用 setTimeout 确保在当前事件循环之后再重置状态
+    setTimeout(() => {
+      isComposingRef.current = false;
+    }, 0);
+  }, []);
+
   const handleKeyDown = useCallback((e: React.KeyboardEvent<HTMLTextAreaElement>) => {
+    // 检查原生事件的 isComposing 属性，这是最可靠的 IME 检测方式
+    if (e.nativeEvent.isComposing) {
+      return;
+    }
+    // 如果刚刚结束 composition（50ms 内），也跳过，防止 IME 确认时误触发发送
+    if (Date.now() - compositionEndTimeRef.current < 50) {
+      return;
+    }
+    // 如果正在使用输入法组合输入（如中文输入法），不处理快捷键
+    if (isComposingRef.current) {
+      return;
+    }
     // Shift + Enter: 展开输入框
     if (e.shiftKey && e.key === 'Enter') {
       e.preventDefault();
@@ -86,6 +115,18 @@ const InputAreaInner: React.FC<InputAreaProps> = ({
   }, [expanded, userInput]);
 
   const handleModalKeyDown = useCallback((e: React.KeyboardEvent<HTMLTextAreaElement>) => {
+    // 检查原生事件的 isComposing 属性，这是最可靠的 IME 检测方式
+    if (e.nativeEvent.isComposing) {
+      return;
+    }
+    // 如果刚刚结束 composition（50ms 内），也跳过，防止 IME 确认时误触发发送
+    if (Date.now() - compositionEndTimeRef.current < 50) {
+      return;
+    }
+    // 如果正在使用输入法组合输入（如中文输入法），不处理快捷键
+    if (isComposingRef.current) {
+      return;
+    }
     // Shift + Enter: 在展开模式下输入换行
     if (e.shiftKey && e.key === 'Enter') {
       // 默认行为，输入换行
@@ -113,6 +154,8 @@ const InputAreaInner: React.FC<InputAreaProps> = ({
         value={userInput}
         onChange={handleInputChange}
         onKeyDown={handleKeyDown}
+        onCompositionStart={handleCompositionStart}
+        onCompositionEnd={handleCompositionEnd}
         placeholder={placeholder}
         disabled={disabled}
         autoSize={{ minRows: 1, maxRows: 4 }}
@@ -172,6 +215,8 @@ const InputAreaInner: React.FC<InputAreaProps> = ({
             value={userInput}
             onChange={handleInputChange}
             onKeyDown={handleModalKeyDown}
+            onCompositionStart={handleCompositionStart}
+            onCompositionEnd={handleCompositionEnd}
             placeholder="输入内容，按 Ctrl+Enter 发送，按 Escape 关闭..."
             disabled={disabled}
             autoSize={{ minRows: 8, maxRows: 20 }}
@@ -272,6 +317,8 @@ const InputAreaInner: React.FC<InputAreaProps> = ({
           value={userInput}
           onChange={handleInputChange}
           onKeyDown={handleModalKeyDown}
+          onCompositionStart={handleCompositionStart}
+          onCompositionEnd={handleCompositionEnd}
           placeholder={inputRequest ? 'Type your response...' : '输入内容，按 Ctrl+Enter 发送，按 Escape 关闭...'}
           disabled={disabled && !inputRequest}
           autoSize={{ minRows: 8, maxRows: 20 }}

From 4ca42078978a2d621dc7a8cdd42cbf547e0a6eb7 Mon Sep 17 00:00:00 2001
From: Sopaco <dokhell@hotmail.com>
Date: Tue, 31 Mar 2026 18:55:41 +0800
Subject: [PATCH 4/7] Add file tools to built-in agents and expose tool catalog
 to GUI

- Added `list_files`, `read_file`, and `read_file_truncated` to built-in
  agent configs (delivery, idea, pm, prd_actor, prd_critic, summary)
- Implemented `gui_get_available_tools` Tauri command with full tool
  catalog
- Added `ToolInfo` type to frontend and integrated into config store
- Updated `AgentConfigForm` to load and display available tools by
  category
---
 .../agents/built-in/delivery_agent.json       |   3 +
 .../agents/built-in/idea_agent.json           |   6 +
 .../agents/built-in/pm_agent.json             |   6 +
 .../agents/built-in/prd_actor.json            |   9 +
 .../agents/built-in/prd_critic.json           |   9 +
 .../agents/built-in/summary_agent.json        |   6 +
 .../src-tauri/src/config_commands.rs          | 310 ++++++++++++++++++
 crates/cowork-gui/src-tauri/src/lib.rs        |   1 +
 .../src/components/config/AgentConfigForm.tsx |  39 ++-
 crates/cowork-gui/src/stores/configStore.ts   |  32 ++
 crates/cowork-gui/src/types/config.ts         |   8 +
 11 files changed, 417 insertions(+), 12 deletions(-)

diff --git a/crates/cowork-core/src/config_definition/default_configs/agents/built-in/delivery_agent.json b/crates/cowork-core/src/config_definition/default_configs/agents/built-in/delivery_agent.json
index 7aef7e2..cea4643 100644
--- a/crates/cowork-core/src/config_definition/default_configs/agents/built-in/delivery_agent.json
+++ b/crates/cowork-core/src/config_definition/default_configs/agents/built-in/delivery_agent.json
@@ -15,6 +15,9 @@
     {
       "tool_id": "list_files"
     },
+    {
+      "tool_id": "read_file_truncated"
+    },
     {
       "tool_id": "save_delivery_report"
     },
diff --git a/crates/cowork-core/src/config_definition/default_configs/agents/built-in/idea_agent.json b/crates/cowork-core/src/config_definition/default_configs/agents/built-in/idea_agent.json
index 4b6ce9a..6eac580 100644
--- a/crates/cowork-core/src/config_definition/default_configs/agents/built-in/idea_agent.json
+++ b/crates/cowork-core/src/config_definition/default_configs/agents/built-in/idea_agent.json
@@ -9,6 +9,12 @@
     {
       "tool_id": "save_idea"
     },
+    {
+      "tool_id": "read_file"
+    },
+    {
+      "tool_id": "list_files"
+    },
     {
       "tool_id": "query_memory"
     },
diff --git a/crates/cowork-core/src/config_definition/default_configs/agents/built-in/pm_agent.json b/crates/cowork-core/src/config_definition/default_configs/agents/built-in/pm_agent.json
index ece2963..8acfd12 100644
--- a/crates/cowork-core/src/config_definition/default_configs/agents/built-in/pm_agent.json
+++ b/crates/cowork-core/src/config_definition/default_configs/agents/built-in/pm_agent.json
@@ -21,6 +21,12 @@
     {
       "tool_id": "read_file"
     },
+    {
+      "tool_id": "list_files"
+    },
+    {
+      "tool_id": "read_file_truncated"
+    },
     {
       "tool_id": "query_memory"
     }
diff --git a/crates/cowork-core/src/config_definition/default_configs/agents/built-in/prd_actor.json b/crates/cowork-core/src/config_definition/default_configs/agents/built-in/prd_actor.json
index 8fd0848..fff0002 100644
--- a/crates/cowork-core/src/config_definition/default_configs/agents/built-in/prd_actor.json
+++ b/crates/cowork-core/src/config_definition/default_configs/agents/built-in/prd_actor.json
@@ -33,6 +33,15 @@
     {
       "tool_id": "save_prd_doc"
     },
+    {
+      "tool_id": "read_file"
+    },
+    {
+      "tool_id": "list_files"
+    },
+    {
+      "tool_id": "read_file_truncated"
+    },
     {
       "tool_id": "query_memory"
     },
diff --git a/crates/cowork-core/src/config_definition/default_configs/agents/built-in/prd_critic.json b/crates/cowork-core/src/config_definition/default_configs/agents/built-in/prd_critic.json
index a33b531..b55ba8c 100644
--- a/crates/cowork-core/src/config_definition/default_configs/agents/built-in/prd_critic.json
+++ b/crates/cowork-core/src/config_definition/default_configs/agents/built-in/prd_critic.json
@@ -15,6 +15,15 @@
     {
       "tool_id": "provide_feedback"
     },
+    {
+      "tool_id": "read_file"
+    },
+    {
+      "tool_id": "list_files"
+    },
+    {
+      "tool_id": "read_file_truncated"
+    },
     {
       "tool_id": "query_memory"
     },
diff --git a/crates/cowork-core/src/config_definition/default_configs/agents/built-in/summary_agent.json b/crates/cowork-core/src/config_definition/default_configs/agents/built-in/summary_agent.json
index 130ed51..e94e4de 100644
--- a/crates/cowork-core/src/config_definition/default_configs/agents/built-in/summary_agent.json
+++ b/crates/cowork-core/src/config_definition/default_configs/agents/built-in/summary_agent.json
@@ -11,6 +11,12 @@
     },
     {
       "tool_id": "write_file"
+    },
+    {
+      "tool_id": "list_files"
+    },
+    {
+      "tool_id": "read_file_truncated"
     }
   ],
   "model": {
diff --git a/crates/cowork-gui/src-tauri/src/config_commands.rs b/crates/cowork-gui/src-tauri/src/config_commands.rs
index 65ecd06..976c5ee 100644
--- a/crates/cowork-gui/src-tauri/src/config_commands.rs
+++ b/crates/cowork-gui/src-tauri/src/config_commands.rs
@@ -699,3 +699,313 @@ fn open_folder_in_explorer(path: &std::path::Path) -> Result<(), String> {
 
     Ok(())
 }
+
+/// Tool info for frontend display
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct ToolInfo {
+    pub id: String,
+    pub name: String,
+    pub category: String,
+    pub description: String,
+}
+
+/// Get all available tools that can be assigned to agents
+#[tauri::command]
+pub async fn gui_get_available_tools() -> Result<Vec<ToolInfo>, String> {
+    // This list should match the tools supported in agent_factory.rs
+    let tools = vec![
+        // Idea tools
+        ToolInfo {
+            id: "save_idea".to_string(),
+            name: "Save Idea".to_string(),
+            category: "Idea".to_string(),
+            description: "Save the initial project idea document".to_string(),
+        },
+        
+        // Data tools
+        ToolInfo {
+            id: "create_requirement".to_string(),
+            name: "Create Requirement".to_string(),
+            category: "Data".to_string(),
+            description: "Create a new requirement".to_string(),
+        },
+        ToolInfo {
+            id: "update_requirement".to_string(),
+            name: "Update Requirement".to_string(),
+            category: "Data".to_string(),
+            description: "Update an existing requirement".to_string(),
+        },
+        ToolInfo {
+            id: "delete_requirement".to_string(),
+            name: "Delete Requirement".to_string(),
+            category: "Data".to_string(),
+            description: "Delete a requirement".to_string(),
+        },
+        ToolInfo {
+            id: "get_requirements".to_string(),
+            name: "Get Requirements".to_string(),
+            category: "Data".to_string(),
+            description: "Retrieve all requirements".to_string(),
+        },
+        ToolInfo {
+            id: "add_feature".to_string(),
+            name: "Add Feature".to_string(),
+            category: "Data".to_string(),
+            description: "Add a feature to a requirement".to_string(),
+        },
+        ToolInfo {
+            id: "update_feature".to_string(),
+            name: "Update Feature".to_string(),
+            category: "Data".to_string(),
+            description: "Update an existing feature".to_string(),
+        },
+        ToolInfo {
+            id: "create_task".to_string(),
+            name: "Create Task".to_string(),
+            category: "Data".to_string(),
+            description: "Create a new task in the plan".to_string(),
+        },
+        ToolInfo {
+            id: "update_task_status".to_string(),
+            name: "Update Task Status".to_string(),
+            category: "Data".to_string(),
+            description: "Update the status of a task".to_string(),
+        },
+        ToolInfo {
+            id: "get_design".to_string(),
+            name: "Get Design".to_string(),
+            category: "Data".to_string(),
+            description: "Retrieve the current design specification".to_string(),
+        },
+        ToolInfo {
+            id: "get_implementation_plan".to_string(),
+            name: "Get Implementation Plan".to_string(),
+            category: "Data".to_string(),
+            description: "Retrieve the implementation plan (alias: get_plan)".to_string(),
+        },
+        
+        // File tools
+        ToolInfo {
+            id: "read_file".to_string(),
+            name: "Read File".to_string(),
+            category: "File".to_string(),
+            description: "Read the contents of a file in the workspace".to_string(),
+        },
+        ToolInfo {
+            id: "write_file".to_string(),
+            name: "Write File".to_string(),
+            category: "File".to_string(),
+            description: "Write content to a file in the workspace".to_string(),
+        },
+        ToolInfo {
+            id: "list_files".to_string(),
+            name: "List Files".to_string(),
+            category: "File".to_string(),
+            description: "List files in a directory within the workspace".to_string(),
+        },
+        ToolInfo {
+            id: "run_command".to_string(),
+            name: "Run Command".to_string(),
+            category: "File".to_string(),
+            description: "Execute a shell command in the workspace".to_string(),
+        },
+        ToolInfo {
+            id: "read_file_truncated".to_string(),
+            name: "Read File Truncated".to_string(),
+            category: "File".to_string(),
+            description: "Read a file with intelligent truncation for large files".to_string(),
+        },
+        
+        // Document tools (Project Iteration Files)
+        ToolInfo {
+            id: "load_idea".to_string(),
+            name: "Load Idea".to_string(),
+            category: "Document".to_string(),
+            description: "Load the idea document from current iteration".to_string(),
+        },
+        ToolInfo {
+            id: "load_prd_doc".to_string(),
+            name: "Load PRD Doc".to_string(),
+            category: "Document".to_string(),
+            description: "Load the PRD document from current iteration".to_string(),
+        },
+        ToolInfo {
+            id: "load_design_doc".to_string(),
+            name: "Load Design Doc".to_string(),
+            category: "Document".to_string(),
+            description: "Load the design document from current iteration".to_string(),
+        },
+        ToolInfo {
+            id: "load_plan_doc".to_string(),
+            name: "Load Plan Doc".to_string(),
+            category: "Document".to_string(),
+            description: "Load the implementation plan document from current iteration".to_string(),
+        },
+        ToolInfo {
+            id: "save_prd_doc".to_string(),
+            name: "Save PRD Doc".to_string(),
+            category: "Document".to_string(),
+            description: "Save the PRD document to the artifacts directory".to_string(),
+        },
+        ToolInfo {
+            id: "save_design_doc".to_string(),
+            name: "Save Design Doc".to_string(),
+            category: "Document".to_string(),
+            description: "Save the design document to the artifacts directory".to_string(),
+        },
+        ToolInfo {
+            id: "save_plan_doc".to_string(),
+            name: "Save Plan Doc".to_string(),
+            category: "Document".to_string(),
+            description: "Save the implementation plan document to the artifacts directory".to_string(),
+        },
+        ToolInfo {
+            id: "save_delivery_report".to_string(),
+            name: "Save Delivery Report".to_string(),
+            category: "Document".to_string(),
+            description: "Save the delivery report to the artifacts directory".to_string(),
+        },
+        ToolInfo {
+            id: "save_check_report".to_string(),
+            name: "Save Check Report".to_string(),
+            category: "Document".to_string(),
+            description: "Save the check report to the artifacts directory".to_string(),
+        },
+        
+        // Design tools
+        ToolInfo {
+            id: "create_design_component".to_string(),
+            name: "Create Design Component".to_string(),
+            category: "Design".to_string(),
+            description: "Create a new design component".to_string(),
+        },
+        
+        // Validation tools
+        ToolInfo {
+            id: "check_feature_coverage".to_string(),
+            name: "Check Feature Coverage".to_string(),
+            category: "Validation".to_string(),
+            description: "Validate that all features are covered in the design".to_string(),
+        },
+        ToolInfo {
+            id: "check_task_dependencies".to_string(),
+            name: "Check Task Dependencies".to_string(),
+            category: "Validation".to_string(),
+            description: "Validate task dependencies in the plan".to_string(),
+        },
+        ToolInfo {
+            id: "check_tests".to_string(),
+            name: "Check Tests".to_string(),
+            category: "Validation".to_string(),
+            description: "Run tests in the workspace".to_string(),
+        },
+        ToolInfo {
+            id: "check_lint".to_string(),
+            name: "Check Lint".to_string(),
+            category: "Validation".to_string(),
+            description: "Run linting in the workspace".to_string(),
+        },
+        ToolInfo {
+            id: "check_data_format".to_string(),
+            name: "Check Data Format".to_string(),
+            category: "Validation".to_string(),
+            description: "Validate data format consistency".to_string(),
+        },
+        
+        // HITL tools
+        ToolInfo {
+            id: "provide_feedback".to_string(),
+            name: "Provide Feedback".to_string(),
+            category: "HITL".to_string(),
+            description: "Provide feedback to the user for review".to_string(),
+        },
+        ToolInfo {
+            id: "load_feedback_history".to_string(),
+            name: "Load Feedback History".to_string(),
+            category: "HITL".to_string(),
+            description: "Load history of feedback from previous iterations".to_string(),
+        },
+        
+        // Memory tools
+        ToolInfo {
+            id: "query_memory".to_string(),
+            name: "Query Memory".to_string(),
+            category: "Memory".to_string(),
+            description: "Query the project memory for relevant context".to_string(),
+        },
+        ToolInfo {
+            id: "save_insight".to_string(),
+            name: "Save Insight".to_string(),
+            category: "Memory".to_string(),
+            description: "Save an insight to the iteration memory".to_string(),
+        },
+        ToolInfo {
+            id: "save_issue".to_string(),
+            name: "Save Issue".to_string(),
+            category: "Memory".to_string(),
+            description: "Save an issue to the iteration memory".to_string(),
+        },
+        ToolInfo {
+            id: "save_learning".to_string(),
+            name: "Save Learning".to_string(),
+            category: "Memory".to_string(),
+            description: "Save a learning to the iteration memory".to_string(),
+        },
+        ToolInfo {
+            id: "promote_to_decision".to_string(),
+            name: "Promote to Decision".to_string(),
+            category: "Memory".to_string(),
+            description: "Promote an insight to a project-level decision".to_string(),
+        },
+        ToolInfo {
+            id: "promote_to_pattern".to_string(),
+            name: "Promote to Pattern".to_string(),
+            category: "Memory".to_string(),
+            description: "Promote a learning to a project-level pattern".to_string(),
+        },
+        
+        // Deployment tools
+        ToolInfo {
+            id: "copy_workspace_to_project".to_string(),
+            name: "Copy Workspace to Project".to_string(),
+            category: "Deployment".to_string(),
+            description: "Copy generated workspace files to the project directory".to_string(),
+        },
+        
+        // Flow control tools
+        ToolInfo {
+            id: "goto_stage".to_string(),
+            name: "Goto Stage".to_string(),
+            category: "Flow Control".to_string(),
+            description: "Jump to a specific stage in the flow".to_string(),
+        },
+        
+        // PM tools
+        ToolInfo {
+            id: "pm_goto_stage".to_string(),
+            name: "PM Goto Stage".to_string(),
+            category: "PM".to_string(),
+            description: "PM agent: Jump to a specific stage".to_string(),
+        },
+        ToolInfo {
+            id: "pm_create_iteration".to_string(),
+            name: "PM Create Iteration".to_string(),
+            category: "PM".to_string(),
+            description: "PM agent: Create a new iteration".to_string(),
+        },
+        ToolInfo {
+            id: "pm_respond".to_string(),
+            name: "PM Respond".to_string(),
+            category: "PM".to_string(),
+            description: "PM agent: Respond to user".to_string(),
+        },
+        ToolInfo {
+            id: "pm_save_decision".to_string(),
+            name: "PM Save Decision".to_string(),
+            category: "PM".to_string(),
+            description: "PM agent: Save a decision to memory".to_string(),
+        },
+    ];
+    
+    Ok(tools)
+}
diff --git a/crates/cowork-gui/src-tauri/src/lib.rs b/crates/cowork-gui/src-tauri/src/lib.rs
index 9a0cbd3..ed074d5 100644
--- a/crates/cowork-gui/src-tauri/src/lib.rs
+++ b/crates/cowork-gui/src-tauri/src/lib.rs
@@ -835,6 +835,7 @@ pub fn run() {
             config_commands::gui_export_config,
             config_commands::gui_import_config,
             config_commands::gui_get_builtin_instructions,
+            config_commands::gui_get_available_tools,
             // Project creation commands
             path_exists,
             create_project_at_path,
diff --git a/crates/cowork-gui/src/components/config/AgentConfigForm.tsx b/crates/cowork-gui/src/components/config/AgentConfigForm.tsx
index 7e6cd5f..41fb2c9 100644
--- a/crates/cowork-gui/src/components/config/AgentConfigForm.tsx
+++ b/crates/cowork-gui/src/components/config/AgentConfigForm.tsx
@@ -37,7 +37,7 @@ import {
   FolderOpenOutlined,
 } from '@ant-design/icons';
 import { useConfigStore } from '../../stores/configStore';
-import type { AgentDefinition, ToolReference, AgentType, ModelConfig, BuiltinInstruction, InstructionType } from '../../types/config';
+import type { AgentDefinition, ToolReference, AgentType, ModelConfig, BuiltinInstruction, InstructionType, ToolInfo } from '../../types/config';
 import { open } from '@tauri-apps/plugin-dialog';
 
 const { Title, Text, Paragraph } = Typography;
@@ -55,6 +55,9 @@ const AgentConfigForm: React.FC = () => {
     exportConfig,
     importConfig,
     getBuiltinInstructions,
+    availableTools,
+    loadAvailableTools,
+    getToolsByCategory,
   } = useConfigStore();
 
   const [editModalVisible, setEditModalVisible] = useState(false);
@@ -74,7 +77,8 @@ const AgentConfigForm: React.FC = () => {
   // Load builtin instructions on mount
   useEffect(() => {
     getBuiltinInstructions().then(setBuiltinInstructions);
-  }, [getBuiltinInstructions]);
+    loadAvailableTools();  // Load available tools from backend
+  }, [getBuiltinInstructions, loadAvailableTools]);
 
   const handleCreate = () => {
     setEditingAgent(null);
@@ -300,13 +304,6 @@ const AgentConfigForm: React.FC = () => {
     }
   };
 
-  const availableTools = [
-    'read_file', 'write_file', 'edit_file', 'delete_file',
-    'execute_command', 'search_file', 'search_content',
-    'list_dir', 'create_dir', 'move_file', 'copy_file',
-    'query_memory', 'save_memory', 'web_search', 'web_fetch',
-  ];
-
   const availableSkills = Object.keys(skills);
 
   return (
@@ -586,9 +583,27 @@ const AgentConfigForm: React.FC = () => {
                 children: (
                   <>
                     <Form.Item name="tools" label="Available Tools">
-                      <Select mode="multiple" placeholder="Select tools">
-                        {availableTools.map(tool => (
-                          <Select.Option key={tool} value={tool}>{tool}</Select.Option>
+                      <Select 
+                        mode="multiple" 
+                        placeholder="Select tools"
+                        optionFilterProp="label"
+                        showSearch
+                        listHeight={400}
+                      >
+                        {Object.entries(getToolsByCategory()).map(([category, tools]) => (
+                          <Select.OptGroup key={category} label={category}>
+                            {tools.map(tool => (
+                              <Select.Option 
+                                key={tool.id} 
+                                value={tool.id}
+                                label={tool.name}
+                              >
+                                <Tooltip title={tool.description}>
+                                  <span>{tool.name}</span>
+                                </Tooltip>
+                              </Select.Option>
+                            ))}
+                          </Select.OptGroup>
                         ))}
                       </Select>
                     </Form.Item>
diff --git a/crates/cowork-gui/src/stores/configStore.ts b/crates/cowork-gui/src/stores/configStore.ts
index be45b47..da38b75 100644
--- a/crates/cowork-gui/src/stores/configStore.ts
+++ b/crates/cowork-gui/src/stores/configStore.ts
@@ -9,6 +9,7 @@ import type {
   ConfigRegistryState,
   ValidationResult,
   BuiltinInstruction,
+  ToolInfo,
 } from '../types/config';
 
 interface ConfigState extends ConfigRegistryState {
@@ -19,6 +20,7 @@ interface ConfigState extends ConfigRegistryState {
   selectedStage: string | null;
   selectedSkill: string | null;  // skill name
   selectedIntegration: string | null;
+  availableTools: ToolInfo[];  // Available tools for agent configuration
 
   // Actions
   loadConfigs: () => Promise<void>;
@@ -52,6 +54,10 @@ interface ConfigState extends ConfigRegistryState {
 
   // Builtin Instructions
   getBuiltinInstructions: () => Promise<BuiltinInstruction[]>;
+  
+  // Available Tools
+  loadAvailableTools: () => Promise<void>;
+  getToolsByCategory: () => Record<string, ToolInfo[]>;
 }
 
 export const useConfigStore = create<ConfigState>((set, get) => ({
@@ -69,6 +75,7 @@ export const useConfigStore = create<ConfigState>((set, get) => ({
   selectedStage: null,
   selectedSkill: null,
   selectedIntegration: null,
+  availableTools: [],
 
   // Load all configs from backend
   loadConfigs: async () => {
@@ -302,4 +309,29 @@ export const useConfigStore = create<ConfigState>((set, get) => ({
       return [];
     }
   },
+  
+  // Load available tools from backend
+  loadAvailableTools: async () => {
+    try {
+      const tools = await invoke<ToolInfo[]>('gui_get_available_tools');
+      set({ availableTools: tools });
+    } catch (error) {
+      set({ error: error instanceof Error ? error.message : 'Failed to load available tools' });
+    }
+  },
+  
+  // Get tools grouped by category
+  getToolsByCategory: () => {
+    const tools = get().availableTools;
+    const grouped: Record<string, ToolInfo[]> = {};
+    
+    for (const tool of tools) {
+      if (!grouped[tool.category]) {
+        grouped[tool.category] = [];
+      }
+      grouped[tool.category].push(tool);
+    }
+    
+    return grouped;
+  },
 }));
diff --git a/crates/cowork-gui/src/types/config.ts b/crates/cowork-gui/src/types/config.ts
index a311b42..3b50450 100644
--- a/crates/cowork-gui/src/types/config.ts
+++ b/crates/cowork-gui/src/types/config.ts
@@ -234,3 +234,11 @@ export interface BuiltinInstruction {
 
 // Instruction type for form
 export type InstructionType = "builtin" | "file" | "inline";
+
+// Tool Info for agent configuration
+export interface ToolInfo {
+  id: string;
+  name: string;
+  category: string;
+  description: string;
+}

From 77720a9bd2b1b9dcff29f875538169f605c08acd Mon Sep 17 00:00:00 2001
From: Sopaco <dokhell@hotmail.com>
Date: Tue, 31 Mar 2026 19:07:39 +0800
Subject: [PATCH 5/7] docs update

---
 .../4.Deep-Exploration/GUI Backend Domain.md  |  6 ++-
 .../en/4.Deep-Exploration/Tools Domain.md     | 41 +++++++++++++------
 ...45\345\205\267\347\263\273\347\273\237.md" | 31 ++++++++++----
 ...\201Cowork GUI\345\220\216\347\253\257.md" | 34 ++++++++++++++-
 4 files changed, 87 insertions(+), 25 deletions(-)

diff --git a/litho.docs/en/4.Deep-Exploration/GUI Backend Domain.md b/litho.docs/en/4.Deep-Exploration/GUI Backend Domain.md
index 411c98b..d96c275 100644
--- a/litho.docs/en/4.Deep-Exploration/GUI Backend Domain.md	
+++ b/litho.docs/en/4.Deep-Exploration/GUI Backend Domain.md	
@@ -14,7 +14,7 @@ The **GUI Backend Domain** serves as the infrastructure bridge between the React
 The domain implements the **Adapter** pattern within the Hexagonal Architecture, adapting the core domain's `InteractiveBackend` trait to Tauri's event-driven desktop runtime. It maintains strict separation between presentation concerns (React frontend) and business logic (cowork-core), ensuring the core domain remains agnostic of GUI-specific implementation details.
 
 **Key Responsibilities:**
-- **Command Handling**: Expose 24+ JSON-RPC endpoints for frontend invocation
+- **Command Handling**: Expose 25+ JSON-RPC endpoints for frontend invocation
 - **Event Streaming**: Real-time bidirectional communication via Tauri's event emission system
 - **Process Management**: Cross-platform development server lifecycle management
 - **State Bridging**: Thread-safe shared state management between async tasks and UI thread
@@ -84,7 +84,9 @@ The command handlers serve as the API surface for the React frontend, implementi
 | `start_iteration_preview` | ProcessRunner activation | Child process management |
 | `pm_send_message` | Project Manager Agent message processing | Context-aware with history |
 | `pm_restart_iteration` | Re-execute from specified stage | Pipeline jump |
-| `get_system_locale` | Get system language setting | Synchronous return |
+| `get_system_locale` |
+| `gui_get_available_tools` | Get available tools list | Tool ID, name, category, description |
+| `gui_reset_config_registry` | Reset config registry | All built-in configs | Get system language setting | Synchronous return |
 
 **Implementation Pattern:**
 ```rust
diff --git a/litho.docs/en/4.Deep-Exploration/Tools Domain.md b/litho.docs/en/4.Deep-Exploration/Tools Domain.md
index a3c9903..c90cdfc 100644
--- a/litho.docs/en/4.Deep-Exploration/Tools Domain.md	
+++ b/litho.docs/en/4.Deep-Exploration/Tools Domain.md	
@@ -10,7 +10,7 @@
 
 ## 1. Executive Overview
 
-The **Tools Domain** provides the comprehensive operational interface between AI agents and the host system within Cowork Forge. Acting as the execution layer for the 7-stage AI pipeline, this domain implements 30+ specialized tools adhering to the ADK (Agent Development Kit) `Tool` trait specification. These tools enable AI agents to perform secure file operations, manage structured project data, interact with human users through validation gates, query institutional memory, and execute deployment workflows.
+The **Tools Domain** provides the comprehensive operational interface between AI agents and the host system within Cowork Forge. Acting as the execution layer for the 7-stage AI pipeline, this domain implements 40+ specialized tools adhering to the ADK (Agent Development Kit) `Tool` trait specification. These tools enable AI agents to perform secure file operations, manage structured project data, interact with human users through validation gates, query institutional memory, and execute deployment workflows.
 
 **Key Architectural Value:**
 - **Security-First Design**: Enforces strict workspace containment with path traversal prevention and UNC path normalization
@@ -61,7 +61,7 @@ flowchart TB
 
 ## 3. Tool Taxonomy
 
-The domain organizes tools into eight functional categories, each addressing specific operational concerns within the AI-driven development lifecycle.
+The domain organizes tools into nine functional categories, each addressing specific operational concerns within the AI-driven development lifecycle.
 
 ### 3.1 File Tools (`file_tools.rs`)
 **Purpose**: Secure filesystem operations within workspace boundaries
@@ -72,7 +72,22 @@ The domain organizes tools into eight functional categories, each addressing spe
 - **WriteFileTool**: Atomic file writes with parent directory creation
 - **RunCommandTool**: Shell execution with 30-second timeout and blocking command detection (prevents interactive commands like `vim`)
 
-### 3.2 Data Tools (`data_tools.rs`)
+### 3.2 Document Tools (`load_artifacts.rs`, `artifact_tools.rs`)
+**Purpose**: Project iteration document loading and saving operations
+- **LoadIdeaTool**: Load the idea document from current iteration
+- **LoadPrdDocTool**: Load the PRD document from current iteration
+- **LoadDesignDocTool**: Load the design document from current iteration
+- **LoadPlanDocTool**: Load the implementation plan document from current iteration
+- **SavePrdDocTool**: Save PRD document to artifacts directory
+- **SaveDesignDocTool**: Save design document to artifacts directory
+- **SavePlanDocTool**: Save implementation plan document to artifacts directory
+- **SaveDeliveryReportTool**: Save delivery report to artifacts directory
+- **SaveCheckReportTool**: Save check report to artifacts directory
+- **SaveIdeaTool**: Save initial idea document
+
+> **Note**: Document tools enable all Agents to read project iteration files on-demand during task execution, understanding project context. These tools are now configured for all built-in Agents.
+
+### 3.3 Data Tools (`data_tools.rs`)
 **Purpose**: Structured data management for requirements, features, and tasks
 - **Requirements Management**: `CreateRequirementTool`, `GetRequirementsTool` (REQ-ID prefixed)
 - **Feature Management**: `AddFeatureTool`, `UpdateFeatureStatusTool`, `GetDesignDocumentTool` (FEAT-ID prefixed)
@@ -80,26 +95,26 @@ The domain organizes tools into eight functional categories, each addressing spe
 - **Component Management**: `AddComponentTool`, `GetImplementationPlanTool` (COMP-ID prefixed)
 - **Status Workflow**: Enforces valid state transitions and dependency tracking
 
-### 3.3 HITL Tools (`hitl_tools.rs`, `hitl_content_tools.rs`)
+### 3.4 HITL Tools (`hitl_tools.rs`, `hitl_content_tools.rs`)
 **Purpose**: Human-agent interaction for validation and refinement
 - **ReviewAndEditFileTool**: Binary workflow (pass/edit) for file review with external editor integration
 - **ReviewWithFeedbackFileTool**: Ternary workflow (pass/edit/feedback) enabling agent regeneration with human comments
 - **ReviewAndEditContentTool**: Content-level review for generated artifacts (PRD, Design docs)
 - **ReviewWithFeedbackContentTool**: Feedback-driven content refinement
 
-### 3.4 Validation Tools (`validation_tools.rs`)
+### 3.5 Validation Tools (`validation_tools.rs`)
 **Purpose**: Data integrity and consistency verification
 - **CheckDataFormatTool**: JSON Schema validation for structured data files
 - **CheckFeatureCoverageTool**: Bidirectional coverage analysis between features and requirements
 - **CheckTaskDependenciesTool**: Circular dependency detection using Depth-First Search (DFS) algorithm
 
-### 3.5 Deployment Tools (`deployment_tools.rs`)
+### 3.6 Deployment Tools (`deployment_tools.rs`)
 **Purpose**: Safe promotion of workspace artifacts to project root
 - **CopyWorkspaceToProjectTool**: Two-phase deployment strategy:
   - **Phase 1**: Orphaned file cleanup (removes files not in workspace, with protected paths: `.git/`, `config.toml`, `README.md`)
   - **Phase 2**: Extension-filtered copy (whitelist: `.html`, `.css`, `.js`, `.ts`, `.tsx`, `.json`, `.md`, images, fonts)
 
-### 3.6 Memory Tools (`memory_tools.rs`)
+### 3.7 Memory Tools (`memory_tools.rs`)
 **Purpose**: Knowledge persistence and retrieval across iterations
 - **QueryMemoryTool**: Fuzzy keyword search across three scopes (project, iteration, smart-merged)
 - **SaveInsightTool**: Capture iteration insights with categorization
@@ -108,7 +123,7 @@ The domain organizes tools into eight functional categories, each addressing spe
 - **PromoteToDecisionTool**: Elevate insights to architectural decisions
 - **PromoteToPatternTool**: Elevate insights to reusable design patterns
 
-### 3.7 PM Tools (`pm_tools.rs`)
+### 3.8 PM Tools (`pm_tools.rs`)
 **Purpose**: Project Manager Agent operational tools, supporting post-delivery user interaction
 - **PMGotoStageTool**: Allows user to return to previous stages (idea, prd, design, plan, coding) for re-execution
 - **PMCreateIterationTool**: Create new iteration for handling new requirements or modifications
@@ -117,25 +132,25 @@ The domain organizes tools into eight functional categories, each addressing spe
 
 > **Note**: PM tools are only available when iteration status is `Completed` (after Delivery stage), used for post-delivery project maintenance and requirement change scenarios.
 
-### 3.8 Test & Lint Tools (`test_lint_tools.rs`)
+### 3.9 Test & Lint Tools (`test_lint_tools.rs`)
 **Purpose**: Code quality verification and testing automation
 - **ExecuteShellCommandTool**: Run shell commands for testing and linting with timeout control
 
-### 3.9 Control Tools (`control_tools.rs`)
+### 3.10 Control Tools (`control_tools.rs`)
 **Purpose**: Pipeline flow control and stage management
 - **GotoStageTool**: Control flow for jumping to specific pipeline stages
 
-### 3.10 Artifact Tools (`artifact_tools.rs`)
+### 3.11 Artifact Tools (`artifact_tools.rs`)
 **Purpose**: Artifact loading and management
 - **LoadArtifactSummaryTool**: Load summaries of generated artifacts
 - **LoadArtifactTool**: Load full artifact content
 
-### 3.11 Load Artifacts Tools (`load_artifacts.rs`)
+### 3.12 Load Artifacts Tools (`load_artifacts.rs`)
 **Purpose**: Document and artifact loading utilities
 - **LoadDocumentSummaryTool**: Load compressed stage summaries (idea, PRD, design, plan)
 - **LoadBaseKnowledgeTool**: Load historical knowledge from base iterations
 
-### 3.12 Goto Stage Tool (`goto_stage_tool.rs`)
+### 3.13 Goto Stage Tool (`goto_stage_tool.rs`)
 **Purpose**: Stage navigation for PM Agent
 - **PMGotoStageTool**: Navigate to specific stages for re-execution
 
diff --git "a/litho.docs/zh/4\343\200\201\346\267\261\345\205\245\346\216\242\347\264\242/4.4\343\200\201Agent\345\267\245\345\205\267\347\263\273\347\273\237.md" "b/litho.docs/zh/4\343\200\201\346\267\261\345\205\245\346\216\242\347\264\242/4.4\343\200\201Agent\345\267\245\345\205\267\347\263\273\347\273\237.md"
index 5cc4545..237d1dc 100644
--- "a/litho.docs/zh/4\343\200\201\346\267\261\345\205\245\346\216\242\347\264\242/4.4\343\200\201Agent\345\267\245\345\205\267\347\263\273\347\273\237.md"
+++ "b/litho.docs/zh/4\343\200\201\346\267\261\345\205\245\346\216\242\347\264\242/4.4\343\200\201Agent\345\267\245\345\205\267\347\263\273\347\273\237.md"
@@ -61,9 +61,9 @@ flowchart TB
 
 ## 3. 工具分类
 
-该域将 30+ 工具组织为六个功能类别，每个类别解决 AI 驱动开发生命周期中的特定操作关注点。
+该域将 30+ 工具组织为八个功能类别，每个类别解决 AI 驱动开发生命周期中的特定操作关注点。
 
-### 3.1 文件工具（`file_tools.rs`）
+### 3.1 文件工具（`file_tools.rs`） - 已更新
 **目的**：工作区边界内的安全文件系统操作
 - **ListFilesTool**：带模式匹配的目录遍历（使用 `walkdir`）
 - **ReadFileTool**：带编码处理的完整文件内容检索
@@ -72,7 +72,22 @@ flowchart TB
 - **WriteFileTool**：带父目录创建的原子文件写入
 - **RunCommandTool**：带 30 秒超时和阻塞命令检测的 Shell 执行（防止 `vim` 等交互式命令）
 
-### 3.2 数据工具（`data_tools.rs`）
+### 3.2 文档工具（`load_artifacts.rs`、`artifact_tools.rs`）
+**目的**：项目迭代文档的加载和保存操作
+- **LoadIdeaTool**：加载当前迭代的想法文档
+- **LoadPrdDocTool**：加载当前迭代的产品需求文档
+- **LoadDesignDocTool**：加载当前迭代的设计文档
+- **LoadPlanDocTool**：加载当前迭代的实现计划文档
+- **SavePrdDocTool**：保存 PRD 文档到 artifacts 目录
+- **SaveDesignDocTool**：保存设计文档到 artifacts 目录
+- **SavePlanDocTool**：保存实现计划文档到 artifacts 目录
+- **SaveDeliveryReportTool**：保存交付报告到 artifacts 目录
+- **SaveCheckReportTool**：保存检查报告到 artifacts 目录
+- **SaveIdeaTool**：保存初始想法文档
+
+> **注意**：文档工具让所有 Agent 都能在任务执行过程中按需读取项目迭代文件，了解项目上下文。这些工具已配置到所有内置 Agent 中。
+
+### 3.3 数据工具（`data_tools.rs`）
 **目的**：需求、特征和任务的结构化数据管理
 - **需求管理**：`CreateRequirementTool`、`GetRequirementsTool`（REQ-ID 前缀）
 - **特征管理**：`AddFeatureTool`、`UpdateFeatureStatusTool`、`GetDesignDocumentTool`（FEAT-ID 前缀）
@@ -80,26 +95,26 @@ flowchart TB
 - **组件管理**：`AddComponentTool`、`GetImplementationPlanTool`（COMP-ID 前缀）
 - **状态工作流**：强制有效状态转换和依赖跟踪
 
-### 3.3 HITL 工具（`hitl_tools.rs`、`hitl_content_tools.rs`）
+### 3.4 HITL 工具（`hitl_tools.rs`、`hitl_content_tools.rs`）
 **目的**：用于验证和优化的智能体-人交互
 - **ReviewAndEditFileTool**：文件审查的二进制工作流（pass/edit），带外部编辑器集成
 - **ReviewWithFeedbackFileTool**：三元工作流（pass/edit/feedback），启用带人类注释的智能体重新生成
 - **ReviewAndEditContentTool**：生成工件（PRD、Design 文档）的内容级审查
 - **ReviewWithFeedbackContentTool**：反馈驱动的内容优化
 
-### 3.4 验证工具（`validation_tools.rs`）
+### 3.5 验证工具（`validation_tools.rs`）
 **目的**：数据完整性和一致性验证
 - **CheckDataFormatTool**：结构化数据文件的 JSON Schema 验证
 - **CheckFeatureCoverageTool**：特征和需求之间的双向覆盖分析
 - **CheckTaskDependenciesTool**：使用深度优先搜索（DFS）算法的循环依赖检测
 
-### 3.5 部署工具（`deployment_tools.rs`）
+### 3.6 部署工具（`deployment_tools.rs`）
 **目的**：工作区工件到项目根的安全提升
 - **CopyWorkspaceToProjectTool**：两阶段部署策略：
   - **阶段 1**：孤立文件清理（移除不在工作区的文件，受保护路径：`.git/`、`config.toml`、`README.md`）
   - **阶段 2**：扩展名过滤复制（白名单：`.html`、`.css`、`.js`、`.ts`、`.tsx`、`.json`、`.md`、图像、字体）
 
-### 3.6 Memory工具（`memory_tools.rs`）
+### 3.7 Memory工具（`memory_tools.rs`）
 **目的**：跨迭代的知识持久化和检索
 - **QueryMemoryTool**：跨三个范围（project、iteration、smart-merged）的模糊关键词搜索
 - **SaveInsightTool**：带分类的迭代见解捕获
@@ -108,7 +123,7 @@ flowchart TB
 - **PromoteToDecisionTool**：将见解提升为架构决策
 - **PromoteToPatternTool**：将见解提升为可重用设计模式
 
-### 3.7 PM 工具（`pm_tools.rs`）
+### 3.8 PM 工具（`pm_tools.rs`）
 **目的**：项目经理 Agent 的操作工具，支持迭代完成后的用户交互
 - **PMGotoStageTool**：允许用户返回到之前的阶段（idea、prd、design、plan、coding）重新执行
 - **PMCreateIterationTool**：创建新迭代以处理新需求或修改
diff --git "a/litho.docs/zh/4\343\200\201\346\267\261\345\205\245\346\216\242\347\264\242/4.9\343\200\201Cowork GUI\345\220\216\347\253\257.md" "b/litho.docs/zh/4\343\200\201\346\267\261\345\205\245\346\216\242\347\264\242/4.9\343\200\201Cowork GUI\345\220\216\347\253\257.md"
index a745f6d..d16cade 100644
--- "a/litho.docs/zh/4\343\200\201\346\267\261\345\205\245\346\216\242\347\264\242/4.9\343\200\201Cowork GUI\345\220\216\347\253\257.md"	
+++ "b/litho.docs/zh/4\343\200\201\346\267\261\345\205\245\346\216\242\347\264\242/4.9\343\200\201Cowork GUI\345\220\216\347\253\257.md"	
@@ -14,7 +14,7 @@
 该域在六边形架构中实现**适配器**模式，将核心域的 `InteractiveBackend` 特性适配到 Tauri 的事件驱动桌面运行时。它保持表示层关注点（React 前端）和业务逻辑（cowork-core）之间的严格分离，确保核心域保持 GUI 特定实现细节的不可知。
 
 **关键职责：**
-- **命令处理**：为前端调用暴露 24+ 个 JSON-RPC 端点
+- **命令处理**：为前端调用暴露 25+ 个 JSON-RPC 端点
 - **事件流式传输**：通过 Tauri 事件发射系统进行实时双向通信
 - **流程管理**：跨平台开发服务器生命周期管理
 - **状态桥接**：异步任务和 UI 线程之间的线程安全共享状态管理
@@ -83,7 +83,9 @@ flowchart TB
 | `create_project` | 项目聚合初始化 | 事务性创建 |
 | `start_iteration_preview` | ProcessRunner 激活 | 子流程管理 |
 | `pm_send_message` | 项目经理 Agent 消息处理 | 带上下文的历史消息 |
-| `pm_restart_iteration` | 从指定阶段重新执行 | 流程跳转 |
+| `pm_restart_iteration` |
+| `gui_get_available_tools` | 获取可用工具列表 | 工具ID、名称、分类、描述 |
+| `gui_reset_config_registry` | 重置配置注册表 | 所有内置配置 | 从指定阶段重新执行 | 流程跳转 |
 | `get_system_locale` | 获取系统语言设置 | 同步返回 |
 
 **实现模式：**
@@ -327,6 +329,34 @@ fn iteration_to_info(iteration: &Iteration, project: &Project) -> IterationInfo
 
 ---
 
+### 8.4 工具目录 API
+
+GUI 后端提供工具目录查询接口，支持动态获取 Agent 可配置的工具列表：
+
+**`gui_get_available_tools` 命令**：
+- **返回**：工具信息列表，包含：
+  - `id`：工具标识符
+  - `name`：工具显示名称
+  - `category`：工具分类（Idea、Data、File、Document、Design、Validation、HITL、Memory、Deployment、Flow Control、PM）
+  - `description`：工具功能描述
+
+**工具分类**：
+| 分类 | 工具示例 |
+|------|---------|
+| Idea | save_idea |
+| Data | create_requirement, get_requirements, create_task, update_task_status, get_design, get_implementation_plan |
+| File | read_file, write_file, list_files, run_command, read_file_truncated |
+| Document | load_idea, load_prd_doc, load_design_doc, load_plan_doc, save_prd_doc, save_design_doc, save_plan_doc |
+| Design | create_design_component |
+| Validation | check_feature_coverage, check_task_dependencies, check_tests, check_lint, check_data_format |
+| HITL | provide_feedback, load_feedback_history |
+| Memory | query_memory, save_insight, save_issue, save_learning, promote_to_decision, promote_to_pattern |
+| Deployment | copy_workspace_to_project |
+| Flow Control | goto_stage |
+| PM | pm_goto_stage, pm_create_iteration, pm_respond, pm_save_decision |
+
+> **前端集成**：Agent 配置界面使用此 API 动态渲染工具选择器，按分类分组显示，支持搜索和提示功能。
+
 ## 8. 配置和扩展
 
 ### 8.1 运行时配置

From 5a68cf6c99c24e5541af8b70de5b6182504608a2 Mon Sep 17 00:00:00 2001
From: Sopaco <dokhell@hotmail.com>
Date: Tue, 31 Mar 2026 20:44:25 +0800
Subject: [PATCH 6/7] Add path utilities for macOS App Bundle compatibility

Implement path_utils module to find executables (bun, npm, node) across
platforms when GUI apps have limited PATH. Replace which::which calls
with path_utils functions in preview and runner commands. Initialize
extended PATH at application startup to ensure child processes can
locate development tools.
---
 .../cowork-gui/src-tauri/src/commands/mod.rs  |   7 +
 .../src-tauri/src/commands/path_utils.rs      | 425 ++++++++++++++++++
 .../src-tauri/src/commands/preview.rs         |   5 +-
 .../src-tauri/src/commands/runner.rs          |  16 +-
 crates/cowork-gui/src-tauri/src/lib.rs        |   7 +-
 5 files changed, 452 insertions(+), 8 deletions(-)
 create mode 100644 crates/cowork-gui/src-tauri/src/commands/path_utils.rs

diff --git a/crates/cowork-gui/src-tauri/src/commands/mod.rs b/crates/cowork-gui/src-tauri/src/commands/mod.rs
index 6676838..34e768c 100644
--- a/crates/cowork-gui/src-tauri/src/commands/mod.rs
+++ b/crates/cowork-gui/src-tauri/src/commands/mod.rs
@@ -6,6 +6,7 @@ pub mod template;
 pub mod pm;
 pub mod system;
 pub mod import_cmd;
+pub mod path_utils;
 
 use lazy_static::lazy_static;
 use std::sync::Mutex;
@@ -20,3 +21,9 @@ lazy_static! {
 pub fn init_app_handle(handle: tauri::AppHandle) {
     PROJECT_RUNNER.set_app_handle(handle);
 }
+
+/// Initialize PATH for macOS App Bundle compatibility
+/// Must be called very early in the application lifecycle
+pub fn init_path_for_app_bundle() {
+    path_utils::init_extended_path();
+}
diff --git a/crates/cowork-gui/src-tauri/src/commands/path_utils.rs b/crates/cowork-gui/src-tauri/src/commands/path_utils.rs
new file mode 100644
index 0000000..334f9fe
--- /dev/null
+++ b/crates/cowork-gui/src-tauri/src/commands/path_utils.rs
@@ -0,0 +1,425 @@
+// Path utilities for resolving executable search issues across platforms
+// 
+// This module provides platform-agnostic utilities to find common executables
+// (bun, npm, node, etc.) regardless of PATH limitations on GUI apps.
+//
+// Platform support:
+// - macOS: Finder/Launchpad apps have limited PATH
+// - Windows: May need to check Program Files, AppData, etc.
+// - Linux: Various package manager locations
+
+use std::path::PathBuf;
+use std::env;
+
+/// Platform-specific path separator
+#[cfg(windows)]
+const PATH_SEP: char = ';';
+
+#[cfg(not(windows))]
+const PATH_SEP: char = ':';
+
+/// Get user home directory path
+fn get_home_dir() -> Option<PathBuf> {
+    #[cfg(windows)]
+    {
+        if let Ok(userprofile) = env::var("USERPROFILE") {
+            return Some(PathBuf::from(userprofile));
+        }
+        if let Ok(home) = env::var("HOMEDRIVE").and_then(|d| env::var("HOMEPATH").map(|p| PathBuf::from(d).join(p))) {
+            return Some(home);
+        }
+    }
+    
+    #[cfg(not(windows))]
+    {
+        if let Ok(home) = env::var("HOME") {
+            return Some(PathBuf::from(home));
+        }
+    }
+    
+    None
+}
+
+/// Get platform-specific bun installation paths
+fn get_bun_paths() -> Vec<PathBuf> {
+    let mut paths = Vec::new();
+    
+    // Check PATH first (fastest path)
+    if let Ok(path_env) = env::var("PATH") {
+        for dir in path_env.split(PATH_SEP) {
+            paths.push(PathBuf::from(dir).join("bun"));
+        }
+    }
+    
+    // macOS-specific paths
+    #[cfg(target_os = "macos")]
+    {
+        if let Some(home) = get_home_dir() {
+            paths.push(home.join(".bun").join("bin").join("bun"));
+            paths.push(home.join(".nvm").join("versions").join("node").join("*").join("bin").join("bun"));
+        }
+        paths.push(PathBuf::from("/opt/homebrew/bin/bun"));  // Apple Silicon
+        paths.push(PathBuf::from("/usr/local/bin/bun"));      // Intel Mac
+    }
+    
+    // Linux-specific paths
+    #[cfg(target_os = "linux")]
+    {
+        if let Some(home) = get_home_dir() {
+            paths.push(home.join(".bun").join("bin").join("bun"));
+            paths.push(home.join(".nvm").join("versions").join("node").join("*").join("bin").join("bun"));
+        }
+        paths.push(PathBuf::from("/usr/local/bin/bun"));
+        paths.push(PathBuf::from("/snap/bin/bun"));
+    }
+    
+    // Windows-specific paths
+    #[cfg(windows)]
+    {
+        if let Some(home) = get_home_dir() {
+            paths.push(home.join(".bun").join("bin").join("bun.exe"));
+        }
+        
+        // Program Files
+        if let Ok(program_files) = env::var("ProgramFiles") {
+            paths.push(PathBuf::from(&program_files).join("bun").join("bin").join("bun.exe"));
+        }
+        if let Ok(program_files_x86) = env::var("ProgramFiles(x86)") {
+            paths.push(PathBuf::from(&program_files_x86).join("bun").join("bin").join("bun.exe"));
+        }
+        
+        // Local AppData
+        if let Ok(local_appdata) = env::var("LOCALAPPDATA") {
+            paths.push(PathBuf::from(&local_appdata).join("bun").join("bin").join("bun.exe"));
+        }
+    }
+    
+    paths
+}
+
+/// Get platform-specific npm installation paths
+fn get_npm_paths() -> Vec<PathBuf> {
+    let mut paths = Vec::new();
+    
+    // Check PATH first
+    if let Ok(path_env) = env::var("PATH") {
+        for dir in path_env.split(PATH_SEP) {
+            paths.push(PathBuf::from(dir).join("npm"));
+        }
+    }
+    
+    // macOS/Linux
+    #[cfg(any(target_os = "macos", target_os = "linux"))]
+    {
+        if let Some(home) = get_home_dir() {
+            // nvm installations
+            paths.push(home.join(".nvm").join("versions").join("node").join("*").join("bin").join("npm"));
+            // fnm installations
+            paths.push(home.join(".fnm").join("node-versions").join("*").join("installation").join("bin").join("npm"));
+            // volta installations
+            paths.push(home.join(".volta").join("bin").join("npm"));
+        }
+        
+        #[cfg(target_os = "macos")]
+        {
+            paths.push(PathBuf::from("/opt/homebrew/bin/npm"));
+            paths.push(PathBuf::from("/usr/local/bin/npm"));
+        }
+        
+        #[cfg(target_os = "linux")]
+        {
+            paths.push(PathBuf::from("/usr/local/bin/npm"));
+            paths.push(PathBuf::from("/snap/bin/npm"));
+        }
+    }
+    
+    // Windows
+    #[cfg(windows)]
+    {
+        if let Some(home) = get_home_dir() {
+            paths.push(home.join(".nvm").join("versions").join("node").join("*").join("npm.cmd"));
+            paths.push(home.join(".fnm").join("node-versions").join("*").join("installation").join("npm.cmd"));
+            paths.push(home.join(".volta").join("bin").join("npm.cmd"));
+        }
+        
+        if let Ok(program_files) = env::var("ProgramFiles") {
+            paths.push(PathBuf::from(&program_files).join("nodejs").join("npm.cmd"));
+        }
+        if let Ok(program_files_x86) = env::var("ProgramFiles(x86)") {
+            paths.push(PathBuf::from(&program_files_x86).join("nodejs").join("npm.cmd"));
+        }
+    }
+    
+    paths
+}
+
+/// Get platform-specific node installation paths
+#[allow(dead_code)]
+fn get_node_paths() -> Vec<PathBuf> {
+    let mut paths = Vec::new();
+    
+    // Check PATH first
+    if let Ok(path_env) = env::var("PATH") {
+        for dir in path_env.split(PATH_SEP) {
+            paths.push(PathBuf::from(dir).join("node"));
+        }
+    }
+    
+    // macOS/Linux
+    #[cfg(any(target_os = "macos", target_os = "linux"))]
+    {
+        if let Some(home) = get_home_dir() {
+            paths.push(home.join(".nvm").join("versions").join("node").join("*").join("bin").join("node"));
+            paths.push(home.join(".fnm").join("node-versions").join("*").join("installation").join("bin").join("node"));
+            paths.push(home.join(".volta").join("bin").join("node"));
+        }
+        
+        #[cfg(target_os = "macos")]
+        {
+            paths.push(PathBuf::from("/opt/homebrew/bin/node"));
+            paths.push(PathBuf::from("/usr/local/bin/node"));
+        }
+        
+        #[cfg(target_os = "linux")]
+        {
+            paths.push(PathBuf::from("/usr/local/bin/node"));
+            paths.push(PathBuf::from("/snap/bin/node"));
+        }
+    }
+    
+    // Windows
+    #[cfg(windows)]
+    {
+        if let Some(home) = get_home_dir() {
+            paths.push(home.join(".nvm").join("versions").join("node").join("*").join("node.exe"));
+            paths.push(home.join(".fnm").join("node-versions").join("*").join("installation").join("node.exe"));
+            paths.push(home.join(".volta").join("bin").join("node.exe"));
+        }
+        
+        if let Ok(program_files) = env::var("ProgramFiles") {
+            paths.push(PathBuf::from(&program_files).join("nodejs").join("node.exe"));
+        }
+        if let Ok(program_files_x86) = env::var("ProgramFiles(x86)") {
+            paths.push(PathBuf::from(&program_files_x86).join("nodejs").join("node.exe"));
+        }
+    }
+    
+    paths
+}
+
+/// Find an executable by checking common paths
+fn find_executable(paths: &[PathBuf]) -> Option<PathBuf> {
+    for path in paths {
+        // For paths with wildcards, we need to expand them
+        if path.to_string_lossy().contains('*') {
+            if let Some(parent) = path.parent() {
+                if let Some(file_name) = path.file_name() {
+                    if let Ok(entries) = std::fs::read_dir(parent) {
+                        for entry in entries.flatten() {
+                            let full_path = entry.path().join(file_name);
+                            if full_path.exists() && is_executable(&full_path) {
+                                return Some(full_path);
+                            }
+                        }
+                    }
+                }
+            }
+        } else if path.exists() && is_executable(path) {
+            return Some(path.clone());
+        }
+    }
+    None
+}
+
+/// Check if a path is executable
+#[cfg(unix)]
+fn is_executable(path: &PathBuf) -> bool {
+    use std::os::unix::fs::PermissionsExt;
+    path.is_file() && path.metadata().map(|m| m.permissions().mode() & 0o111 != 0).unwrap_or(false)
+}
+
+#[cfg(windows)]
+fn is_executable(path: &PathBuf) -> bool {
+    path.is_file()
+        && path.extension()
+            .map(|ext| matches!(ext.to_str(), Some("exe") | Some("cmd") | Some("bat")))
+            .unwrap_or(false)
+}
+
+/// Find bun executable, returns the full path if found
+pub fn find_bun() -> Option<PathBuf> {
+    find_executable(&get_bun_paths())
+}
+
+/// Find npm executable, returns the full path if found  
+pub fn find_npm() -> Option<PathBuf> {
+    find_executable(&get_npm_paths())
+}
+
+/// Find node executable, returns the full path if found
+#[allow(dead_code)]
+pub fn find_node() -> Option<PathBuf> {
+    find_executable(&get_node_paths())
+}
+
+/// Check if bun is available
+pub fn has_bun() -> bool {
+    find_bun().is_some()
+}
+
+/// Check if npm is available
+pub fn has_npm() -> bool {
+    find_npm().is_some()
+}
+
+/// Get the preferred package manager (bun or npm)
+/// Returns ("bun" or "npm", full_path)
+#[allow(dead_code)]
+pub fn get_package_manager() -> Option<(&'static str, PathBuf)> {
+    if let Some(bun) = find_bun() {
+        return Some(("bun", bun));
+    }
+    if let Some(npm) = find_npm() {
+        return Some(("npm", npm));
+    }
+    None
+}
+
+/// Build an extended PATH that includes common development tool locations
+/// This should be called at application startup to fix the PATH issue on GUI apps
+pub fn build_extended_path() -> String {
+    let mut path_dirs: Vec<String> = Vec::new();
+    
+    // Get existing PATH
+    if let Ok(existing) = env::var("PATH") {
+        for dir in existing.split(PATH_SEP) {
+            if !dir.is_empty() && !path_dirs.contains(&dir.to_string()) {
+                path_dirs.push(dir.to_string());
+            }
+        }
+    }
+    
+    // Add platform-specific paths
+    #[cfg(target_os = "macos")]
+    {
+        let extra_paths = [
+            "/opt/homebrew/bin",
+            "/opt/homebrew/sbin",
+            "/usr/local/bin",
+            "/usr/local/sbin",
+        ];
+        for path in extra_paths {
+            if !path_dirs.contains(&path.to_string()) {
+                path_dirs.push(path.to_string());
+            }
+        }
+        
+        // Add user-specific paths
+        if let Some(home) = get_home_dir() {
+            let home_str = home.to_string_lossy().to_string();
+            let user_paths = [
+                format!("{}/.bun/bin", home_str),
+                format!("{}/.cargo/bin", home_str),
+                format!("{}/.volta/bin", home_str),
+                format!("{}/.local/bin", home_str),
+                format!("{}/go/bin", home_str),
+            ];
+            for path in user_paths {
+                if !path_dirs.contains(&path) {
+                    path_dirs.push(path);
+                }
+            }
+        }
+    }
+    
+    #[cfg(target_os = "linux")]
+    {
+        let extra_paths = [
+            "/usr/local/bin",
+            "/snap/bin",
+        ];
+        for path in extra_paths {
+            if !path_dirs.contains(&path.to_string()) {
+                path_dirs.push(path.to_string());
+            }
+        }
+        
+        if let Some(home) = get_home_dir() {
+            let home_str = home.to_string_lossy().to_string();
+            let user_paths = [
+                format!("{}/.bun/bin", home_str),
+                format!("{}/.cargo/bin", home_str),
+                format!("{}/.volta/bin", home_str),
+                format!("{}/.local/bin", home_str),
+                format!("{}/go/bin", home_str),
+            ];
+            for path in user_paths {
+                if !path_dirs.contains(&path) {
+                    path_dirs.push(path);
+                }
+            }
+        }
+    }
+    
+    #[cfg(windows)]
+    {
+        // Windows-specific paths
+        if let Ok(program_files) = env::var("ProgramFiles") {
+            let pf = PathBuf::from(&program_files);
+            if !path_dirs.contains(&pf.to_string_lossy().to_string()) {
+                path_dirs.push(pf.to_string_lossy().to_string());
+            }
+        }
+        if let Ok(program_files_x86) = env::var("ProgramFiles(x86)") {
+            let pf_x86 = PathBuf::from(&program_files_x86);
+            if !path_dirs.contains(&pf_x86.to_string_lossy().to_string()) {
+                path_dirs.push(pf_x86.to_string_lossy().to_string());
+            }
+        }
+        
+        if let Some(home) = get_home_dir() {
+            let home_str = home.to_string_lossy().to_string();
+            let user_paths = [
+                format!("{}/.bun/bin", home_str),
+                format!("{}/.cargo/bin", home_str),
+                format!("{}/AppData/Local/Programs", home_str),
+            ];
+            for path in user_paths {
+                if !path_dirs.contains(&path) {
+                    path_dirs.push(path);
+                }
+            }
+        }
+    }
+    
+    path_dirs.join(&PATH_SEP.to_string())
+}
+
+/// Initialize extended PATH at application startup
+/// Call this early in the application lifecycle to ensure all child processes
+/// inherit the correct PATH
+pub fn init_extended_path() {
+    let extended_path = build_extended_path();
+    
+    // Log for debugging
+    eprintln!("[PathUtils] Setting extended PATH ({} platform)", std::env::consts::OS);
+    eprintln!("[PathUtils] PATH length: {} characters", extended_path.len());
+    
+    // Set the PATH environment variable
+    // Note: Using unsafe block to work around potential Rust version or environment issues
+    // std::env::set_var is safe in standard Rust, but may be marked differently in this environment
+    unsafe { std::env::set_var("PATH", &extended_path) };
+    
+    // Verify that bun/npm can now be found
+    if let Some(bun) = find_bun() {
+        eprintln!("[PathUtils] Found bun at: {:?}", bun);
+    } else {
+        eprintln!("[PathUtils] bun not found after PATH extension");
+    }
+    
+    if let Some(npm) = find_npm() {
+        eprintln!("[PathUtils] Found npm at: {:?}", npm);
+    } else {
+        eprintln!("[PathUtils] npm not found after PATH extension");
+    }
+}
\ No newline at end of file
diff --git a/crates/cowork-gui/src-tauri/src/commands/preview.rs b/crates/cowork-gui/src-tauri/src/commands/preview.rs
index 5d35968..7aac070 100644
--- a/crates/cowork-gui/src-tauri/src/commands/preview.rs
+++ b/crates/cowork-gui/src-tauri/src/commands/preview.rs
@@ -1,6 +1,7 @@
 use crate::gui_types::*;
 use crate::static_server;
 use crate::commands::PROJECT_RUNNER;
+use crate::commands::path_utils;
 use crate::AppState;
 use std::path::PathBuf;
 use tauri::State;
@@ -37,8 +38,8 @@ async fn install_dependencies_if_needed(workspace: &std::path::Path) -> Result<(
     let node_modules = workspace.join("node_modules");
 
     if package_json.exists() && !node_modules.exists() {
-        let use_bun = which::which("bun").is_ok();
-        let use_npm = which::which("npm").is_ok();
+        let use_bun = path_utils::has_bun();
+        let use_npm = path_utils::has_npm();
 
         let (cmd, args) = if use_bun { ("bun", vec!["install"]) }
         else if use_npm { ("npm", vec!["install"]) }
diff --git a/crates/cowork-gui/src-tauri/src/commands/runner.rs b/crates/cowork-gui/src-tauri/src/commands/runner.rs
index af15b6b..4b05bb3 100644
--- a/crates/cowork-gui/src-tauri/src/commands/runner.rs
+++ b/crates/cowork-gui/src-tauri/src/commands/runner.rs
@@ -1,6 +1,7 @@
 use crate::gui_types::*;
 use crate::static_server;
 use crate::commands::PROJECT_RUNNER;
+use crate::commands::path_utils;
 use crate::AppState;
 use cowork_core::RuntimeType;
 use std::path::PathBuf;
@@ -63,9 +64,14 @@ async fn install_deps_if_needed(workspace: &std::path::Path) -> Result<(), Strin
     let pkg = workspace.join("package.json");
     let mods = workspace.join("node_modules");
     if pkg.exists() && !mods.exists() {
-        let (cmd, args) = if which::which("bun").is_ok() { ("bun", vec!["install"]) }
-        else if which::which("npm").is_ok() { ("npm", vec!["install"]) }
-        else { return Ok(()) };
+        // Use our path_utils instead of which::which for macOS App Bundle compatibility
+        let (cmd, args) = if path_utils::has_bun() { 
+            ("bun", vec!["install"]) 
+        } else if path_utils::has_npm() { 
+            ("npm", vec!["install"]) 
+        } else { 
+            return Ok(()) 
+        };
         
         eprintln!("[Runner] Installing dependencies with {} {:?}", cmd, args);
         let out = std::process::Command::new(cmd).args(&args).current_dir(workspace).output();
@@ -145,7 +151,7 @@ fn detect_npm_start_command(dir: &std::path::Path) -> Option<String> {
                 // Try common start scripts in order
                 for script_name in &["dev", "start", "serve"] {
                     if scripts.get(*script_name).and_then(|s| s.as_str()).is_some() {
-                        let pkg_manager = if which::which("bun").is_ok() { "bun" } else { "npm" };
+                        let pkg_manager = if path_utils::has_bun() { "bun" } else { "npm" };
                         let command = format!("{} run {}", pkg_manager, script_name);
                         eprintln!("[Runner] Detected start command from package.json: {}", command);
                         return Some(command);
@@ -325,7 +331,7 @@ pub async fn start_iteration_project(
         }
         
         // No start script but has package.json - try common defaults
-        let pkg_manager = if which::which("bun").is_ok() { "bun" } else { "npm" };
+        let pkg_manager = if path_utils::has_bun() { "bun" } else { "npm" };
         let default_cmd = format!("{} run dev", pkg_manager);
         eprintln!("[Runner] Fallback: trying default command: {}", default_cmd);
         
diff --git a/crates/cowork-gui/src-tauri/src/lib.rs b/crates/cowork-gui/src-tauri/src/lib.rs
index ed074d5..87cadea 100644
--- a/crates/cowork-gui/src-tauri/src/lib.rs
+++ b/crates/cowork-gui/src-tauri/src/lib.rs
@@ -22,7 +22,7 @@ mod config_commands;
 use project_manager::*;
 
 // Re-export commands from new module structure
-use commands::{init_app_handle, file, preview, runner, memory, template, pm, system, import_cmd};
+use commands::{init_app_handle, init_path_for_app_bundle, file, preview, runner, memory, template, pm, system, import_cmd};
 
 
 
@@ -633,6 +633,11 @@ async fn submit_input_response(
 
 #[cfg_attr(mobile, tauri::mobile_entry_point)]
 pub fn run() {
+    // Initialize PATH for macOS App Bundle compatibility
+    // This MUST be called first, before any other initialization
+    // On macOS, GUI apps launched from Finder have a limited PATH
+    init_path_for_app_bundle();
+    
     let app_state = AppState::new()
         .expect("Failed to initialize application state");
 

From 5dd27cfe234b6e35c55aac46b23ccfbc76ed204c Mon Sep 17 00:00:00 2001
From: Sopaco <dokhell@hotmail.com>
Date: Tue, 31 Mar 2026 20:53:05 +0800
Subject: [PATCH 7/7] Fix ACP client by inheriting parent PATH environment
 variable

When spawning the agent process, the PATH environment variable was not
being passed, causing the child process to be unable to locate
executables. This change ensures the child process inherits the PATH
from the parent process.
---
 crates/cowork-core/src/acp/client.rs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/crates/cowork-core/src/acp/client.rs b/crates/cowork-core/src/acp/client.rs
index 285e965..9cc8f1d 100644
--- a/crates/cowork-core/src/acp/client.rs
+++ b/crates/cowork-core/src/acp/client.rs
@@ -219,6 +219,7 @@ fn run_acp_in_thread(
         // Spawn the agent process
         let mut cmd = Command::new(&config.command);
         cmd.args(&config.args)
+            .env("PATH", std::env::var("PATH").unwrap_or_default())
             .current_dir(&workspace)
             .stdin(Stdio::piped())
             .stdout(Stdio::piped())