feat: v3.4.0 — Agent 工具系统进化

参考 Claude Code Tool 类型系统架构，将代理插件从 API 转发+工具拦截器
进化为完整的 Agent 执行引擎。

- Tool 泛型接口 + buildTool() 工厂 + ToolRegistry 注册表
- 5 个新增工具: bash/glob/grep/file_read/list_directory
- 7 个现有工具从 1427 行 if/else 链提取为独立模块
- 三 Provider 统一 ToolRegistry 异步拦截 + 并发分区执行
- 新工具 JSON Schema 自动注入 Anthropic/OpenAI/Gemini 三格式
- 20 个新文件，1625 行代码

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: LegnaOS

RELEASE_NOTES_v3.3.10.md

@@ -0,0 +1,34 @@
+# Augment Proxy Manager v3.3.10 - Responses 二轮 assistant history 编码修复
+
+## 核心结论
+
+这次修的不是 retry，也不是 parser。
+
+真正的问题是：在 OpenAI `responses` 模式下，手工回放历史消息时，`assistant` 角色内容被错误编码成了 `input_text`。
+
+第一轮没有 assistant history，所以能过；第二轮一旦带上上一轮 assistant 回复，上游就可能直接返回 `502 upstream_error`。
+
+## 本次修复
+
+### 1. Assistant history 改为 `output_text`
+- `role: "assistant"` 的历史 message 内容不再使用 `input_text`
+- 改为符合 Responses 语义的 `output_text`
+
+### 2. 覆盖普通 assistant 与 assistant+tool_calls 两条路径
+- 普通 assistant 历史消息会正确编码为 `output_text`
+- 带 `tool_calls` 的 assistant 历史消息，其文本部分也会正确编码为 `output_text`
+
+### 3. 清理脏 tool call
+- 若历史 `assistant.tool_calls` 缺失 `function.name`
+- 直接丢弃，不再构造坏的 `function_call` item 去污染上游请求
+
+## 验证情况
+
+- TypeScript diagnostics：通过
+- 本地 compile：`npm run compile` 已通过
+
+## 兼容性
+
+- 仅影响 OpenAI `responses` 历史消息转换逻辑
+- 不影响 `chat.completions`
+- 不影响 Anthropic / Google provider

RELEASE_NOTES_v3.3.8.md

@@ -0,0 +1,42 @@
+# Augment Proxy Manager v3.3.8 - Responses Tool Call 别名合并修复
+
+## 核心结论
+
+v3.3.8 修的是 `responses` 工具调用聚合里的脏数据问题：
+
+- 同一个 function call 在 SSE partial 事件里常见是 `call_...`
+- 到 completed / output item 又可能变成 `fc_...`
+
+旧实现直接拿不同 id `set` 进 `Map`，于是同一调用会裂成两条记录。其中那条没名字的脏记录被回落成了字面量 `tool`，最后执行层自然找不到 tool definition。
+
+这版做的不是花活，就是把 **同一 tool call 重新并回同一条数据**。
+
+## 本次修复
+
+### 1. Responses tool call alias merge
+- 合并 `call_id`
+- 合并 `item.id / item_id`
+- 合并 `output_index`
+- 同一 function call 不再因为不同事件使用不同 id 被拆成两条
+
+### 2. 禁止脏默认值污染
+- partial 事件拿不到 `name` 时先留空
+- 等 `output_item` / `response.completed` 再回填真实工具名
+- 不再伪造默认工具名 `tool`
+
+### 3. Defensive finalize
+- 最终仍然没有真实 `name` 的 tool call 会被丢弃
+- 同时输出 warning log，便于继续定位上游异常 payload
+- 避免执行层再报：`Cannot find tool definition for tool 'tool'`
+
+## 验证情况
+
+- TypeScript diagnostics：通过
+- 本地 compile：`npm run compile` 已通过
+- 适合继续打包 `.vsix` 供实际对话流测试
+
+## 兼容性
+
+- 不影响 `chat.completions`
+- 不影响 Anthropic / Google provider
+- 只收敛 OpenAI `responses` 下的 tool-call 聚合逻辑

RELEASE_NOTES_v3.3.9.md

