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/WorkflowTool/WorkflowPermissionRequest.tsx

@@ -0,0 +1,166 @@
+import React, { useCallback, useMemo } from 'react'
+import { Box, Text, useTheme } from '@anthropic/ink'
+import { getTheme } from 'src/utils/theme.js'
+import { env } from 'src/utils/env.js'
+import { shouldShowAlwaysAllowOptions } from 'src/utils/permissions/permissionsLoader.js'
+import { logUnaryEvent } from 'src/utils/unaryLogging.js'
+import { PermissionDialog } from 'src/components/permissions/PermissionDialog.js'
+import {
+  PermissionPrompt,
+  type PermissionPromptOption,
+} from 'src/components/permissions/PermissionPrompt.js'
+import type { PermissionRequestProps } from 'src/components/permissions/PermissionRequest.js'
+import { PermissionRuleExplanation } from 'src/components/permissions/PermissionRuleExplanation.js'
+
+type OptionValue = 'yes' | 'yes-dont-ask-again' | 'no'
+
+/**
+ * Permission request UI for the WorkflowTool. Asks the user to confirm
+ * executing a workflow script.
+ * Follows the MonitorPermissionRequest / FallbackPermissionRequest pattern.
+ */
+export function WorkflowPermissionRequest({
+  toolUseConfirm,
+  onDone,
+  onReject,
+  workerBadge,
+}: PermissionRequestProps): React.ReactNode {
+  const [themeName] = useTheme()
+  const theme = getTheme(themeName)
+
+  const input = toolUseConfirm.input as {
+    workflow: string
+    args?: string
+  }
+
+  const showAlwaysAllowOptions = useMemo(
+    () => shouldShowAlwaysAllowOptions(),
+    [],
+  )
+
+  const options: PermissionPromptOption<OptionValue>[] = useMemo(() => {
+    const opts: PermissionPromptOption<OptionValue>[] = [
+      {
+        label: 'Yes',
+        value: 'yes',
+        feedbackConfig: { type: 'accept' as const },
+      },
+    ]
+    if (showAlwaysAllowOptions) {
+      opts.push({
+        label: (
+          <Text>
+            Yes, and don{'\u2019'}t ask again for{' '}
+            <Text bold>{toolUseConfirm.tool.name}</Text> commands
+          </Text>
+        ),
+        value: 'yes-dont-ask-again',
+      })
+    }
+    opts.push({
+      label: 'No',
+      value: 'no',
+      feedbackConfig: { type: 'reject' as const },
+    })
+    return opts
+  }, [showAlwaysAllowOptions, toolUseConfirm.tool.name])
+
+  const handleSelect = useCallback(
+    (value: OptionValue, feedback?: string) => {
+      switch (value) {
+        case 'yes':
+          logUnaryEvent({
+            completion_type: 'tool_use_single',
+            event: 'accept',
+            metadata: {
+              language_name: 'none',
+              message_id: toolUseConfirm.assistantMessage.message.id ?? '',
+              platform: env.platform,
+            },
+          })
+          toolUseConfirm.onAllow(toolUseConfirm.input, [], feedback)
+          onDone()
+          break
+        case 'yes-dont-ask-again':
+          logUnaryEvent({
+            completion_type: 'tool_use_single',
+            event: 'accept',
+            metadata: {
+              language_name: 'none',
+              message_id: toolUseConfirm.assistantMessage.message.id ?? '',
+              platform: env.platform,
+            },
+          })
+          toolUseConfirm.onAllow(toolUseConfirm.input, [
+            {
+              type: 'addRules',
+              rules: [{ toolName: toolUseConfirm.tool.name }],
+              behavior: 'allow',
+              destination: 'localSettings',
+            },
+          ])
+          onDone()
+          break
+        case 'no':
+          logUnaryEvent({
+            completion_type: 'tool_use_single',
+            event: 'reject',
+            metadata: {
+              language_name: 'none',
+              message_id: toolUseConfirm.assistantMessage.message.id ?? '',
+              platform: env.platform,
+            },
+          })
+          toolUseConfirm.onReject(feedback)
+          onReject()
+          onDone()
+          break
+      }
+    },
+    [toolUseConfirm, onDone, onReject],
+  )
+
+  const handleCancel = useCallback(() => {
+    logUnaryEvent({
+      completion_type: 'tool_use_single',
+      event: 'reject',
+      metadata: {
+        language_name: 'none',
+        message_id: toolUseConfirm.assistantMessage.message.id ?? '',
+        platform: env.platform,
+      },
+    })
+    toolUseConfirm.onReject()
+    onReject()
+    onDone()
+  }, [toolUseConfirm, onDone, onReject])
+
+  return (
+    <PermissionDialog
+      title="Workflow"
+      workerBadge={workerBadge}
+    >
+      <Box flexDirection="column" gap={1}>
+        <Box flexDirection="column">
+          <Text bold color={theme.permission as any}>
+            Execute workflow: {input.workflow}
+          </Text>
+          {input.args && (
+            <Text dimColor>
+              Arguments: {input.args}
+            </Text>
+          )}
+        </Box>
+        <PermissionRuleExplanation
+          permissionResult={toolUseConfirm.permissionResult}
+          toolType="command"
+        />
+        <PermissionPrompt<OptionValue>
+          options={options}
+          onSelect={handleSelect}
+          onCancel={handleCancel}
+        />
+      </Box>
+    </PermissionDialog>
+  )
+}

