feat: 支持 SearchExtraTools 能力以替代 Tool Search

CLAUDE.md

@@ -123,6 +123,7 @@ bun run docs:dev
 
 - **`src/Tool.ts`** — Tool interface definition (`Tool` type) and utilities (`findToolByName`, `toolMatchesName`).
 - **`src/tools.ts`** — Tool registry. Assembles the tool list; tools are imported from `@claude-code-best/builtin-tools` package. Some tools are conditionally loaded via `feature()` flags or `process.env.USER_TYPE`.
+- **`src/constants/tools.ts`** — `CORE_TOOLS` 白名单常量（约 29 个核心工具名），用于 `isDeferredTool` 白名单制判定。
 - **`packages/builtin-tools/src/tools/`** — 59 个子目录（含 shared/testing 等工具目录），通过 `@claude-code-best/builtin-tools` 包导出。主要分类：
   - **文件操作**: FileEditTool, FileReadTool, FileWriteTool, GlobTool, GrepTool
   - **Shell/执行**: BashTool, PowerShellTool, REPLTool
@@ -132,6 +133,7 @@ bun run docs:dev
   - **调度**: CronCreateTool, CronDeleteTool, CronListTool
   - **其他**: LSPTool, ConfigTool, SkillTool, EnterWorktreeTool, ExitWorktreeTool 等
 - **`src/tools/shared/`** / **`packages/builtin-tools/src/tools/shared/`** — Tool 共享工具函数。
+- **`src/services/searchExtraTools/`** — TF-IDF 工具索引模块（`toolIndex.ts`），为延迟工具提供语义搜索能力。复用 `localSearch.ts` 的 TF-IDF 算法函数（`computeWeightedTf`、`computeIdf`、`cosineSimilarity` 已导出）。修改这些函数时需同步检查工具索引测试。`SearchExtraToolsTool.mapToolResultToToolResultBlockParam` 新增可选第三个参数 `context?: { mainLoopModel?: string }`，用于判断当前模型是否支持 `tool_reference`。不支持时回退到文本输出，引导模型使用 ExecuteTool。调用方（`src/services/api/claude.ts` 的 tool_result 处理逻辑）需传入 context 参数。`prefetch.ts` 的 `extractQueryFromMessages` 复用了 `skillSearch/prefetch.ts` 的同名导出函数，修改 skill prefetch 的该函数时需同步检查工具预取行为。工具预取使用独立的 `discoveredToolsThisSession` Set，与 skill prefetch 的去重集合互不影响。
 
 ### UI Layer (Ink)
 

packages/@ant/computer-use-mcp/src/toolCalls.ts

@@ -523,7 +523,7 @@ async function runInputActionGates(
           `visible in screenshots only, no clicks or typing.` +
           (isBrowser
             ? ' Use the Claude-in-Chrome MCP for browser interaction (tools ' +
-              'named `mcp__Claude_in_Chrome__*`; load via ToolSearch if ' +
+              'named `mcp__Claude_in_Chrome__*`; load via SearchExtraTools if ' +
               'deferred).'
             : ' No interaction is permitted; ask the user to take any ' +
               'actions in this app themselves.') +
@@ -1308,7 +1308,7 @@ function buildTierGuidanceMessage(tiered: TieredApp[]): string {
         `typing). You can read what's on screen but cannot navigate, click, ` +
         `or type into ${readBrowsers.length === 1 ? 'it' : 'them'}. For browser ` +
         `interaction, use the Claude-in-Chrome MCP (tools named ` +
-        `\`mcp__Claude_in_Chrome__*\`; load via ToolSearch if deferred).`,
+        `\`mcp__Claude_in_Chrome__*\`; load via SearchExtraTools if deferred).`,
     )
   }
 

packages/builtin-tools/src/index.ts

@@ -29,7 +29,7 @@ export { SkillTool } from './tools/SkillTool/SkillTool.js'
 export { TaskOutputTool } from './tools/TaskOutputTool/TaskOutputTool.js'
 export { TaskStopTool } from './tools/TaskStopTool/TaskStopTool.js'
 export { TodoWriteTool } from './tools/TodoWriteTool/TodoWriteTool.js'
