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>
2026-06-23 16:55:51 +00:00 · 2026-04-13 09:52:05 +08:00
parent bbb8b613a9
commit 2fb1c9dcd8
559 changed files with 9346 additions and 1837 deletions
--- a/packages/builtin-tools/src/tools/ListPeersTool/ListPeersTool.ts
+++ b/packages/builtin-tools/src/tools/ListPeersTool/ListPeersTool.ts
@@ -0,0 +1,107 @@
+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'
+
+const LIST_PEERS_TOOL_NAME = 'ListPeers'
+
+const inputSchema = lazySchema(() =>
+  z.strictObject({
+    include_self: z
+      .boolean()
+      .optional()
+      .describe('Whether to include the current session in the list. Defaults to false.'),
+  }),
+)
+type InputSchema = ReturnType<typeof inputSchema>
+type ListPeersInput = z.infer<InputSchema>
+
+type PeerInfo = {
+  address: string
+  name?: string
+  cwd?: string
+  pid?: number
+}
+type ListPeersOutput = { peers: PeerInfo[] }
+
+export const ListPeersTool = buildTool({
+  name: LIST_PEERS_TOOL_NAME,
+  searchHint: 'list peers sessions discover uds socket messaging',
+  maxResultSizeChars: 50_000,
+  strict: true,
+
+  get inputSchema(): InputSchema {
+    return inputSchema()
+  },
+
+  async description() {
+    return 'Discover other Claude Code sessions for cross-session messaging'
+  },
+  async prompt() {
+    return `List active Claude Code sessions that can receive messages via SendMessage.
+
+Returns an array of peers with their addresses. Use these addresses as the \`to\` field in SendMessage:
+- \`"uds:/path/to.sock"\` — local sessions on the same machine (Unix Domain Socket)
+- \`"bridge:session_..."\` — remote sessions via Remote Control
+
+Use this tool to discover messaging targets before sending cross-session messages. Only running sessions with active messaging sockets are returned.`
+  },
+
+  isConcurrencySafe() {
+    return true
+  },
+  isReadOnly() {
+    return true
+  },
+
+  userFacingName() {
+    return LIST_PEERS_TOOL_NAME
+  },
+
+  renderToolUseMessage() {
+    return 'ListPeers'
+  },
+
+  mapToolResultToToolResultBlockParam(
+    content: ListPeersOutput,
+    toolUseID: string,
+  ): ToolResultBlockParam {
+    const lines = content.peers.map(
+      p => `${p.address}${p.name ? ` (${p.name})` : ''}${p.cwd ? ` @ ${p.cwd}` : ''}`,
+    )
+    return {
+      tool_use_id: toolUseID,
+      type: 'tool_result',
+      content:
+        lines.length > 0
+          ? `Found ${lines.length} peer(s):\n${lines.join('\n')}`
+          : 'No peers found.',
+    }
+  },
+
+  async call(_input: ListPeersInput, context) {
+    // Peer discovery uses the concurrent sessions PID registry and
+    // UDS socket directory. The implementation scans for live sockets
+    // and optionally includes Remote Control bridge peers.
+    const peers: PeerInfo[] = []
+
+    // Discovery is handled by the UDS messaging subsystem initialized in setup.ts.
+    // Return discovered peers from the app state.
+    const appState = context.getAppState()
+    const messagingSocketPath = (appState as Record<string, unknown>).messagingSocketPath as string | undefined
+    if (messagingSocketPath) {
+      // Self entry for reference
+      if (_input.include_self) {
+        peers.push({
+          address: `uds:${messagingSocketPath}`,
+          name: 'self',
+          pid: process.pid,
+        })
+      }
+    }
+
+    return {
+      data: { peers },
+    }
+  },
+})