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

@@ -0,0 +1,84 @@
+import { z } from 'zod/v4'
+import type { ToolResultBlockParam } from 'src/Tool.js'
+import { buildTool } from 'src/Tool.js'
+import { lazySchema } from 'src/utils/lazySchema.js'
+import { SEND_USER_FILE_TOOL_NAME } from './prompt.js'
+
+const inputSchema = lazySchema(() =>
+  z.strictObject({
+    file_path: z
+      .string()
+      .describe('Absolute path to the file to send to the user.'),
+    description: z
+      .string()
+      .optional()
+      .describe('Optional description of the file being sent.'),
+  }),
+)
+type InputSchema = ReturnType<typeof inputSchema>
+type SendUserFileInput = z.infer<InputSchema>
+
+type SendUserFileOutput = { sent: boolean; file_path: string }
+
+export const SendUserFileTool = buildTool({
+  name: SEND_USER_FILE_TOOL_NAME,
+  searchHint: 'send file to user mobile device upload share',
+  maxResultSizeChars: 5_000,
+  strict: true,
+
+  get inputSchema(): InputSchema {
+    return inputSchema()
+  },
+
+  async description() {
+    return 'Send a file to the user (KAIROS assistant mode)'
+  },
+  async prompt() {
+    return `Send a file to the user's device. Use this in assistant mode when the user requests a file or when a file is relevant to the conversation.
+
+Guidelines:
+- Use absolute paths
+- The file must exist and be readable
+- Large files may take time to transfer`
+  },
+
+  isConcurrencySafe() {
+    return true
+  },
+  isReadOnly() {
+    return true
+  },
+
+  userFacingName() {
+    return 'SendFile'
+  },
+
+  renderToolUseMessage(input: Partial<SendUserFileInput>) {
+    return `Send file: ${input.file_path ?? '...'}`
+  },
+
+  mapToolResultToToolResultBlockParam(
+    content: SendUserFileOutput,
+    toolUseID: string,
+  ): ToolResultBlockParam {
+    return {
+      tool_use_id: toolUseID,
+      type: 'tool_result',
+      content: content.sent
+        ? `File sent: ${content.file_path}`
+        : `Failed to send file: ${content.file_path}`,
+    }
+  },
+
+  async call(_input: SendUserFileInput) {
+    // File transfer is handled by the KAIROS assistant transport layer.
+    // Without the KAIROS runtime, this tool is not available.
+    return {
+      data: {
+        sent: false,
+        file_path: _input.file_path,
+        error: 'SendUserFile requires the KAIROS assistant transport layer.',
+      },
+    }
+  },
+})