-export { ToolSearchTool } from './tools/ToolSearchTool/ToolSearchTool.js'
+export { SearchExtraToolsTool } from './tools/SearchExtraToolsTool/SearchExtraToolsTool.js'
 export { TungstenTool } from './tools/TungstenTool/TungstenTool.js'
 export { WebFetchTool } from './tools/WebFetchTool/WebFetchTool.js'
 export { WebSearchTool } from './tools/WebSearchTool/WebSearchTool.js'

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

@@ -8,6 +8,7 @@ import { buildTool, type ToolDef } from 'src/Tool.js'
 import { isEnvTruthy } from 'src/utils/envUtils.js'
 import { lazySchema } from 'src/utils/lazySchema.js'
 import { plural } from 'src/utils/stringUtils.js'
+import { isBridgeEnabled } from 'src/bridge/bridgeEnabled.js'
 import { resolveAttachments, validateAttachmentPaths } from './attachments.js'
 import {
   BRIEF_TOOL_NAME,
@@ -149,7 +150,7 @@ export const BriefTool = buildTool({
     return outputSchema()
   },
   isEnabled() {
-    return isBriefEnabled()
+    return isBridgeEnabled()
   },
   isConcurrencySafe() {
     return true

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

@@ -0,0 +1,147 @@
+import { z } from 'zod/v4'
+import {
+  buildTool,
+  findToolByName,
+  type Tool,
+  type ToolDef,
+  type ToolUseContext,
+  type ToolResult,
+  type Tools,
+} from 'src/Tool.js'
+import { lazySchema } from 'src/utils/lazySchema.js'
+import { createUserMessage } from 'src/utils/messages.js'
+import { DESCRIPTION, getPrompt } from './prompt.js'
+import { EXECUTE_TOOL_NAME } from './constants.js'
+
+export const inputSchema = lazySchema(() =>
+  z.object({
+    tool_name: z
+      .string()
+      .describe(
+        'The exact name of the target tool to execute (e.g., "CronCreate", "mcp__server__action")',
+      ),
+    params: z
+      .record(z.string(), z.unknown())
+      .describe('The parameters to pass to the target tool'),
+  }),
+)
+type InputSchema = ReturnType<typeof inputSchema>
+
+export const outputSchema = lazySchema(() =>
+  z.object({
+    result: z.unknown(),
+    tool_name: z.string(),
+  }),
+)
+type OutputSchema = ReturnType<typeof outputSchema>
+
+export type Output = z.infer<OutputSchema>
+
+export const ExecuteTool = buildTool({
+  name: EXECUTE_TOOL_NAME,
+  searchHint: 'execute run invoke call a deferred tool by name with parameters',
+  maxResultSizeChars: 100_000,
+  isConcurrencySafe() {
+    return false
+  },
+  get inputSchema(): InputSchema {
+    return inputSchema()
+  },
+  get outputSchema(): OutputSchema {
+    return outputSchema()
+  },
+  async description() {
+    return DESCRIPTION
+  },
+  async prompt() {
+    return getPrompt()
+  },
+  async call(input, context, canUseTool, parentMessage, onProgress) {
+    const tools: Tools = context.options.tools ?? []
+
+    const targetTool = findToolByName(tools, input.tool_name)
+    if (!targetTool) {
+      return {
+        data: {
+          result: null,
+          tool_name: input.tool_name,
+        },
+        newMessages: [
+          createUserMessage({
+            content: `Tool "${input.tool_name}" not found. Use SearchExtraTools to discover available tools.`,
+          }),
+        ],
+      }
+    }
+
+    // Check if the target tool is currently enabled
+    if (!targetTool.isEnabled()) {
+      return {
+        data: {
+          result: null,
+          tool_name: input.tool_name,
+        },
+        newMessages: [
+          createUserMessage({
+            content: `工具 "${input.tool_name}" 当前不可用：Remote Control 未连接。`,
+          }),
+        ],
+      }
+    }
+
+    // Check permissions on the target tool
+    const permResult = await targetTool.checkPermissions?.(
+      input.params as Record<string, unknown>,
+      context,
+    )
+    if (permResult && permResult.behavior === 'deny') {
+      return {
+        data: {
+          result: null,
+          tool_name: input.tool_name,
+        },
+        newMessages: [
+          createUserMessage({
+            content: `Permission denied for tool "${input.tool_name}": ${permResult.message ?? 'Permission denied'}`,
+          }),
+        ],
+      }
+    }
+
+    // Delegate execution to the target tool
+    const targetResult: ToolResult<unknown> = await targetTool.call(
+      input.params as Record<string, unknown>,
+      context,
+      canUseTool,
+      parentMessage,
+      onProgress,
+    )
+
+    return {
+      ...targetResult,
+      data: {
+        result: targetResult.data,
+        tool_name: input.tool_name,
+      },
+    }
+  },
+  async checkPermissions() {
+    return {
+      behavior: 'passthrough',
+      message: 'ExecuteExtraTool delegates permission to the target tool.',
+    }
+  },
+  renderToolUseMessage(input) {
+    return `Executing ${input.tool_name}...`
+  },
+  userFacingName() {
+    return 'ExecuteExtraTool'
+  },
+  mapToolResultToToolResultBlockParam(content, toolUseID) {
+    return {
+      tool_use_id: toolUseID,
+      type: 'tool_result',
+      content: JSON.stringify(content),
+    }
+  },
+} satisfies ToolDef<InputSchema, Output>)

packages/builtin-tools/src/tools/ExecuteTool/__tests__/ExecuteTool.runner.ts

@@ -0,0 +1,165 @@
+import { describe, test, expect } from 'bun:test'
+import { mock } from 'bun:test'
+import { logMock } from '../../../../../../tests/mocks/log'
+import { debugMock } from '../../../../../../tests/mocks/debug'
+
+mock.module('src/utils/log.ts', logMock)
+mock.module('src/utils/debug.ts', debugMock)
+
+// Mock all heavy dependencies before importing ExecuteTool
+mock.module('src/services/analytics/growthbook.js', () => ({
+  getFeatureValue_CACHED_MAY_BE_STALE: () => false,
+  checkStatsigFeatureGate_CACHED_MAY_BE_STALE: () => false,
+  getFeatureValue_DEPRECATED: async () => undefined,
+  getFeatureValue_CACHED_WITH_REFRESH: async () => undefined,
+  hasGrowthBookEnvOverride: () => false,
+  getAllGrowthBookFeatures: () => ({}),
+  getGrowthBookConfigOverrides: () => ({}),
+  setGrowthBookConfigOverride: () => {},
+  clearGrowthBookConfigOverrides: () => {},
+  getApiBaseUrlHost: () => undefined,
+  onGrowthBookRefresh: () => {},
+  initializeGrowthBook: async () => {},
+  checkSecurityRestrictionGate: async () => false,
+  checkGate_CACHED_OR_BLOCKING: async () => false,
+  refreshGrowthBookAfterAuthChange: () => {},
+  resetGrowthBook: () => {},
+  refreshGrowthBookFeatures: async () => {},
+  setupPeriodicGrowthBookRefresh: () => {},
+  stopPeriodicGrowthBookRefresh: () => {},
+}))
+
+mock.module('src/utils/searchExtraTools.js', () => ({
+  isSearchExtraToolsEnabledOptimistic: () => true,
+  getAutoSearchExtraToolsCharThreshold: () => 100,
+  getSearchExtraToolsMode: () => 'tst' as const,
+  isSearchExtraToolsToolAvailable: async () => true,
+  isSearchExtraToolsEnabled: async () => true,
+  isToolReferenceBlock: () => false,
+  extractDiscoveredToolNames: () => new Set(),
+  isDeferredToolsDeltaEnabled: () => false,
+  getDeferredToolsDelta: () => null,
+}))
+
+mock.module('src/constants/tools.js', () => ({
+  CORE_TOOLS: new Set(['ExecuteExtraTool', 'SearchExtraTools']),
+}))
+
+// Mock messages module
+mock.module('src/utils/messages.js', () => ({
+  createUserMessage: ({ content }: { content: string }) => ({
+    type: 'user' as const,
+    content,
+    uuid: 'test-uuid',
+  }),
+}))
+
+const { ExecuteTool } = await import('../ExecuteTool.js')
+const { EXECUTE_TOOL_NAME } = await import('../constants.js')
+
+function makeContext(tools: unknown[] = []) {
+  return {
+    options: {
+      tools,
+    },
+    cwd: '/tmp',
+    sessionId: 'test',
+  } as never
+}
+
+function makeMockTool(name: string, callResult: unknown = 'ok') {
+  return {
+    name,
+    call: async () => ({ data: callResult }),
+    checkPermissions: async () => ({ behavior: 'allow' as const }),
+    prompt: async () => `Description for ${name}`,
+    description: async () => `Description for ${name}`,
+    inputSchema: {},
+    isEnabled: () => true,
+    isConcurrencySafe: () => true,
+    isReadOnly: () => false,
+    isMcp: false,
+    alwaysLoad: undefined,
+    shouldDefer: undefined,
+    searchHint: '',
+    userFacingName: () => name,
+    renderToolUseMessage: () => `Running ${name}`,
+    mapToolResultToToolResultBlockParam: (content: unknown, id: string) => ({
+      tool_use_id: id,
+      type: 'tool_result',
+      content,
+    }),
+  }
+}
+
+describe('ExecuteTool', () => {
+  test('executes a target tool by name', async () => {
+    const mockTarget = makeMockTool('TestTool', { result: 'success' })
+    const ctx = makeContext([mockTarget])
+
+    const result = await ExecuteTool.call(
+      { tool_name: 'TestTool', params: {} },
+      ctx,
+      async () => ({ behavior: 'allow' }),
+      { type: 'assistant', content: [], uuid: 'msg1' } as never,
+      undefined,
+    )
+
+    expect(result.data).toEqual({
+      result: { result: 'success' },
+      tool_name: 'TestTool',
+    })
+  })
+
+  test('returns error when tool not found', async () => {
+    const ctx = makeContext([])
+
+    const result = await ExecuteTool.call(
+      { tool_name: 'NonexistentTool', params: {} },
+      ctx,
+      async () => ({ behavior: 'allow' }),
+      { type: 'assistant', content: [], uuid: 'msg1' } as never,
+      undefined,
+    )
+
+    expect(result.data).toEqual({
+      result: null,
+      tool_name: 'NonexistentTool',
+    })
+    expect(result.newMessages).toBeDefined()
+    expect(result.newMessages!.length).toBeGreaterThan(0)
+  })
+
+  test('returns permission denied when target denies', async () => {
+    const mockTarget = makeMockTool('SecretTool', 'secret')
+    mockTarget.checkPermissions = async () =>
+      ({
+        behavior: 'deny' as const,
+        message: 'Access denied',
+      }) as never
+    const ctx = makeContext([mockTarget])
+
+    const result = await ExecuteTool.call(
+      { tool_name: 'SecretTool', params: {} },
+      ctx,
+      async () => ({ behavior: 'allow' }),
+      { type: 'assistant', content: [], uuid: 'msg1' } as never,
+      undefined,
+    )
+
+    expect(result.data).toEqual({
+      result: null,
+      tool_name: 'SecretTool',
+    })
+    expect(result.newMessages).toBeDefined()
+  })
+
+  test('has correct name', () => {
+    expect(ExecuteTool.name).toBe(EXECUTE_TOOL_NAME)
+  })
+
+  test('searchHint contains keywords', () => {
+    expect(ExecuteTool.searchHint).toContain('execute')
+    expect(ExecuteTool.searchHint).toContain('tool')
+  })
+})