@@ -0,0 +1,47 @@
+# Augment Proxy Manager v3.3.9 - Upstream 502/503/504 保守重试
+
+## 核心结论
+
+这版不是再修 parser，而是给 OpenAI-compatible 上游加一个最小兜底：
+
+- 当 `/v1/responses` 返回 `502 / 503 / 504`
+- 或者请求过程中出现 timeout / `ECONNRESET` / `socket hang up`
+
+代理会做 **一次** 保守自动重试。
+
+目的很简单：别让一次中转抖动把整轮对话直接打死。
+
+## 本次修复
+
+### 1. Transient upstream retry
+- 识别 `502 / 503 / 504`
+- 识别 `upstream request failed` / `upstream_error` / `bad gateway` / `gateway timeout`
+- 小延迟 backoff 后自动重试 1 次
+
+### 2. Transport-level retry
+- 对以下瞬时传输错误新增同样的单次重试：
+  - timeout
+  - `ECONNRESET`
+  - `ECONNREFUSED`
+  - `ETIMEDOUT`
+  - `socket hang up`
+
+### 3. Better logs
+- 请求日志新增：
+  - `tools` 数量
+  - `bodyBytes`
+  - `continuation`
+  - `retry` 次数
+- 继续出问题时能更快判断到底是 payload 触发，还是上游随机抽风
+
+## 验证情况
+
+- TypeScript diagnostics：通过
+- 本地 compile：`npm run compile` 已通过
+- 适合继续打包 `.vsix` 供真实上游回归测试
+
+## 兼容性
+
+- 不改变正常成功请求的行为
+- 不影响 `400` 类真实请求错误的显式暴露
+- 不影响 Anthropic / Google provider

package-lock.json

@@ -2,7 +2,7 @@
   "name": "augment-proxy-manager",
   "displayName": "Augment Proxy Manager",
   "description": "管理 Augment API 代理服务器，支持自定义 API 端点和多种 AI 供应商",
