feat: 工具层及 mcp 大重构 (#252)

* feat: 第一版大重构 * fix: 修复类型问题 * chore: 更新版本到 1.3.2 * Add brave as alternative WebSearchTool * fix: 修正顺序 * fix: 修复对穷鬼模式的 auto dream 和 session memory 越过 * feat: 穷鬼模式去除 session-summary * feat: 创建 builtin-tools 包，搬运所有工具实现将 src/tools/ 下的全部 60 个工具目录迁移至 packages/builtin-tools/src/tools/，内部导入路径已更新为 src/ alias 模式。 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * refactor: 更新 src/ 中所有工具引用至 builtin-tools 包，删除 src/tools/ - src/tools.ts 及 178 个 src/ 文件的 import 路径从 ./tools/ 改为 builtin-tools/tools/ - 删除 src/tools/ 整个目录（已迁移至 packages/builtin-tools/） Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * chore: 添加 builtin-tools 路径别名至 tsconfig，更新 bun.lock - tsconfig.json 新增 builtin-tools/* 和 builtin-tools 路径映射 - 新增 packages/builtin-tools/src 至 include Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * refactor: 为 builtin-tools、mcp-client、agent-tools 添加 @claude-code-best 作用域前缀所有包名及 import 路径统一添加 @claude-code-best/ 前缀： - builtin-tools → @claude-code-best/builtin-tools - mcp-client → @claude-code-best/mcp-client - agent-tools → @claude-code-best/agent-tools Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * fix: 修复 node 环境没有 bun 的问题 --------- Co-authored-by: Eric-Guo <eric.guocz@gmail.com> Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
2026-06-22 16:25:51 +00:00 · 2026-04-13 09:52:05 +08:00
parent bbb8b613a9
commit 2fb1c9dcd8
559 changed files with 9346 additions and 1837 deletions
--- a/packages/builtin-tools/src/tools/BashTool/commandSemantics.ts
+++ b/packages/builtin-tools/src/tools/BashTool/commandSemantics.ts
@@ -0,0 +1,140 @@
+/**
+ * Command semantics configuration for interpreting exit codes in different contexts.
+ *
+ * Many commands use exit codes to convey information other than just success/failure.
+ * For example, grep returns 1 when no matches are found, which is not an error condition.
+ */
+
+import { splitCommand_DEPRECATED } from 'src/utils/bash/commands.js'
+
+export type CommandSemantic = (
+  exitCode: number,
+  stdout: string,
+  stderr: string,
+) => {
+  isError: boolean
+  message?: string
+}
+
+/**
+ * Default semantic: treat only 0 as success, everything else as error
+ */
+const DEFAULT_SEMANTIC: CommandSemantic = (exitCode, _stdout, _stderr) => ({
+  isError: exitCode !== 0,
+  message:
+    exitCode !== 0 ? `Command failed with exit code ${exitCode}` : undefined,
+})
+
+/**
+ * Command-specific semantics
+ */
+const COMMAND_SEMANTICS: Map<string, CommandSemantic> = new Map([
+  // grep: 0=matches found, 1=no matches, 2+=error
+  [
+    'grep',
+    (exitCode, _stdout, _stderr) => ({
+      isError: exitCode >= 2,
+      message: exitCode === 1 ? 'No matches found' : undefined,
+    }),
+  ],
+
+  // ripgrep has same semantics as grep
+  [
+    'rg',
+    (exitCode, _stdout, _stderr) => ({
+      isError: exitCode >= 2,
+      message: exitCode === 1 ? 'No matches found' : undefined,
+    }),
+  ],
+
+  // find: 0=success, 1=partial success (some dirs inaccessible), 2+=error
+  [
+    'find',
+    (exitCode, _stdout, _stderr) => ({
+      isError: exitCode >= 2,
+      message:
+        exitCode === 1 ? 'Some directories were inaccessible' : undefined,
+    }),
+  ],
+
+  // diff: 0=no differences, 1=differences found, 2+=error
+  [
+    'diff',
+    (exitCode, _stdout, _stderr) => ({
+      isError: exitCode >= 2,
+      message: exitCode === 1 ? 'Files differ' : undefined,
+    }),
+  ],
+
+  // test/[: 0=condition true, 1=condition false, 2+=error
+  [
+    'test',
+    (exitCode, _stdout, _stderr) => ({
+      isError: exitCode >= 2,
+      message: exitCode === 1 ? 'Condition is false' : undefined,
+    }),
+  ],
+
+  // [ is an alias for test
+  [
+    '[',
+    (exitCode, _stdout, _stderr) => ({
+      isError: exitCode >= 2,
+      message: exitCode === 1 ? 'Condition is false' : undefined,
+    }),
+  ],
+
+  // wc, head, tail, cat, etc.: these typically only fail on real errors
+  // so we use default semantics
+])
+
+/**
+ * Get the semantic interpretation for a command
+ */
+function getCommandSemantic(command: string): CommandSemantic {
+  // Extract the base command (first word, handling pipes)
+  const baseCommand = heuristicallyExtractBaseCommand(command)
+  const semantic = COMMAND_SEMANTICS.get(baseCommand)
+  return semantic !== undefined ? semantic : DEFAULT_SEMANTIC
+}
+
+/**
+ * Extract just the command name (first word) from a single command string.
+ */
+function extractBaseCommand(command: string): string {
+  return command.trim().split(/\s+/)[0] || ''
+}
+
+/**
+ * Extract the primary command from a complex command line;
+ * May get it super wrong - don't depend on this for security
+ */
+function heuristicallyExtractBaseCommand(command: string): string {
+  const segments = splitCommand_DEPRECATED(command)
+
+  // Take the last command as that's what determines the exit code
+  const lastCommand = segments[segments.length - 1] || command
+
+  return extractBaseCommand(lastCommand)
+}
+
+/**
+ * Interpret command result based on semantic rules
+ */
+export function interpretCommandResult(
+  command: string,
+  exitCode: number,
+  stdout: string,
+  stderr: string,
+): {
+  isError: boolean
+  message?: string
+} {
+  const semantic = getCommandSemantic(command)
+  const result = semantic(exitCode, stdout, stderr)
+
+  return {
+    isError: result.isError,
+    message: result.message,
+  }
+}