@huyooo/ai-chat-types 0.2.44 → 0.3.2

package/src/index.ts

@@ -1,3 +1,13 @@
+import type {
+  AssetApprovalPolicy,
+  AssetHostDependency,
+  AssetSideEffectLevel,
+  AssetSource,
+  FinishReason,
+  McpConnectionStatus,
+  ToolUI,
+} from '@huyooo/ai-chat-core'
+
 /**
  * @huyooo/ai-chat-types
  * 
@@ -11,22 +21,25 @@
 
 // ==================== 从 ai-chat-core/events 重新导出事件类型 ====================
 // 使用子路径导出，避免在 renderer 中拉入 ai-chat-core 整个模块图
-// （ai-chat-core 主入口包含 HybridAgent → MCP SDK 等 Node.js 依赖）
+// （ai-chat-core 主入口包含 ChatRuntime → MCP SDK 等 Node.js 依赖）
 
 export type {
   // 聚合类型
   ChatEvent,
   ChatEventType,
+  AssistantSegmentReason,
+  ToolApprovalReason,
 
   // 基础类型
-  SearchResult,
   ToolCallStatus,
   ToolCallInfo,
   TokenUsage,
   ErrorCategory,
   ErrorDetails,
-  ToolErrorShape,
-  ToolUIShape,
+  ToolError,
+  ToolUI,
+  FinishReason,
+  ToolFailureReason,
 
   // 思考事件
   ThinkingStartEvent,
@@ -34,23 +47,23 @@ export type {
   ThinkingEndEvent,
   ThinkingEvent,
 
-  // 搜索事件
-  SearchStartEvent,
-  SearchResultEvent,
-  SearchEndEvent,
-  SearchEvent,
-
   // 工具事件
   ToolCallStartEvent,
   ToolCallResultEvent,
   ToolCallOutputEvent,
   ToolApprovalRequestEvent,
+  ToolCallRequestEvent,
   ToolEvent,
 
   // 文本事件
+  TextStartEvent,
   TextDeltaEvent,
+  TextEndEvent,
   TextEvent,
 
+  // 数据事件
+  DataEvent,
+
   // 计划类型
   PlanStep,
   PlanStepStatus,
@@ -65,11 +78,18 @@ export type {
   StepStartEvent,
   StepEndEvent,
   StepEvent,
+  AssistantSegmentStartEvent,
+  AssistantSegmentEvent,
 
   // 上下文压缩事件
   CompactStartEvent,
   CompactEndEvent,
   CompactEvent,
+
+  // 单条消息内容压缩事件
+  ContentCompressStartEvent,
+  ContentCompressEndEvent,
+  ContentCompressEvent,
 } from '@huyooo/ai-chat-core/events'
 
 // 重新导出事件创建函数和类型守卫（从子路径导入，renderer 安全）
@@ -77,14 +97,14 @@ export {
   createThinkingStart,
   createThinkingDelta,
   createThinkingEnd,
-  createSearchStart,
-  createSearchResult,
-  createSearchEnd,
   createToolCallStart,
   createToolCallResult,
   createToolCallOutput,
+  createTextStart,
   createTextDelta,
+  createTextEnd,
   createDone,
+  createData,
   createError,
   createApiError,
   createRateLimitError,
@@ -94,32 +114,41 @@ export {
   createAbort,
   createStepStart,
   createStepEnd,
+  createAssistantSegmentStart,
   isThinkingEvent,
-  isSearchEvent,
   isToolEvent,
   isTextEvent,
+  isDataEvent,
   isStatusEvent,
   isErrorEvent,
   isAbortEvent,
   isStepEvent,
+  isAssistantSegmentEvent,
   isCompactEvent,
+  isContentCompressEvent,
   isRetryableError,
-  isThrowableToolError,
+  isToolError,
   createCompactStart,
   createCompactEnd,
+  createContentCompressStart,
+  createContentCompressEnd,
 } from '@huyooo/ai-chat-core/events'
 
 // ==================== 从 ai-chat-core 重新导出配置类型 ====================
 
 export type {
   // 模式类型（ChatMode 本地定义以支持更多值）
+  AssetApprovalPolicy,
+  AssetHostDependency,
+  AssetSideEffectLevel,
+  AssetSource,
   ThinkingMode,
   AutoRunMode,
   AutoRunConfig,
 
   // 模型类型
   ModelOption,
-  ProviderType,
+  ProtocolId,
 
   // 聊天选项（使用本地 ChatOptions）
 
@@ -129,15 +158,30 @@ export type {
   McpConnectionInfo,
 } from '@huyooo/ai-chat-core'
 
-/** 对话模式（扩展支持 'plan'，兼容旧数据） */
-export type ChatMode = 'agent' | 'ask' | 'plan'
+/** 对话模式 */
+export type ChatMode = 'agent' | 'ask'
 
 // ==================== 适配器专用类型（本包定义）====================
 
