// 工具注册：每个工具都被导入并注册
import { BashTool } from './tools/BashTool/BashTool.js'
import { FileReadTool } from './tools/FileReadTool/FileReadTool.js'
import { GrepTool } from './tools/GrepTool/GrepTool.js'
// ... 40+ 更多工具

/**
 * 获取所有基础工具（这是单一真实来源）
 * 注意：这个列表必须与 Statsig 配置保持同步
 * 以便系统提示可以被缓存
 */
export function getAllBaseTools(): Tools {
  return [
    AgentTool,
    TaskOutputTool,
    BashTool,
    GlobTool,
    GrepTool,
    FileReadTool,
    FileEditTool,
    FileWriteTool,
    // ... 更多工具
  ]
}

export type Tool<Input, Output, Progress> = {
  // 基本信息
  readonly name: string                      // 工具名称
  aliases?: string[]                         // 别名（向后兼容）
  searchHint?: string                        // 搜索提示（3-10词）

  // Schema 定义
  readonly inputSchema: Input                // 输入参数的 Zod schema
  readonly inputJSONSchema?: ToolInputJSONSchema  // JSON Schema 格式
  outputSchema?: z.ZodType<unknown>        // 输出 schema

  // 核心方法
  call(
    args: z.infer<Input>,
    context: ToolUseContext,
    canUseTool: CanUseToolFn,
    parentMessage: AssistantMessage,
    onProgress?: ToolCallProgress<Progress>,
  ): Promise<ToolResult<Output>>           // 执行工具

  // 描述和权限
  description(input: z.infer<Input>, options: ...): Promise<string>
  checkPermissions(input: z.infer<Input>, context: ...): Promise<PermissionResult>

  // 安全和并发
  isEnabled(): boolean                       // 是否启用
  isReadOnly(input: z.infer<Input>): boolean    // 是否只读
  isDestructive?(input: z.infer<Input>): boolean  // 是否破坏性
  isConcurrencySafe(input: z.infer<Input>): boolean  // 是否并发安全

  // UI 渲染
  renderToolUseMessage(input: ..., options: ...): React.ReactNode
  renderToolResultMessage?(content: ..., options: ...): React.ReactNode

  // 元数据
  maxResultSizeChars: number                // 结果大小限制（字符数）
  isMcp?: boolean                           // 是否 MCP 工具
}