mirror of
https://github.com/claude-code-best/claude-code.git
synced 2026-06-22 16:25:51 +00:00
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>
This commit is contained in:
74
packages/mcp-client/src/interfaces.ts
Normal file
74
packages/mcp-client/src/interfaces.ts
Normal file
@@ -0,0 +1,74 @@
|
||||
// Host dependency injection interfaces
|
||||
// The MCP client package uses these interfaces to decouple from host infrastructure.
|
||||
|
||||
/** Logging interface */
|
||||
export interface Logger {
|
||||
debug(message: string, ...args: unknown[]): void
|
||||
info(message: string, ...args: unknown[]): void
|
||||
warn(message: string, ...args: unknown[]): void
|
||||
error(message: string, ...args: unknown[]): void
|
||||
}
|
||||
|
||||
/** Analytics/telemetry callback */
|
||||
export interface AnalyticsSink {
|
||||
trackEvent(event: string, metadata: Record<string, unknown>): void
|
||||
}
|
||||
|
||||
/** Feature flag check */
|
||||
export interface FeatureGate {
|
||||
isEnabled(flag: string): boolean
|
||||
}
|
||||
|
||||
/** OAuth token provider */
|
||||
export interface AuthProvider {
|
||||
getTokens(): Promise<{ accessToken: string } | null>
|
||||
refreshTokens(): Promise<void>
|
||||
handleOAuthError?(error: unknown): Promise<void>
|
||||
}
|
||||
|
||||
/** HTTP/WebSocket proxy configuration */
|
||||
export interface ProxyConfig {
|
||||
getFetchOptions?(): Record<string, unknown>
|
||||
getWebSocketAgent?(url: string): unknown
|
||||
getWebSocketUrl?(url: string): string | undefined
|
||||
getTLSOptions?(): Record<string, unknown> | undefined
|
||||
}
|
||||
|
||||
/** Binary/image content persistence */
|
||||
export interface ContentStorage {
|
||||
persistBinaryContent(data: Buffer, ext: string): Promise<string>
|
||||
persistToolResult?(toolUseId: string, content: unknown): Promise<void>
|
||||
}
|
||||
|
||||
/** Image processing (resize, downsample) */
|
||||
export interface ImageProcessor {
|
||||
resizeAndDownsample?(buffer: Buffer): Promise<Buffer>
|
||||
}
|
||||
|
||||
/** HTTP configuration (user agent, session ID) */
|
||||
export interface HttpConfig {
|
||||
getUserAgent(): string
|
||||
getSessionId?(): string
|
||||
}
|
||||
|
||||
/** Subprocess environment variable provider */
|
||||
export interface SubprocessEnvProvider {
|
||||
getEnv(additional?: Record<string, string>): Record<string, string>
|
||||
}
|
||||
|
||||
/**
|
||||
* Complete set of host dependencies required by the MCP client.
|
||||
* All fields except `logger` and `httpConfig` are optional —
|
||||
* the client degrades gracefully when they're not provided.
|
||||
*/
|
||||
export interface McpClientDependencies {
|
||||
logger: Logger
|
||||
analytics?: AnalyticsSink
|
||||
featureGate?: FeatureGate
|
||||
auth?: AuthProvider
|
||||
proxy?: ProxyConfig
|
||||
storage?: ContentStorage
|
||||
imageProcessor?: ImageProcessor
|
||||
httpConfig: HttpConfig
|
||||
subprocessEnv?: SubprocessEnvProvider
|
||||
}
|
||||
Reference in New Issue
Block a user