-/** 聊天历史消息（无状态架构传入） */
+/** 聊天历史消息（无状态架构传入，需包含完整工具调用上下文） */
 export interface ChatHistoryMessage {
   role: 'user' | 'assistant' | 'system' | 'tool'
   content: string
+  /** 思考内容（工具调用循环需回传，如 DeepSeek/GLM） */
+  reasoning_content?: string
+  /** 工具消息关联的 tool_call_id */
+  tool_call_id?: string
+  /** assistant 消息的工具调用列表 */
+  tool_calls?: Array<{
+    id: string
+    type: 'function'
+    function: {
+      name: string
+      arguments: string
+    }
+    /** Gemini 模型需要的 thought_signature */
+    thought_signature?: string
+  }>
 }
 
 /** 聊天选项（使用本地 ChatMode） */
@@ -151,6 +195,10 @@ export interface ChatOptions {
   autoRunConfig?: {
     mode?: 'run-everything' | 'manual'
   }
+  maxIterations?: number
+  maxDurationMs?: number
+  maxToolCalls?: number
+  maxTotalTokens?: number
   history?: ChatHistoryMessage[]
   /** Skills 内容（启用的 Skills 的 content 数组，前端拼好传入） */
   skillContents?: string[]
@@ -178,8 +226,10 @@ export interface MessageRecord {
   /** 前端关联 ID（本地模式与 id 相同，云端模式为前端生成的 UUID） */
   clientId?: string | null
   sessionId: string
-  role: 'user' | 'assistant'
+  role: 'user' | 'assistant' | 'system'
   content: string
+  /** 用户通过 @ 选择的上下文资源 */
+  atContextItems?: AtContextItem[] | null
   /** 用户消息附带的图片（data URL 或 base64） */
   images: string[]
   /** 生成此消息时使用的模型 */
@@ -190,19 +240,32 @@ export interface MessageRecord {
   webSearchEnabled?: boolean | null
   /** 生成此消息时是否启用深度思考 */
   thinkingEnabled?: boolean | null
-  /** 执行步骤列表 JSON */
-  steps?: string | null
+  /** 子表中的消息内容 Part */
+  parts: MessagePartRecord[]
   operationIds?: string | null
   /** Token 使用统计（JSON 字符串） */
   usage?: string | null
   /** 响应耗时（毫秒） */
   duration?: number | null
+  /** 结束原因（done 事件携带） */
+  finishReason?: FinishReason | null
   /** 消息序号（会话内递增，用于分叉删除） */
   sequence: number
   /** 时间戳（毫秒，Unix 时间戳） */
   timestamp: number
 }
 
+export interface GetMessagesPageParams {
+  limit?: number
+  beforeSequence?: number
+}
+
+export interface MessagePage {
+  messages: MessageRecord[]
+  hasMore: boolean
+  nextBeforeSequence: number | null
+}
+
 /** 操作记录 */
 export interface OperationRecord {
   id: string
@@ -234,6 +297,8 @@ export interface SkillRecord {
   icon: string
   enabled: boolean
   builtIn: boolean
+  extensionId?: string
+  extensionName?: string
   createdAt: Date
   updatedAt: Date
 }
@@ -248,10 +313,317 @@ export interface FileInfo {
   extension: string
 }
 
+export type AtContextKind = 'file' | 'doc' | 'terminal' | 'chat'
+
+interface AtContextItemBase {
+  kind: AtContextKind
+  id: string
+  label: string
+  mention: string
+  description?: string
+}
+
+export interface AtFileContextItem extends AtContextItemBase {
+  kind: 'file'
+  path: string
+}
+
+export interface AtDocumentContextItem extends AtContextItemBase {
+  kind: 'doc'
+  documentId: string
+  source: string
+  snippet?: string
+  score?: number
+  matchType?: 'exact' | 'semantic' | 'fulltext' | 'hybrid'
+}
+
+export interface AtTerminalContextItem extends AtContextItemBase {
+  kind: 'terminal'
+  sessionId: string
+  cwd: string
+  status: string
+  updatedAt: string
+}
+
+export interface AtChatContextItem extends AtContextItemBase {
+  kind: 'chat'
+  sessionId: string
+  updatedAt: number
+  preview?: string
+  matchedMessageId?: string
+}
+
+export type AtContextItem =
+  | AtFileContextItem
+  | AtDocumentContextItem
+  | AtTerminalContextItem
+  | AtChatContextItem
+
+export type AtResourceKind = AtContextKind | 'directory'
+
+export interface AtResourceLocator {
+  path?: string
+  documentId?: string
+  sessionId?: string
+  cwd?: string
+  messageId?: string
+}
+
+export interface AtResourcePreview {
+  text?: string
+  score?: number
+  matchType?: 'exact' | 'semantic' | 'fulltext' | 'hybrid'
+  updatedAt?: string | number
+  status?: string
+}
+
+export interface AtResourceContent {
+  kind: 'full' | 'summary' | 'structure'
+  text: string
+  truncated?: boolean
+  /**
+   * 该正文在使用 TokenCounter 计数下的 token 数。
+   * 由 chat-utils 在应用 token budget 后写入，下游可据此做二次裁剪或调试展示。
+   */
+  tokens?: number
+}
+
+export interface AtResourceRecommendedTool {
+  alias: string
+  displayName?: string
+  purpose: string
+  /** 该工具是否能继续读到资源更多正文 / 结构化内容（元信息 / 查找类为 false） */
+  canReadMore: boolean
+}
+
+/**
+ * 文件格式能力契约 —— 整个 @ 文件链路的单一类型真相源。
+ *
+ * 同一套枚举同时被：
+ *   - superx/src/shared/fileTypeCatalog.ts（在宿主侧填充具体格式表并派生默认策略）
+ *   - ai-chat-shared/src/at-context-tools.ts（在前端侧按能力推荐工具）
+ * 共同使用，严禁在任何一侧再次重复声明，避免双写漂移。
+ *
+ * DocumentType 语义：
+ * - code/config/style/web/text/data   → 原文按行读（super_filesystem__read）
+ * - word/pdf/excel/powerpoint/notebook → 已解析文档统一读取（super_filesystem__read）
+ * - ebook/opendocument                → 同上
+ * - unknown                           → 只推按名搜索，不推读取
+ */
+export type DocumentType =
+  | 'code'
+  | 'config'
+  | 'style'
+  | 'web'
+  | 'text'
+  | 'data'
+  | 'word'
+  | 'pdf'
+  | 'excel'
+  | 'powerpoint'
+  | 'notebook'
+  | 'ebook'
+  | 'opendocument'
+  | 'unknown'
+
+export type ReadStrategy =
+  | 'line-range'
+  | 'section'
+  | 'page'
+  | 'sheet-range'
+  | 'slide'
+  | 'cell'
+  | 'symbol'
+  | 'none'
+
+export type SearchStrategy =
+  | 'grep'
+  | 'document-index'
+  | 'code-index'
+  | 'none'
+
+export type EditStrategy =
+  | 'text'
+  | 'structured-code'
+  | 'readonly'
+  | 'none'
+
+export interface AtResolvedFileContext {
+  title?: string
+  content: string | null
+  /** 文件格式分类，由宿主通过 fileTypeCatalog 解析得出 */
+  docType?: DocumentType
+  /** 文件读取坐标能力：行 / 页 / cell / symbol 等 */
+  readStrategy?: ReadStrategy
+  /** 文件内容搜索能力：grep / 文档索引 / 代码索引 */
+  searchStrategy?: SearchStrategy
+  /** 文件编辑能力：文本替换 / 结构化代码 / 只读 */
+  editStrategy?: EditStrategy
+  metadata?: Record<string, unknown>
+}
+
+export interface AtResourceAccess {
+  /** 推荐工具里是否至少有一个能继续读到资源更多正文 / 结构化内容 */
+  canReadMore: boolean
+  /**
+   * 资源正文当前是否还有"直读 / 直搜"通道可用。
+   * - file 资源：由 fileTypeCatalog 的 parser/readStrategy/searchStrategy 直接决定
+   *   （unsupported 或 read=none + search=none 时为 false）
+   * - directory / doc / terminal / chat 等非文件资源：恒为 true
+   * 下游渲染层直接读此字段即可，无需再反推 metadata 字符串。
+   */
+  directReadable: boolean
+  recommendedTools: AtResourceRecommendedTool[]
+  /**
+   * 最终分配给该资源的 token 预算（预览 + 正文 + 元信息提示合计上限）。
+   * 由 chat-utils 在装配 prompt 时按全局 budget 分配得出；未开启 token budget 时为 undefined。
+   */
+  allocatedTokens?: number
+}
+
+export interface AtResourceDescriptor {
+  kind: AtResourceKind
+  mention: string
+  title: string
+  locator: AtResourceLocator
+  preview?: AtResourcePreview
+  content?: AtResourceContent
+  access: AtResourceAccess
+  metadata?: Record<string, unknown>
+}
+
 /** 工具信息 */
 export interface ToolInfo {
   name: string
   description: string
+  displayName: string
+  assetId: string
+  source: AssetSource
+  category: string
+  parameters?: Record<string, unknown>
+  outputSchema?: Record<string, unknown>
+  errorSchema?: Record<string, unknown>
+  approvalPolicy?: AssetApprovalPolicy
+  sideEffectLevel?: AssetSideEffectLevel
+  hostDependency?: AssetHostDependency
+}
+
+export type ChatCapabilityGroupSource = AssetSource
+
+export interface ChatCapabilitySkillItem {
+  id: string
+  name: string
+  description: string
+  source: AssetSource
+  extensionId: string
+  extensionName: string
+  chatEnabled: boolean
+}
+
+export interface ChatCapabilityToolItem {
+  alias: string
+  displayName: string
+  description: string
+  source: AssetSource
+  category: string
+  extensionId: string
+  extensionName: string
+  runtimeInjected: boolean
+  runtimeAvailable: boolean
+  chatEnabled: boolean
+  approvalPolicy?: AssetApprovalPolicy
+  sideEffectLevel?: AssetSideEffectLevel
+  hostDependency?: AssetHostDependency
+}
+
+export interface ChatCapabilityMcpToolItem {
+  alias: string
+  displayName: string
+  description: string
+  source: AssetSource
+  extensionId: string
+  extensionName: string
+  runtimeInjected: boolean
+  runtimeAvailable: boolean
+  chatEnabled: boolean
+}
+
+export interface ChatCapabilityMcpServerItem {
+  id: string
+  name: string
+  source: AssetSource
+  extensionId: string
+  extensionName: string
+  runtimeInjected: boolean
+  runtimeAvailable: boolean
+  connectionStatus: McpConnectionStatus
+  error?: string
+  tools: ChatCapabilityMcpToolItem[]
+}
+
+export interface ChatCapabilityExtensionGroup {
+  id: string
+  name: string
+  source: ChatCapabilityGroupSource
+  extensionEnabled: boolean
+  /**
+   * Total capabilities owned by the extension, including items hidden while the
+   * extension is disabled. Renderers should use this for extension-level counts.
+   */
+  availableCount?: number
+  skills: ChatCapabilitySkillItem[]
+  tools: ChatCapabilityToolItem[]
+  mcpServers: ChatCapabilityMcpServerItem[]
+}
+
+export interface ChatCapabilitySnapshot {
+  extensions: ChatCapabilityExtensionGroup[]
+}
+
+export interface AgentCapabilityManifestTool {
+  alias: string
+  displayName: string
+  description: string
+  kind: 'tool' | 'mcp-tool'
+}
+
+export interface AgentCapabilityManifestSkill {
+  id: string
+  name: string
+  description: string
+}
+
+export interface AgentCapabilityManifestExtension {
+  id: string
+  name: string
+  source: string
+  skills: AgentCapabilityManifestSkill[]
+  tools: AgentCapabilityManifestTool[]
+}
+
+export interface AgentCapabilityManifest {
+  version: '1'
+  extensions: AgentCapabilityManifestExtension[]
+}
+
+export interface ChatCapabilitySelection {
+  toolOverrides: Record<string, boolean>
+  mcpToolOverrides: Record<string, boolean>
+}
+
+export interface SkillEnabledItem {
+  id: string
+  enabled: boolean
+}
+
+export interface ChatCapabilityToolEnabledItem {
+  alias: string
+  enabled: boolean
+}
+
+export interface ChatCapabilityToolEnabledResult extends ChatCapabilityToolEnabledItem {
+  kind?: 'tool' | 'mcp'
+  error?: string
 }
 
 /** 工具批准请求 */
@@ -267,8 +639,14 @@ export interface ToolExecutionResult {
   result: string
   error?: string
   /** 工具 UI 声明（成功时） */
-  ui?: { type: 'render' | 'action'; name: string; props?: Record<string, unknown> }
-  toolError?: import('@huyooo/ai-chat-core/events').ToolErrorShape
+  ui?: ToolUI
+  approvalPolicy?: AssetApprovalPolicy
+  sideEffectLevel?: AssetSideEffectLevel
+  hostDependency?: AssetHostDependency
+  riskSummary?: string
+  riskTags?: string[]
+  riskSignals?: string[]
+  toolError?: import('@huyooo/ai-chat-core/events').ToolError
 }
 
 // ==================== ASR 语音识别 ====================
@@ -308,16 +686,15 @@ export interface AsrResultData {
 // ==================== ChatAdapter 接口 ====================
 
 // 导入 ChatEvent 和 ModelOption 用于 ChatAdapter 接口
-// ChatOptions 使用本地定义（支持 'plan' 模式）
+// ChatOptions 使用本地定义（含 ChatMode）
 import type { ChatEvent, ModelOption } from '@huyooo/ai-chat-core'
 
 /**
  * ChatAdapter 接口
  *
  * 统一的聊天适配器接口，支持多种实现：
- * - Electron IPC（ai-chat-bridge-electron）
+ * - Electron IPC（ai-chat-bridge-electron/renderer）
  * - HTTP/SSE（ai-chat-adapter-http）
- * - 直连（ai-chat-adapter-direct，CLI 用）
  *
  * 行为统一保证：无论使用哪种实现（本地直连 / HTTP / 混合），对调用方接口一致——
  * getModels()、sendMessage()、getSessions() 等语义相同，sendMessage 产出的事件均为
@@ -329,8 +706,12 @@ export interface ChatAdapter {
   // ============ Chat API ============
   /** 获取可用模型 */
   getModels(): Promise<ModelOption[]>
-  /** 获取所有工具列表（用于设置面板） */
+  /** 获取所有工具列表（用于工具设置或管理视图） */
   getAllTools?(): Promise<ToolInfo[]>
+  /** 获取聊天能力快照（扩展 -> 能力分类 -> 能力项） */
+  getChatCapabilitySnapshot?(): Promise<ChatCapabilitySnapshot>
+  /** 监听聊天能力更新 */
+  onChatCapabilityUpdate?(callback: () => void): () => void
   /** 发送消息，返回异步迭代器 */
   sendMessage(
     message: string,
@@ -342,6 +723,20 @@ export interface ChatAdapter {
   cancel(): void
   /** 设置当前工作目录 */
   setCwd?(dir: string): void
+  /** 搜索可引用的文档上下文 */
+  searchAtDocuments?(query: string, options?: { limit?: number }): Promise<AtDocumentContextItem[]>
+  /** 列出可引用的终端会话 */
+  listAtTerminals?(options?: { query?: string; limit?: number; workspaceRoot?: string }): Promise<AtTerminalContextItem[]>
+  /** 搜索可引用的历史对话 */
+  searchAtChats?(query: string, options?: { limit?: number }): Promise<AtChatContextItem[]>
+  /** 读取可引用的文档上下文内容 */
+  readAtDocumentContext?(documentId: string): Promise<string | null>
+  /** 读取可引用的终端上下文内容 */
+  readAtTerminalContext?(sessionId: string): Promise<string | null>
+  /** 读取可引用的历史对话上下文内容 */
+  readAtChatContext?(sessionId: string): Promise<string | null>
+  /** 解析 @ 文件上下文（供宿主接入高级文件解析器） */
+  resolveAtFileContext?(filePath: string): Promise<AtResolvedFileContext | null>
 
   // ============ Sessions API ============
   /** 获取会话列表 */
@@ -358,6 +753,8 @@ export interface ChatAdapter {
   // ============ Messages API ============
   /** 获取会话消息 */
   getMessages(sessionId: string): Promise<MessageRecord[]>
+  /** 分页获取会话消息（优先返回最近消息，按 sequence 升序返回当前页） */
+  getMessagesPage?(sessionId: string, params?: GetMessagesPageParams): Promise<MessagePage>
   /** 保存消息 */
   saveMessage(params: SaveMessageParams): Promise<MessageRecord>
   /** 更新消息（增量保存） */
@@ -407,16 +804,20 @@ export interface ChatAdapter {
   onIndexProgress?(callback: (progress: { indexed: number; total: number; currentFile?: string; stage: string; error?: string }) => void): () => void
 
   // ============ Skills API（可选）============
-  /** 获取 Skills 列表 */
-  getSkills?(): Promise<SkillRecord[]>
-  /** 创建 Skill */
-  createSkill?(data: { name: string; description?: string; content: string; icon?: string }): Promise<SkillRecord>
-  /** 更新 Skill */
-  updateSkill?(id: string, data: { name?: string; description?: string; content?: string; icon?: string; enabled?: boolean }): Promise<void>
-  /** 删除 Skill */
-  deleteSkill?(id: string): Promise<void>
-  /** 切换 Skill 启用状态 */
-  toggleSkill?(id: string): Promise<{ enabled: boolean }>
+  /** 批量设置 Skill 的聊天启用状态（聊天侧仅保留此能力） */
+  setSkillsChatEnabled?(items: SkillEnabledItem[]): Promise<Array<SkillEnabledItem & { error?: string }>>
+  /** 批量设置普通 Tool 的聊天启用状态（不改变扩展运行时启停） */
+  setToolsChatEnabled?(items: ChatCapabilityToolEnabledItem[]): Promise<ChatCapabilityToolEnabledResult[]>
+  /** 批量设置 MCP Tool 的聊天启用状态（不改变扩展运行时启停） */
+  setMcpToolsChatEnabled?(items: ChatCapabilityToolEnabledItem[]): Promise<ChatCapabilityToolEnabledResult[]>
+
+  // ============ Extension Toggle API（可选）============
+  /**
+   * 设置扩展的整体启停状态（Layer 1：影响 ChatRuntime 的 sessionTools）。
+   * 对比 setSkillsChatEnabled / setToolsChatEnabled，这里是"容器级"开关：
+   * 禁用扩展会让其所有 tool/skill/mcp 从会话工具集里卸下，直接减少 token 占用。
+   */
+  setExtensionEnabled?(payload: { id: string; enabled: boolean; source: AssetSource }): Promise<{ ok: true } | { ok: false; error: string }>
 
   // ============ Tool Approval API ============
   onToolApprovalRequest?(callback: (request: ToolApprovalRequest) => void): () => void
@@ -467,27 +868,44 @@ export interface UpdateSessionParams {
 export interface SaveMessageParams {
   id?: string
   sessionId: string
-  role: 'user' | 'assistant'
+  role: 'user' | 'assistant' | 'system'
   content: string
+  atContextItems?: AtContextItem[]
   images?: string[]
   model?: string
   mode?: string
   webSearchEnabled?: boolean
   thinkingEnabled?: boolean
-  steps?: string
+  parts?: MessagePartInput[]
   operationIds?: string
+  finishReason?: FinishReason
 }
 
 /** 更新消息参数 */
 export interface UpdateMessageParams {
   id: string
   content?: string
-  steps?: string
+  atContextItems?: AtContextItem[] | null
+  parts?: MessagePartInput[]
   operationIds?: string
   /** Token 使用统计（JSON 字符串） */
   usage?: string
   /** 响应耗时（毫秒） */
   duration?: number
+  /** 结束原因（done 事件携带） */
+  finishReason?: FinishReason
+}
+
+export interface MessagePartRecord {
+  messageId: string
+  sequence: number
+  type: string
+  payload: string
+}
+
+export interface MessagePartInput {
+  type: string
+  payload: string
 }
 
 // ==================== 发送消息参数（用于 IPC）====================
@@ -507,3 +925,14 @@ export interface SendMessageParams {
     history?: ChatHistoryMessage[]
   }
 }
+
+// ==================== 前端扩展事件类型 + 事件工具 ====================
+
+export {
+  buildToolGovernanceLabels,
+  type FrontendChatEvent,
+  type ToolGovernanceInfo,
+  extractToolGovernance,
+  mergeToolGovernance,
+  shouldSaveEvent,
+} from './chat-utils'