附录 A：类型定义速查

本附录收录 Claude Code 源码中的核心 TypeScript 类型定义，提供快速索引和概览。

A.1 核心 TypeScript 类型汇总

A.1.1 工具系统类型

A.1.2 命令与 Skill 类型

A.1.3 查询引擎类型

A.1.4 会话与标识类型

A.1.5 Bridge 类型

A.1.6 插件类型

A.1.7 权限类型

A.1.8 Hook 类型

A.1.9 UI 输入类型

A.1.10 Connector 类型

A.2 类型关系图

graph TB
    subgraph "核心类型体系"
        Tool[Tool<br/>工具接口]
        Tools[Tools<br/>工具集合]
        ToolDef[ToolDef<br/>工具定义]
        
        ToolDef -->|buildTool| Tool
        Tool -->|组成| Tools
    end
    
    subgraph "权限类型体系"
        PermissionMode[PermissionMode<br/>权限模式]
        PermissionBehavior[PermissionBehavior<br/>权限行为]
        PermissionRule[PermissionRule<br/>权限规则]
        PermissionDecision[PermissionDecision<br/>权限决策]
        PermissionResult[PermissionResult<br/>权限结果]
        
        PermissionMode --> PermissionDecision
        PermissionBehavior --> PermissionRule
        PermissionRule --> PermissionDecision
        PermissionDecision --> PermissionResult
    end
    
    subgraph "命令类型体系"
        CommandBase[CommandBase<br/>命令基础]
        Command[Command<br/>命令联合]
        PromptCommand[PromptCommand<br/>Prompt 命令]
        LocalCommand[LocalCommand<br/>本地命令]
        LocalJSXCommand[LocalJSXCommand<br/>JSX 命令]
        
        CommandBase --> Command
        PromptCommand --> Command
        LocalCommand --> Command
        LocalJSXCommand --> Command
    end
    
    subgraph "会话类型体系"
        SessionId[SessionId<br/>会话 ID]
        AgentId[AgentId<br/>Agent ID]
        LogOption[LogOption<br/>日志选项]
        SerializedMessage[SerializedMessage<br/>序列化消息]
        
        SessionId --> LogOption
        AgentId --> SerializedMessage
    end
    
    subgraph "Bridge 类型体系"
        BridgeConfig[BridgeConfig<br/>Bridge 配置]
        WorkResponse[WorkResponse<br/>工作响应]
        SessionHandle[SessionHandle<br/>会话句柄]
        SpawnMode[SpawnMode<br/>启动模式]
        
        BridgeConfig --> SessionHandle
        WorkResponse --> SessionHandle
        SpawnMode --> BridgeConfig
    end
    
    subgraph "插件类型体系"
        PluginManifest[PluginManifest<br/>插件清单]
        LoadedPlugin[LoadedPlugin<br/>已加载插件]
        PluginError[PluginError<br/>插件错误]
        PluginLoadResult[PluginLoadResult<br/>加载结果]
        
        PluginManifest --> LoadedPlugin
        LoadedPlugin --> PluginLoadResult
        PluginError --> PluginLoadResult
    end
    
    Tool --> PermissionResult
    ToolUseContext --> Tool
    ToolUseContext --> PermissionMode
    Command --> ToolUseContext
    QueryEngine --> ToolUseContext
    QueryEngine --> Tools
    QueryEngine --> Command
    BridgeConfig --> SessionId
    HookResult --> PermissionDecision
    BundledSkillDefinition --> Command

A.3 关键类型定义示例

A.3.1 Tool 核心结构

type Tool<
  Input extends AnyObject = AnyObject,
  Output = unknown,
  P extends ToolProgressData = ToolProgressData,
> = {
  readonly name: string;
  aliases?: string[];
  readonly inputSchema: Input;
  call(args, context, canUseTool, parentMessage, onProgress): Promise<ToolResult<Output>>;
  description(input, options): Promise<string>;
  checkPermissions(input, context): Promise<PermissionResult>;
  isEnabled(): boolean;
  isConcurrencySafe(input): boolean;
  isReadOnly(input): boolean;
  isDestructive?(input): boolean;
  userFacingName(input): string;
  prompt(options): Promise<string>;
  // ... 渲染方法
};

A.3.2 Command 联合类型

type Command = CommandBase &
  (PromptCommand | LocalCommand | LocalJSXCommand);

type CommandBase = {
  name: string;
  description: string;
  availability?: CommandAvailability[];
  isEnabled?: () => boolean;
  isHidden?: boolean;
  aliases?: string[];
  argumentHint?: string;
  whenToUse?: string;
  version?: string;
  disableModelInvocation?: boolean;
  userInvocable?: boolean;
  loadedFrom?: 'skills' | 'plugin' | 'managed' | 'bundled' | 'mcp';
  // ...
};

A.3.3 PermissionResult 结构

type PermissionResult<Input = { [key: string]: unknown }> =
  | PermissionDecision<Input>
  | {
      behavior: 'passthrough';
      message: string;
      decisionReason?: PermissionDecision<Input>['decisionReason'];
      suggestions?: PermissionUpdate[];
      blockedPath?: string;
      pendingClassifierCheck?: PendingClassifierCheck;
    };

type PermissionDecision<Input> =
  | PermissionAllowDecision<Input>
  | PermissionAskDecision<Input>
  | PermissionDenyDecision;

A.3.4 QueryEngineConfig 结构

type QueryEngineConfig = {
  cwd: string;
  tools: Tools;
  commands: Command[];
  mcpClients: MCPServerConnection[];
  agents: AgentDefinition[];
  canUseTool: CanUseToolFn;
  getAppState: () => AppState;
  setAppState: (f: (prev: AppState) => AppState) => void;
  initialMessages?: Message[];
  readFileCache: FileStateCache;
  customSystemPrompt?: string;
  appendSystemPrompt?: string;
  userSpecifiedModel?: string;
  thinkingConfig?: ThinkingConfig;
  maxTurns?: number;
  maxBudgetUsd?: number;
  // ...
};