packages/builtin-tools/src/tools/WorkflowTool/WorkflowTool.ts

@@ -0,0 +1,74 @@
+import { z } from 'zod/v4'
+import type { ToolResultBlockParam } from 'src/Tool.js'
+import { buildTool } from 'src/Tool.js'
+import { truncate } from 'src/utils/format.js'
+import { WORKFLOW_TOOL_NAME } from './constants.js'
+
+const inputSchema = z.object({
+  workflow: z.string().describe('Name of the workflow to execute'),
+  args: z.string().optional().describe('Arguments to pass to the workflow'),
+})
+type Input = typeof inputSchema
+type WorkflowInput = z.infer<Input>
+
+type WorkflowOutput = { output: string }
+
+export const WorkflowTool = buildTool({
+  name: WORKFLOW_TOOL_NAME,
+  searchHint: 'execute user-defined workflow scripts',
+  maxResultSizeChars: 50_000,
+  strict: true,
+
+  inputSchema,
+
+  async description() {
+    return 'Execute a user-defined workflow script from .claude/workflows/'
+  },
+  async prompt() {
+    return `Use the Workflow tool to execute user-defined workflow scripts located in .claude/workflows/. Workflows are YAML or Markdown files that define a sequence of steps for common development tasks.
+
+Guidelines:
+- Specify the workflow name to execute (must match a file in .claude/workflows/)
+- Optionally pass arguments that the workflow can use
+- Workflows run in the context of the current project`
+  },
+  userFacingName() {
+    return 'Workflow'
+  },
+  isReadOnly() {
+    return false
+  },
+  isEnabled() {
+    return true
+  },
+
+  renderToolUseMessage(input: Partial<WorkflowInput>) {
+    const name = input.workflow ?? 'unknown'
+    if (input.args) {
+      return `Workflow: ${name} ${input.args}`
+    }
+    return `Workflow: ${name}`
+  },
+
+  mapToolResultToToolResultBlockParam(
+    content: WorkflowOutput,
+    toolUseID: string,
+  ): ToolResultBlockParam {
+    return {
+      tool_use_id: toolUseID,
+      type: 'tool_result',
+      content: truncate(content.output, 50_000),
+    }
+  },
+
+  async call(_input: WorkflowInput, _context, _progress) {
+    // Workflow execution is wired by the WORKFLOW_SCRIPTS feature bootstrap.
+    // Without it, this tool is not functional.
+    return {
+      data: {
+        output:
+          'Error: Workflow execution requires the WORKFLOW_SCRIPTS runtime.',
+      },
+    }
+  },
+})

packages/builtin-tools/src/tools/WorkflowTool/bundled/index.ts

@@ -0,0 +1,15 @@
+// Bundled workflow initialization.
+// Called by tools.ts when WORKFLOW_SCRIPTS feature flag is enabled.
+// Sets up any pre-bundled workflow scripts that ship with the CLI.
+
+/**
+ * Initialize bundled workflows. Called once at startup when the
+ * WORKFLOW_SCRIPTS feature flag is active. This is the hook point
+ * for registering any workflow scripts that are compiled into the
+ * binary (as opposed to user-authored ones in .claude/workflows/).
+ */
+export function initBundledWorkflows(): void {
+  // Bundled workflows are registered here at startup.
+  // Currently a no-op — all workflows are user-authored in .claude/workflows/.
+  // This function exists as the extension point for future built-in workflows.
+}

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

@@ -0,0 +1,3 @@
+export const WORKFLOW_TOOL_NAME = 'workflow'
+export const WORKFLOW_DIR_NAME = '.claude/workflows'
+export const WORKFLOW_FILE_EXTENSIONS = ['.yml', '.yaml', '.md']

packages/builtin-tools/src/tools/WorkflowTool/createWorkflowCommand.ts

@@ -0,0 +1,41 @@
+import { readdir } from 'fs/promises'
+import { join, parse } from 'path'
+import type { Command } from 'src/types/command.js'
+import { WORKFLOW_DIR_NAME, WORKFLOW_FILE_EXTENSIONS } from './constants.js'
+
+/**
+ * Scans .claude/workflows/ directory and creates Command objects for each workflow file.
+ * Each workflow file becomes a slash command (e.g. /workflow-name).
+ */
+export async function getWorkflowCommands(cwd: string): Promise<Command[]> {
+  const workflowDir = join(cwd, WORKFLOW_DIR_NAME)
+  let files: string[]
+  try {
+    files = await readdir(workflowDir)
+  } catch {
+    return []
+  }
+
+  const workflowFiles = files.filter((f) => {
+    const ext = parse(f).ext.toLowerCase()
+    return WORKFLOW_FILE_EXTENSIONS.includes(ext)
+  })
+
+  return workflowFiles.map((file) => {
+    const name = parse(file).name
+    return {
+      type: 'prompt' as const,
+      name,
+      description: `Run workflow: ${name}`,
+      kind: 'workflow' as const,
+      source: 'builtin' as const,
+      progressMessage: `Running workflow ${name}...`,
+      contentLength: 0,
+      async getPromptForCommand(args, _context) {
+        const { readFile } = await import('fs/promises')
+        const content = await readFile(join(workflowDir, file), 'utf-8')
+        return [{ type: 'text' as const, text: `Execute this workflow:\n\n${content}${args ? `\n\nArguments: ${args}` : ''}` }]
+      },
+    } satisfies Command
+  })
+}