// 架构解读,非源码转录。基于本地反混淆源 claude-code 2.1.88, src/tools/ 下 40 个工具目录。
// 每个工具都是 [01-Tool 抽象](/articles/sourcecode/claude-code/01-tool-抽象) 里 Tool<Input,Output>
// 的实现,经 buildTool 补默认值后由 src/tools.ts 的 getAllBaseTools() 汇入工具表。按职责分六类:

// ============ 一、文件读写 ============
FileReadTool      // 读文件/图片/PDF/notebook;输出被 maxTokens 自限,maxResultSizeChars=Infinity(见下)
FileEditTool      // 精确字符串替换;validateInput 查 readFileState,没 Read 过直接拒
FileWriteTool     // 覆盖写整个文件
NotebookEditTool  // 改 .ipynb 单元格;searchHint 里塞进名字里没有的 'Jupyter'

// ============ 二、搜索定位 ============
GlobTool  // 文件名模式;isSearchOrReadCommand()={isSearch:true},UI 据此折叠成一行
GrepTool  // 内容搜索,底层 utils/ripgrep.ts 起 rg 子进程(system/builtin/embedded 三种来源)
LSPTool   // 语言服务器(ENABLE_LSP_TOOL 门控);LSP 没初始化完时被临时 defer(shouldDeferLspTool)

// ============ 三、命令执行 ============
BashTool        // isConcurrencySafe 委托 isReadOnly:只读命令也能并发,写命令才串行
PowerShellTool  // Windows 下按 isPowerShellToolEnabled() 加载
REPLTool        // ant 内部构建才有;把 Read/Edit 等原语包进 VM,启用时原语从表里隐藏(REPL_ONLY_TOOLS)

// ============ 四、任务/进程(见 [05-任务与子代理](/articles/sourcecode/claude-code/05-任务与子代理)) ============
TaskCreateTool TaskGetTool TaskListTool TaskUpdateTool  // 任务清单 v2(isTodoV2Enabled 门控)
TaskOutputTool TaskStopTool  // 后台任务取输出/停止
AgentTool          // 派生子代理跑多步任务
ScheduleCronTool/  // 目录下实为 CronCreateTool/CronDeleteTool/CronListTool 三个工具(AGENT_TRIGGERS 门控)
SleepTool RemoteTriggerTool SyntheticOutputTool  // 均 feature() 门控;Synthetic 不进常规工具表

// ============ 五、协作 ============
SendMessageTool                // 跨 agent 消息
TeamCreateTool TeamDeleteTool  // agent 团队(isAgentSwarmsEnabled 门控)
AskUserQuestionTool            // 只有用户能定的决策抛回给用户
TodoWriteTool                  // 结果只更新面板不进 transcript,故整个工具没有 renderToolResultMessage

// ============ 六、扩展/外部 ============
WebFetchTool WebSearchTool
MCPTool ListMcpResourcesTool ReadMcpResourceTool McpAuthTool  // MCP 工具一律 defer(isDeferredTool)
SkillTool          // 调用打包好的技能
ToolSearchTool     // 把被 defer 的工具按名字/关键词捞出来(见下)
EnterPlanModeTool ExitPlanModeTool  // 计划模式;实际注册进表的是 ExitPlanModeV2Tool
EnterWorktreeTool ExitWorktreeTool  // git worktree 隔离(isWorktreeModeEnabled 门控)
ConfigTool BriefTool  // 配置(ant-only) / 简报
// (shared/ testing/ utils.ts 是工具间共用代码,不是工具)

// 基于本地反混淆源 claude-code 2.1.88, src/Tool.ts
export type Tool<Input, Output> = {
  isConcurrencySafe(input: z.infer<Input>): boolean   // 按"这次输入"判定,不是工具级常量
  isReadOnly(input: z.infer<Input>): boolean
  maxResultSizeChars: number                          // 结果落盘阈值,超了只回预览+文件路径

  readonly shouldDefer?: boolean   // true→首轮不发 schema,要模型先用 ToolSearch 捞
  readonly alwaysLoad?: boolean    // 强制首轮带全 schema;MCP 工具经 _meta['anthropic/alwaysLoad'] 设
  searchHint?: string              // 3-10 词能力短语,给 ToolSearch 关键词打分用
  // ...
}

// 同文件 TOOL_DEFAULTS——buildTool 补的默认值,fail-closed:
const TOOL_DEFAULTS = {
  isConcurrencySafe: (_input?: unknown) => false,   // 忘实现→当不可并发,只慢不危险
  isReadOnly: (_input?: unknown) => false,          // 忘实现→当会写,按最严的审
  isDestructive: (_input?: unknown) => false,
  // ...
}

// 基于本地反混淆源 claude-code 2.1.88(签名级片段)
// src/services/tools/toolOrchestration.ts——相邻且都并发安全的调用合并成一批
type Batch = { isConcurrencySafe: boolean; blocks: ToolUseBlock[] }
parseInt(process.env.CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY || '', 10) || 10  // 并发上限,默认 10

// src/tools/BashTool/BashTool.tsx——Bash 的并发安全不是写死 false
const BashTool = buildTool({
  isConcurrencySafe(input) {
    return this.isReadOnly?.(input) ?? false;   // 静态解析命令:纯读命令可与其他读并发
  },
  // ...
})

// src/tools/FileReadTool/FileReadTool.ts——唯一设 Infinity 的落盘阈值,注释为原文
// Output is bounded by maxTokens (validateContentTokens). Persisting to a
// file the model reads back with Read is circular — never persist.
maxResultSizeChars: Infinity,

// src/tools/ToolSearchTool/prompt.ts——isDeferredTool 的判定顺序(中间省略若干特例)
if (tool.alwaysLoad === true) return false   // 显式豁免最优先
if (tool.isMcp === true) return true         // MCP 工具一律 defer
return tool.shouldDefer === true             // 内置工具看自己声明

// src/utils/toolResultStorage.ts——落盘后回给模型的预览大小
export const PREVIEW_SIZE_BYTES = 2000