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/ReviewArtifactTool/ReviewArtifactTool.ts

@@ -0,0 +1,142 @@
+import { z } from 'zod/v4'
+import { buildTool, type ToolDef } from 'src/Tool.js'
+import { lazySchema } from 'src/utils/lazySchema.js'
+import React from 'react'
+import { Box, Text } from '@anthropic/ink'
+
+const REVIEW_ARTIFACT_TOOL_NAME = 'ReviewArtifact'
+
+const DESCRIPTION =
+  'Review an artifact (code snippet, document, or other content) with inline annotations and feedback.'
+
+const inputSchema = lazySchema(() =>
+  z.strictObject({
+    artifact: z
+      .string()
+      .describe(
+        'The content of the artifact to review (code snippet, document text, etc.).',
+      ),
+    title: z
+      .string()
+      .optional()
+      .describe(
+        'Optional title or file path for the artifact being reviewed.',
+      ),
+    annotations: z
+      .array(
+        z.object({
+          line: z.number().optional().describe('Line number for the annotation (1-based).'),
+          message: z.string().describe('The annotation or feedback message.'),
+          severity: z
+            .enum(['info', 'warning', 'error', 'suggestion'])
+            .optional()
+            .describe('Severity level of the annotation.'),
+        }),
+      )
+      .describe('List of annotations/comments on the artifact.'),
+    summary: z
+      .string()
+      .optional()
+      .describe('An overall summary of the review.'),
+  }),
+)
+type InputSchema = ReturnType<typeof inputSchema>
+
+const outputSchema = lazySchema(() =>
+  z.object({
+    artifact: z.string().describe('The reviewed artifact content.'),
+    title: z.string().optional().describe('Title of the reviewed artifact.'),
+    annotationCount: z
+      .number()
+      .describe('Number of annotations applied.'),
+    summary: z.string().optional().describe('Summary of the review.'),
+  }),
+)
+type OutputSchema = ReturnType<typeof outputSchema>
+
+export type Output = z.infer<OutputSchema>
+
+export const ReviewArtifactTool = buildTool({
+  name: REVIEW_ARTIFACT_TOOL_NAME,
+  searchHint: 'review code or documents with inline annotations',
+  maxResultSizeChars: 100_000,
+  async description(input) {
+    const { title } = input as { title?: string }
+    return title
+      ? `Claude wants to review: ${title}`
+      : 'Claude wants to review an artifact'
+  },
+  userFacingName() {
+    return 'ReviewArtifact'
+  },
+  get inputSchema(): InputSchema {
+    return inputSchema()
+  },
+  get outputSchema(): OutputSchema {
+    return outputSchema()
+  },
+  isConcurrencySafe() {
+    return true
+  },
+  isReadOnly() {
+    return true
+  },
+  toAutoClassifierInput(input) {
+    return input.title ?? input.artifact.slice(0, 200)
+  },
+  async prompt() {
+    return `Use this tool to present a review of a code snippet, document, or other artifact with inline annotations and feedback. Each annotation can target a specific line and include a severity level. ${DESCRIPTION}`
+  },
+  mapToolResultToToolResultBlockParam(output, toolUseID) {
+    return {
+      tool_use_id: toolUseID,
+      type: 'tool_result',
+      content: `Review delivered with ${output.annotationCount} annotation(s).${output.summary ? ` Summary: ${output.summary}` : ''}`,
+    }
+  },
+  renderToolUseMessage(
+    input: Partial<z.infer<InputSchema>>,
+    { verbose }: { theme?: string; verbose: boolean },
+  ): React.ReactNode {
+    const title = input.title ?? 'Untitled artifact'
+    const count = input.annotations?.length ?? 0
+    if (verbose) {
+      return `Review: "${title}" (${count} annotation(s))`
+    }
+    return title
+  },
+  renderToolResultMessage(
+    output: Output,
+    _progressMessages: unknown[],
+    { verbose }: { verbose: boolean },
+  ): React.ReactNode {
+    if (verbose) {
+      return React.createElement(
+        Box,
+        { flexDirection: 'column' },
+        React.createElement(
+          Text,
+          null,
+          `Reviewed artifact: ${output.title ?? 'Untitled'} (${output.annotationCount} annotations)`,
+        ),
+        output.summary
+          ? React.createElement(Text, { dimColor: true }, output.summary)
+          : null,
+      )
+    }
+    return React.createElement(
+      Text,
+      null,
+      `Review complete: ${output.annotationCount} annotation(s)`,
+    )
+  },
+  async call({ artifact, title, annotations, summary }, _context) {
+    const output: Output = {
+      artifact,
+      title,
+      annotationCount: annotations.length,
+      summary,
+    }
+    return { data: output }
+  },
+} satisfies ToolDef<InputSchema, Output>)