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/builtin-tools/src/tools/TeamDeleteTool/TeamDeleteTool.ts

@@ -0,0 +1,139 @@
+import { z } from 'zod/v4'
+import { logEvent } from 'src/services/analytics/index.js'
+import type { AnalyticsMetadata_I_VERIFIED_THIS_IS_NOT_CODE_OR_FILEPATHS } from 'src/services/analytics/metadata.js'
+import type { Tool } from 'src/Tool.js'
+import { buildTool, type ToolDef } from 'src/Tool.js'
+import { isAgentSwarmsEnabled } from 'src/utils/agentSwarmsEnabled.js'
+import { lazySchema } from 'src/utils/lazySchema.js'
+import { jsonStringify } from 'src/utils/slowOperations.js'
+import { TEAM_LEAD_NAME } from 'src/utils/swarm/constants.js'
+import {
+  cleanupTeamDirectories,
+  readTeamFile,
+  unregisterTeamForSessionCleanup,
+} from 'src/utils/swarm/teamHelpers.js'
+import { clearTeammateColors } from 'src/utils/swarm/teammateLayoutManager.js'
+import { clearLeaderTeamName } from 'src/utils/tasks.js'
+import { TEAM_DELETE_TOOL_NAME } from './constants.js'
+import { getPrompt } from './prompt.js'
+import { renderToolResultMessage, renderToolUseMessage } from './UI.js'
+
+const inputSchema = lazySchema(() => z.strictObject({}))
+type InputSchema = ReturnType<typeof inputSchema>
+
+export type Output = {
+  success: boolean
+  message: string
+  team_name?: string
+}
+
+export type Input = z.infer<InputSchema>
+
+export const TeamDeleteTool: Tool<InputSchema, Output> = buildTool({
+  name: TEAM_DELETE_TOOL_NAME,
+  searchHint: 'disband a swarm team and clean up',
+  maxResultSizeChars: 100_000,
+  shouldDefer: true,
+
+  userFacingName() {
+    return ''
+  },
+
+  get inputSchema(): InputSchema {
+    return inputSchema()
+  },
+
+  isEnabled() {
+    return isAgentSwarmsEnabled()
+  },
+
+  async description() {
+    return 'Clean up team and task directories when the swarm is complete'
+  },
+
+  async prompt() {
+    return getPrompt()
+  },
+
+  mapToolResultToToolResultBlockParam(data, toolUseID) {
+    return {
+      tool_use_id: toolUseID,
+      type: 'tool_result' as const,
+      content: [
+        {
+          type: 'text' as const,
+          text: jsonStringify(data),
+        },
+      ],
+    }
+  },
+
+  async call(_input, context) {
+    const { setAppState, getAppState } = context
+    const appState = getAppState()
+    const teamName = appState.teamContext?.teamName
+
+    if (teamName) {
+      // Read team config to check for active members
+      const teamFile = readTeamFile(teamName)
+      if (teamFile) {
+        // Filter out the team lead - only count non-lead members
+        const nonLeadMembers = teamFile.members.filter(
+          m => m.name !== TEAM_LEAD_NAME,
+        )
+
+        // Separate truly active members from idle/dead ones
+        // Members with isActive === false are idle (finished their turn or crashed)
+        const activeMembers = nonLeadMembers.filter(m => m.isActive !== false)
+
+        if (activeMembers.length > 0) {
+          const memberNames = activeMembers.map(m => m.name).join(', ')
+          return {
+            data: {
+              success: false,
+              message: `Cannot cleanup team with ${activeMembers.length} active member(s): ${memberNames}. Use requestShutdown to gracefully terminate teammates first.`,
+              team_name: teamName,
+            },
+          }
+        }
+      }
+
+      await cleanupTeamDirectories(teamName)
+      // Already cleaned — don't try again on gracefulShutdown.
+      unregisterTeamForSessionCleanup(teamName)
+
+      // Clear color assignments so new teams start fresh
+      clearTeammateColors()
+
+      // Clear leader team name so getTaskListId() falls back to session ID
+      clearLeaderTeamName()
+
+      logEvent('tengu_team_deleted', {
+        team_name:
+          teamName as AnalyticsMetadata_I_VERIFIED_THIS_IS_NOT_CODE_OR_FILEPATHS,
+      })
+    }
+
+    // Clear team context and inbox from app state
+    setAppState(prev => ({
+      ...prev,
+      teamContext: undefined,
+      inbox: {
+        messages: [], // Clear any queued messages
+      },
+    }))
+
+    return {
+      data: {
+        success: true,
+        message: teamName
+          ? `Cleaned up directories and worktrees for team "${teamName}"`
+          : 'No team name found, nothing to clean up',
+        team_name: teamName,
+      },
+    }
+  },
+
+  renderToolUseMessage,
+  renderToolResultMessage,
+} satisfies ToolDef<InputSchema, Output>)

packages/builtin-tools/src/tools/TeamDeleteTool/UI.tsx

@@ -0,0 +1,25 @@
+import React from 'react'
+import { jsonParse } from 'src/utils/slowOperations.js'
+import type { Output } from './TeamDeleteTool.js'
+
+export function renderToolUseMessage(
+  _input: Record<string, unknown>,
+): React.ReactNode {
+  return 'cleanup team: current'
+}
+
+export function renderToolResultMessage(
+  content: Output | string,
+  _progressMessages: unknown,
+  { verbose: _verbose }: { verbose: boolean },
+): React.ReactNode {
+  const result: Output =
+    typeof content === 'string' ? jsonParse(content) : content
+
+  // Suppress cleanup result - the batched shutdown message covers this
+  if ('success' in result && 'team_name' in result && 'message' in result) {
+    return null
+  }
+
+  return null
+}

packages/builtin-tools/src/tools/TeamDeleteTool/constants.ts

@@ -0,0 +1 @@
+export const TEAM_DELETE_TOOL_NAME = 'TeamDelete'

packages/builtin-tools/src/tools/TeamDeleteTool/prompt.ts

@@ -0,0 +1,16 @@
+export function getPrompt(): string {
+  return `
+# TeamDelete
+
+Remove team and task directories when the swarm work is complete.
+
+This operation:
+- Removes the team directory (\`~/.claude/teams/{team-name}/\`)
+- Removes the task directory (\`~/.claude/tasks/{team-name}/\`)
+- Clears team context from the current session
+
+**IMPORTANT**: TeamDelete will fail if the team still has active members. Gracefully terminate teammates first, then call TeamDelete after all teammates have shut down.
+
+Use this when all teammates have finished their work and you want to clean up the team resources. The team name is automatically determined from the current session's team context.
+`.trim()
+}