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>

packages/mcp-client/src/__tests__/strings.test.ts

@@ -0,0 +1,101 @@
+import { describe, expect, test } from 'bun:test'
+import {
+  buildMcpToolName,
+  normalizeNameForMCP,
+  mcpInfoFromString,
+  getMcpPrefix,
+  getToolNameForPermissionCheck,
+  getMcpDisplayName,
+  extractMcpToolDisplayName,
+} from '../strings.js'
+
+describe('normalizeNameForMCP', () => {
+  test('keeps valid names unchanged', () => {
+    expect(normalizeNameForMCP('my-server')).toBe('my-server')
+    expect(normalizeNameForMCP('my_server')).toBe('my_server')
+    expect(normalizeNameForMCP('server123')).toBe('server123')
+  })
+
+  test('replaces dots and spaces with underscores', () => {
+    expect(normalizeNameForMCP('test.server')).toBe('test_server')
+    expect(normalizeNameForMCP('test server')).toBe('test_server')
+  })
+
+  test('collapses underscores for claude.ai prefix', () => {
+    expect(normalizeNameForMCP('claude.ai Slack')).toBe('claude_ai_Slack')
+    expect(normalizeNameForMCP('claude.ai My Server')).toBe('claude_ai_My_Server')
+  })
+})
+
+describe('buildMcpToolName', () => {
+  test('builds fully qualified name', () => {
+    expect(buildMcpToolName('my-server', 'query')).toBe('mcp__my-server__query')
+  })
+
+  test('normalizes server name with dots', () => {
+    expect(buildMcpToolName('test.server', 'tool')).toBe('mcp__test_server__tool')
+  })
+})
+
+describe('mcpInfoFromString', () => {
+  test('parses valid MCP tool name', () => {
+    const info = mcpInfoFromString('mcp__my-server__query')
+    expect(info).toEqual({ serverName: 'my-server', toolName: 'query' })
+  })
+
+  test('returns null for non-MCP names', () => {
+    expect(mcpInfoFromString('bash')).toBeNull()
+    expect(mcpInfoFromString('mcp__')).toBeNull()
+    expect(mcpInfoFromString('')).toBeNull()
+  })
+
+  test('handles tool names with double underscores', () => {
+    const info = mcpInfoFromString('mcp__server__tool__part')
+    expect(info).toEqual({ serverName: 'server', toolName: 'tool__part' })
+  })
+
+  test('handles server-only (no tool name)', () => {
+    const info = mcpInfoFromString('mcp__server')
+    expect(info).toEqual({ serverName: 'server', toolName: undefined })
+  })
+})
+
+describe('getMcpPrefix', () => {
+  test('returns correct prefix', () => {
+    expect(getMcpPrefix('my-server')).toBe('mcp__my-server__')
+  })
+})
+
+describe('getToolNameForPermissionCheck', () => {
+  test('uses mcp prefix for MCP tools', () => {
+    expect(getToolNameForPermissionCheck({
+      name: 'query',
+      mcpInfo: { serverName: 'my-server', toolName: 'query' },
+    })).toBe('mcp__my-server__query')
+  })
+
+  test('uses raw name for non-MCP tools', () => {
+    expect(getToolNameForPermissionCheck({ name: 'bash' })).toBe('bash')
+  })
+})
+
+describe('getMcpDisplayName', () => {
+  test('strips MCP prefix', () => {
+    // getMcpDisplayName normalizes server name before building prefix
+    expect(getMcpDisplayName('mcp__my_server__query', 'my.server')).toBe('query')
+  })
+})
+
+describe('extractMcpToolDisplayName', () => {
+  test('removes MCP suffix', () => {
+    expect(extractMcpToolDisplayName('github - Add comment (MCP)')).toBe('Add comment')
+  })
+
+  test('handles no dash', () => {
+    expect(extractMcpToolDisplayName('Add comment (MCP)')).toBe('Add comment')
+  })
+
+  test('handles no suffix', () => {
+    expect(extractMcpToolDisplayName('github - Add comment')).toBe('Add comment')
+  })
+})