-  "version": "3.3.7",
+  "version": "3.4.0",
   "publisher": "legna",
   "repository": {
     "type": "git",

package.json

@@ -8,7 +8,7 @@
 
 零注入 · 零登录 · 零配置
 
-[![Version](https://img.shields.io/badge/version-3.3.7-blue.svg)](https://github.com/LegnaOS/VSC-Augment-Proxy-Manager)
+[![Version](https://img.shields.io/badge/version-3.4.0-blue.svg)](https://github.com/LegnaOS/VSC-Augment-Proxy-Manager)
 [![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Windows%20%7C%20Linux-lightgrey.svg)]()
 
 </div>
@@ -52,6 +52,22 @@ Augment 扩展  →  本地代理 (:8765)  →  你的 AI 供应商 API
 
 ## 功能特性
 
+### 🛠️ v3.4 — Agent 工具系统进化
+
+- **Tool 类型系统** — 参考 Claude Code 的 `Tool<Input,Output>` 泛型架构，`buildTool()` 工厂模式，fail-closed 安全默认值（isReadOnly=false, isConcurrencySafe=false）
+- **ToolRegistry 注册表** — 统一的工具注册、查找（含 alias）、分发和格式转换，单例模式贯穿全局
+- **并发分区执行** — 只读工具（Glob/Grep/FileRead/ListDirectory/CodebaseSearch）自动并行执行，写入工具严格串行，参考 Claude Code 的 `partitionToolCalls` 策略
+- **5 个新增 Agent 工具**：
+  - `bash` — Shell 命令执行（120s 超时，10MB 输出缓冲）
+  - `glob` — 文件模式搜索（`**/*.ts`、`src/**/*.js`）
+  - `grep` — 内容搜索（优先 ripgrep，fallback grep）
+  - `file_read` — 增强文件读取（行号标注、行范围选择、2MB 限制）
+  - `list_directory` — 目录列表（文件类型 + 大小标注）
+- **工具 Schema 自动注入** — 新工具的 JSON Schema 自动注入到 Anthropic/OpenAI/Gemini 三种格式的 tool_definitions
+- **三 Provider 统一拦截** — Anthropic/OpenAI/Google 三路转发均集成 ToolRegistry 异步拦截，新工具在代理层直接执行
+- **现有工具模块化** — str-replace-editor、save-file、apply_patch、任务列表、codebase_search 等 7 个现有工具从 1427 行的 if/else 链提取为独立模块
+- **共享工具函数** — Patch 解析器（Augment V4A + Unified Diff）、路径修正、通用参数修正提取为 `shared/` 可复用模块
+
 ### 🧠 v3.0 — 智能上下文引擎
 
 - **Viking 分层上下文** — 借鉴 [OpenViking](https://github.com/volcengine/OpenViking) 的文件系统范式，L0 摘要 / L1 结构 / L2 全文三级按需加载，精准控制注入 token 量
@@ -134,16 +150,38 @@ src/
 ├── messages.ts           # Augment 协议解析 + System Prompt 注入
 ├── sidebar.ts            # 侧边栏 Webview UI
 ├── config.ts             # 供应商配置
-├── globals.ts            # 全局状态 (Viking/SessionMemory/RAG/Embedding)
+├── globals.ts            # 全局状态 (Viking/SessionMemory/RAG/Embedding/ToolRegistry)
 ├── context-manager.ts    # 上下文管理
 ├── context-compression.ts # 智能压缩
 ├── injection.ts          # Augment 扩展自动配置
 ├── omc.ts                # OMC 编排增强
-├── tools.ts              # 工具调用处理
+├── tools.ts              # 工具调用处理（薄层委托到 tools/）
+├── tools/                # v3.4.0 工具系统
+│   ├── Tool.ts           # 核心接口 + buildTool() 工厂
+│   ├── ToolRegistry.ts   # 工具注册表（查找/分发/并发分区执行）
+│   ├── ToolResultFormatter.ts # Diff 渲染 + 结果格式化
+│   ├── extra-tool-schemas.ts  # 新工具 JSON Schema（三格式注入）
+│   ├── index.ts           # 注册入口
+│   ├── StrReplaceEditorTool.ts  # 精确编辑（insert/str_replace/三级匹配）
+│   ├── SaveFileTool.ts          # 新建文件（已有文件拒绝覆盖）
+│   ├── ApplyPatchTool.ts        # Diff/Patch 应用
+│   ├── TaskListTool.ts          # 任务列表管理
+│   ├── EditFileTool.ts          # 错误桩（提示用 str-replace-editor）
+│   ├── WebSearchTool.ts         # Kimi $web_search 透传
+│   ├── CodebaseSearchTool.ts    # RAG 本地搜索
+│   ├── BashTool.ts              # Shell 命令执行
+│   ├── GlobTool.ts              # 文件模式搜索
+│   ├── GrepTool.ts              # 内容搜索（ripgrep/grep）
+│   ├── FileReadTool.ts          # 增强文件读取
+│   ├── ListDirectoryTool.ts     # 目录列表
+│   └── shared/
+│       ├── patch-parser.ts      # Augment V4A + Unified Diff 解析器
+│       ├── path-utils.ts        # 路径前缀修正
+│       └── input-fixer.ts       # 通用参数修正
 ├── providers/
-│   ├── anthropic.ts      # Anthropic 流式转发
-│   ├── openai.ts         # OpenAI 流式转发
-│   └── google.ts         # Google Gemini 流式转发
+│   ├── anthropic.ts      # Anthropic 流式转发 + ToolRegistry 拦截
+│   ├── openai.ts         # OpenAI 流式转发 + ToolRegistry 拦截
+│   └── google.ts         # Google Gemini 流式转发 + ToolRegistry 拦截
 └── rag/
     ├── index.ts           # RAG 索引 + Viking 增强搜索
     ├── embeddings.ts      # Embedding 引擎 (本地 5 模型 + 远程 API)
@@ -163,8 +201,86 @@ src/
 | Cursor | `~/.cursor/extensions` | `%USERPROFILE%\.cursor\extensions` |
 | Windsurf | `~/.windsurf/extensions` | `%USERPROFILE%\.windsurf\extensions` |
 
+## 进化链
+
+```
+v1.9.0  零注入代理 + RAG 语义搜索
+  ↓
+v2.1.x  Kimi/GLM 多供应商 + OMC 编排
+  ↓
+v3.0.0  Viking 分层上下文 + Session Memory + 本地 Embedding
+  ↓
+v3.1.0  文件编辑引擎重构 + 三 Provider 循环架构 + Diff 渲染
+  ↓
+v3.3.x  OpenAI Responses 协议 + Kimi 工具链闭环 + 状态端点
+  ↓
+v3.4.0  Agent 工具系统进化 — Tool 类型系统 + ToolRegistry
+         + 5 个新工具 (Bash/Glob/Grep/FileRead/ListDir)
+         + 并发分区执行 + 三 Provider 统一拦截
+```
+
 ## 更新日志
 
+### v3.4.0 — Agent 工具系统进化
+
+**🏗️ 架构重构 — 参考 Claude Code Tool 类型系统**
+- 新增 `Tool` 泛型接口 + `buildTool()` 工厂模式，fail-closed 安全默认值
+- 新增 `ToolRegistry` 注册表，统一工具查找（含 alias）、分发、并发分区执行
+- 将 `tools.ts` 中 1427 行的 `convertOrInterceptFileEdit()` if/else 链拆分为 7 个独立工具模块
+- Patch 解析器、路径修正、参数修正提取为 `shared/` 可复用模块
+- `processToolCallForAugment` 改为 async，支持 ToolRegistry 异步拦截
+
+**🔧 5 个新增 Agent 工具**
+- `bash` — Shell 命令执行（child_process.spawn，120s 超时，10MB 输出缓冲）
+- `glob` — 文件模式搜索（find + 排除 node_modules/.git/dist，200 结果上限）
+- `grep` — 内容搜索（优先 ripgrep，fallback grep，支持正则/大小写/上下文行）
+- `file_read` — 增强文件读取（cat -n 格式行号，offset/limit 行范围，2MB 限制）
+- `list_directory` — 目录列表（目录优先排序，文件大小标注）
+
+**⚡ 三 Provider 统一拦截**
+- Anthropic / OpenAI / Google 三路转发均集成 ToolRegistry 异步拦截
+- 新工具的 JSON Schema 通过 `extra-tool-schemas.ts` 自动注入三种格式的 tool_definitions
+- 只读工具自动并行执行，写入工具严格串行
+- 工具结果大小截断（50KB 上限）
+
+**📁 新增文件（20 个，1625 行）**
+```
+src/tools/Tool.ts, ToolRegistry.ts, ToolResultFormatter.ts, extra-tool-schemas.ts, index.ts
+src/tools/StrReplaceEditorTool.ts, SaveFileTool.ts, ApplyPatchTool.ts, TaskListTool.ts
+src/tools/EditFileTool.ts, WebSearchTool.ts, CodebaseSearchTool.ts
+src/tools/BashTool.ts, GlobTool.ts, GrepTool.ts, FileReadTool.ts, ListDirectoryTool.ts
+src/tools/shared/patch-parser.ts, path-utils.ts, input-fixer.ts
+```
+
+**🔄 修改文件（6 个）**
+- `globals.ts` — 添加 toolRegistry 字段
+- `proxy.ts` — 初始化 ToolRegistry
+- `tools.ts` — 三个 convertToolDefinitions 注入新工具 schema + processToolCallForAugment async 化
+- `providers/anthropic.ts` — 工具循环集成 ToolRegistry 异步拦截
+- `providers/openai.ts` — 通过 processToolCallForAugment 自动集成
+- `providers/google.ts` — 工具循环集成 ToolRegistry 异步拦截
+
+### v3.3.10 — Responses 二轮 assistant history 编码修复
+
+- **assistant history fix** — `responses` 手工重放历史消息时，assistant 角色内容不再错误编码为 `input_text`，改为符合协议语义的 `output_text`
+- **second-turn stability** — 修复“第一轮正常、第二轮稳定 502”这类由 assistant history payload 非法触发的兼容问题
+- **tool-call hygiene** — 历史 `assistant.tool_calls` 中缺失 `function.name` 的脏记录会被直接丢弃，避免继续向上游发送坏的 `function_call` item
+- **compatibility** — 只影响 OpenAI `responses` 历史消息转换逻辑，不改 `chat.completions`、Anthropic、Google 路径
+
+### v3.3.9 — Upstream 502/503/504 保守重试
+
+- **transient upstream retry** — 对 `502 / 503 / 504` 这类瞬时上游错误新增一次保守自动重试，降低 `responses` 请求被中转偶发打死的概率
+- **transport retry** — 对 timeout、`ECONNRESET`、`socket hang up` 等瞬时传输错误也会走同一套单次 retry
+- **better execution logs** — 请求日志现在会带上 `tools` 数量、body 大小、continuation 状态和 retry 次数，方便继续定位上游兼容性问题
+- **safety** — 只重试明显的 transient failure，不会把 `400` 这类真实请求错误伪装成可恢复问题
+
+### v3.3.8 — Responses Tool Call 别名合并修复
+
+- **responses tool alias merge** — 合并 `call_id`、`item.id / item_id`、`output_index` 三套标识，避免同一个 function call 在流式事件和 completed payload 中被拆成两条记录
+- **no fake tool name** — Responses parser 不再把缺失名称的半成品工具调用污染成字面量 `tool`，而是等待最终 payload 回填真实名字
+- **defensive finalize** — 最终仍拿不到真实名字的脏 tool call 会被直接丢弃并记录 warning，避免执行层再报 `Cannot find tool definition for tool 'tool'`
+- **compatibility** — 修复只影响 OpenAI `responses` tool-call 聚合逻辑，不改 `chat.completions`、Anthropic、Google 路径
+
 ### v3.3.7 — OpenAI Provider Wire API 修正 + Responses 自动回退
 
 - **openai provider wireApi** — `wireApi` 不再只绑在 `custom` 上，`openai` provider 现在也能明确选择 `chat.completions` 或 `responses`

readme.md

@@ -3,6 +3,7 @@ import * as http from 'http';
 import { CurrentConfig } from './types';
 import type { VikingContextStore } from './rag/viking-context';
 import type { SessionMemory } from './rag/session-memory';
+import type { ToolRegistry } from './tools/ToolRegistry';
 
 export interface RecordedEvent {
     id: string;
@@ -52,6 +53,9 @@ export const state = {
     ragIndex: null as any,
     semanticEngine: null as any,
 
+    // v3.4.0: 工具系统
+    toolRegistry: null as ToolRegistry | null,
+
     // v2.0.0: Viking 子系统
     vikingStore: null as VikingContextStore | null,
     sessionMemory: null as SessionMemory | null,

src/globals.ts

@@ -7,6 +7,7 @@ import { state, log } from '../globals';
 import { augmentToAnthropicMessages, buildSystemPrompt, extractWorkspaceInfo } from '../messages';
 import { convertToolDefinitions, fixToolCallInput, convertOrInterceptFileEdit, renderDiffText } from '../tools';
 import { applyContextCompression } from '../context-compression';
+import { renderDiffTextCompat } from '../tools/ToolResultFormatter';
 
 interface AnthropicToolCall { id: string; name: string; input: any; }
 interface AnthropicResult { text: string; toolCalls: AnthropicToolCall[]; stopReason: string; }
@@ -375,6 +376,35 @@ export async function forwardToAnthropicStream(augmentReq: any, res: any) {
                     }
                     interceptedTools.push({ tc, interceptResult: interceptResult.result });
                     log(`[LOOP] Tool ${tc.name} intercepted locally`);
+                } else if (!interceptResult && state.toolRegistry?.isIntercepted(tc.name)) {
+                    // v3.4.0: 新工具通过 ToolRegistry 异步拦截
+                    try {
+                        const context = {
+                            workspacePath: workspaceInfo?.workspacePath || '',
+                            repositoryRoot: workspaceInfo?.repositoryRoot || workspaceInfo?.workspacePath || '',
+                            cwd: workspaceInfo?.workspacePath || process.cwd(),
+                            conversationId: workspaceInfo?.conversationId || 'default',
+                        };
+                        const toolResult = await state.toolRegistry.execute(tc.name, input, context);
+                        if (toolResult) {
+                            let resultContent = JSON.stringify(toolResult);
+                            if (resultContent.length > TOOL_RESULT_SIZE_LIMIT) {
+                                resultContent = resultContent.slice(0, TOOL_RESULT_SIZE_LIMIT) + '\n[...truncated]';
+                            }
+                            interceptedTools.push({ tc, interceptResult: toolResult });
+                            log(`[LOOP] Tool ${tc.name} intercepted via ToolRegistry`);
+                        } else {
+                            nonInterceptedTools.push({ tc, toolNode: {
+                                type: 5, tool_use: {
+                                    tool_use_id: tc.id, tool_name: tc.name,
+                                    input_json: JSON.stringify(input)
+                                }
+                            }});
+                        }
+                    } catch (e: any) {
+                        log(`[LOOP] ToolRegistry error for ${tc.name}: ${e.message}`);
+                        interceptedTools.push({ tc, interceptResult: { success: false, error: e.message } });
+                    }
                 } else {
                     nonInterceptedTools.push({ tc, toolNode: {
                         type: 5, tool_use: {