@blueking/chat-x 0.0.51-beta.2 → 0.0.51-beta.3

package/skills/blueking-chat-x/references/types/constants.md

@@ -1,307 +0,0 @@
-# 常量枚举
-
-> since 1.0.0
-
-汇总 MessageRole、MessageStatus（含 Fetching 请求中、Complete/Completed 完成态兼容）、MessageContentType、MessageToolsStatus、MessageState、Z-Index 与 CONST_MESSAGE_TOOLS 等导出常量。 用于构造消息、配置 MessageContainer 工具栏与输入态，以及层级与默认快捷指令。与类型 messages 配套使用。
-
-**关联**：message-tools（默认工具 ID 与展示）、chat-input（MessageState 与快捷指令）、message-container（工具栏与消息态）
-
----
-
-# 常量枚举
-
-> **分类**：type
-
-`@blueking/chat-x` 导出的常量和枚举类型。
-
-## 消息相关
-
-### MessageRole
-
-消息角色枚举：
-
-```typescript
-enum MessageRole {
-  User = 'user',
-  Assistant = 'assistant',
-  System = 'system',
-  Developer = 'developer',
-  Guide = 'guide',
-  Hidden = 'hidden',
-  HiddenAssistant = 'hidden-assistant',
-  HiddenGuide = 'hidden-guide',
-  HiddenSystem = 'hidden-system',
-  HiddenUser = 'hidden-user',
-  Info = 'info',
-  Interrupt = 'interrupt',
-  Loading = 'loading',
-  Pause = 'pause',
-  Placeholder = 'placeholder',
-  Reasoning = 'reasoning',
-  TemplateAssistant = 'template-assistant',
-  TemplateGuide = 'template-guide',
-  TemplateHidden = 'template-hidden',
-  TemplateSystem = 'template-system',
-  TemplateUser = 'template-user',
-  Tool = 'tool',
-  Activity = 'activity',
-}
-```
-
-### MessageStatus
-
-消息状态枚举：
-
-```typescript
-enum MessageStatus {
-  Complete = 'complete',
-  Completed = 'completed', // 与 Complete 同为完成态，兼容后端/协议返回的 completed
-  Disabled = 'disabled',
-  Error = 'error',
-  Fetching = 'fetching', // 请求中（例如已发用户消息、尚未开始流式，与末尾 Loading 占位一致）
-  Pending = 'pending',
-  Stop = 'stop',
-  StopLoading = 'stop-loading',
-  Streaming = 'streaming',
-  Success = 'success',
-}
-```
-
-| 枚举值          | 说明 |
-| --------------- | ---- |
-| `Complete` / `Completed` | 已完成。`complete` 为库内常用值；`completed` 与之语义相同，用于兼容外部协议或后端返回。`ToolcallRender` 等将二者与 `success` 一并视为成功态。 |
-| `Fetching`      | 请求中：与 `useMessageGroup` 在末尾用户消息后注入的 Loading 占位（`LOADING_MESSAGE_ID`）配合时，`ChatContainer` 会将传入输入区与列表底部的状态推导为该值，便于展示「停止」与禁止重复发送。 |
-
-### InterruptReason
-
-human-in-the-loop 中断原因枚举，用于 `Interrupt.reason` 区分中断类型并选择对应的 UI 渲染器。
-
-```typescript
-enum InterruptReason {
-  AIDevToolApproval = 'aidev:tool_approval',
-  UserQuestion = 'aidev:user_question',
-}
-```
-
-### APPROVAL_STATUS
-
-AI Dev 工具审批单状态枚举，`AIDevToolApprovalInterrupt.metadata.ticket.status` 使用该类型。
-
-```typescript
-enum APPROVAL_STATUS {
-  ABANDONED = 'abandoned',
-  APPROVED = 'approved',
-  CANCELLED = 'cancelled',
-  DRAFT = 'draft',
-  EXPIRED = 'expired',
-  PENDING = 'pending',
-  REJECTED = 'rejected',
-  REVOKED = 'revoked',
-}
-```
-
-### APPROVAL_STATUS_MAP
-
-审批单状态到展示文案的映射，供 `ToolApprovalCard` 等组件使用：
-
-```typescript
-const APPROVAL_STATUS_MAP: Record<APPROVAL_STATUS, string> = {
-  [APPROVAL_STATUS.ABANDONED]: '已废弃',
-  [APPROVAL_STATUS.APPROVED]: '已通过',
-  [APPROVAL_STATUS.CANCELLED]: '已取消',
-  [APPROVAL_STATUS.DRAFT]: '待审批',
-  [APPROVAL_STATUS.EXPIRED]: '已过期',
-  [APPROVAL_STATUS.PENDING]: '待审批',
-  [APPROVAL_STATUS.REJECTED]: '已拒绝',
-  [APPROVAL_STATUS.REVOKED]: '已撤销',
-};
-```
-
-| 状态值      | 展示文案 |
-| ----------- | -------- |
-| `pending`   | 待审批   |
-| `draft`     | 待审批   |
-| `approved`  | 已通过   |
-| `rejected`  | 已拒绝   |
-| `cancelled` | 已取消   |
-| `expired`   | 已过期   |
-| `abandoned` | 已废弃   |
-| `revoked`   | 已撤销   |
-
-### RunFinishedOutcome
-
-AG-UI `RUN_FINISHED` 事件的结束结果类型。中断结果不再是字符串枚举，而是对象联合类型；`type: 'interrupt'` 时，中断列表放在 `interrupts` 字段中。
-
-```typescript
-type RunFinishedOutcome = { interrupts: Interrupt[]; type: 'interrupt' } | { type: 'success' };
-```
-
-### MessageContentType
-
-消息内容类型枚举：
-
-```typescript
-enum MessageContentType {
-  Binary = 'binary',
-  FlowAgent = 'flow_agent',
-  Function = 'function',
-  KeyValue = 'key_value',
-  KnowledgeRag = 'knowledge_rag',
-  Other = 'other',
-  ReferenceDocument = 'reference_document',
-  Text = 'text',
-}
-```
-
-### MessageToolsStatus
-
-消息工具栏状态枚举：
-
-```typescript
-enum MessageToolsStatus {
-  Disabled = 'disabled', // 禁用状态，按钮显示但不可点击
-  Hidden = 'hidden', // 隐藏状态，工具栏完全隐藏
-}
-```
-
-### RenderMode
-
-渲染模式枚举，控制 `ChatContainer` / `MessageContainer` 的 UI 行为：
-
-```typescript
-enum RenderMode {
-  Chat = 'chat',   // 默认对话模式
-  Share = 'share', // 分享预览模式：隐藏侧边栏和工具栏，启用多选样式
-  Test = 'test',   // 测试/嵌入模式：过滤掉「分享」按钮
-}
-```
-
-| 枚举值  | 侧边栏 | MessageTools   | 说明                           |
-| ------- | ------ | -------------- | ------------------------------ |
-| `Chat`  | 正常   | 全部按钮       | 默认行为                       |
-| `Share` | 隐藏   | 隐藏           | 分享预览，仅展示消息内容       |
-| `Test`  | 正常   | 过滤掉「分享」 | 测试或嵌入场景，隐藏分享入口   |
-
-## 输入状态
-
-### MessageState
-
-输入框消息状态：
-
-```typescript
-const MessageState = {
-  ACTIVE: 'active',
-  DISABLED: 'disabled',
-  LOADING: 'loading',
-} as const;
-```
-
-## Z-Index 常量
-
-```typescript
-// 全局 chat-x 组件 Z-Index
-const CHAT_Z_INDEX = 9999;
-
-// 编辑器组件 Z-Index
-const EDITOR_Z_INDEX = 10000;
-
-// 编辑器菜单 Z-Index
-const EDITOR_MENU_Z_INDEX = 10001;
-
-// 快捷指令菜单 Z-Index
-const SHORTCUT_MENU_Z_INDEX = 10002;
-
-// 划选弹窗 Z-Index
-const SELECTION_Z_INDEX = 10003;
-```
-
-## 默认工具按钮
-
-### CONST_MESSAGE_TOOLS
-
-消息工具按钮列表：
-
-```typescript
-const CONST_MESSAGE_TOOLS: IToolBtn[] = [
-  { id: 'copy', name: '复制', description: '复制' },
-  { id: 'cite', name: '引用', description: '引用' },
-  { id: 'rebuild', name: '重新生成', description: '重新生成' },
-  { id: 'share', name: '分享', description: '分享' },
-];
-```
-
-### CONST_USER_MESSAGE_TOOLS
-
-用户消息工具按钮列表：
-
-```typescript
-const CONST_USER_MESSAGE_TOOLS: IToolBtn[] = [
-  { id: 'copy', name: '复制', description: '复制' },
-  { id: 'cite', name: '引用', description: '引用' },
-  { id: 'edit', name: '编辑', description: '编辑' },
-  { id: 'delete', name: '删除', description: '删除' },
-];
-```
-
-### CONST_UPDATE_TOOLS
-
-更新工具按钮列表（点赞/不满意）：
-
-```typescript
-const CONST_UPDATE_TOOLS: IToolBtn[] = [
-  { id: 'like', name: '点赞', description: '点赞' },
-  { id: 'unlike', name: '不满意', description: '不满意' },
-  { id: 'delete', name: '删除', description: '删除' },
-];
-```
-
-## 默认快捷指令
-
-### DEFAULT_SHORTCUTS
-
-默认快捷指令列表：
-
-```typescript
-const DEFAULT_SHORTCUTS: Shortcut[] = [{ id: 'ask-whale', name: '问问小鲸' }];
-```
-
-## 使用示例
-
-```typescript
-import {
-  MessageRole,
-  MessageStatus,
-  MessageContentType,
-  MessageToolsStatus,
-  RenderMode,
-  CHAT_Z_INDEX,
-  CONST_MESSAGE_TOOLS,
-  DEFAULT_SHORTCUTS,
-} from '@blueking/chat-x';
-
-// 创建消息
-const message = {
-  id: '1',
-  messageId: 1,
-  role: MessageRole.User,
-  content: '你好',
-  status: MessageStatus.Complete,
-};
-
-// 检查消息状态
-if (message.status === MessageStatus.Streaming) {
-  console.log('消息正在流式输出中...');
-}
-
-// 使用默认工具按钮
-console.log(
-  '可用工具:',
-  CONST_MESSAGE_TOOLS.map(t => t.name),
-);
-```
-
-## 关联组件
-
-- [MessageTools](../components/feedback/message-tools) — 消息工具栏
-- [ChatInput](../components/input/chat-input) — 输入与状态
-- [MessageContainer](../components/setup/message-container) — 工具与消息展示

package/skills/blueking-chat-x/references/types/interrupt.md

@@ -1,379 +0,0 @@
-# 中断类型 Interrupt
-
-> since 2.0.0
-
-定义 RunFinishedOutcome、BaseInterrupt、AIDevToolApprovalInterrupt、AIDevToolApprovalResume、UserQuestionInterrupt、InterruptResult、BaseResume、InterruptMessage 与 OnInterruptResume。 与 MessageRole.Interrupt、InterruptMessageRender、UserQuestionCard、ToolApprovalCard 配合，对应 RUN_FINISHED outcome。
-
-**关联**：interrupt-message（根据 outcome.interrupts 与 reason 渲染中断 UI，success 时按 result.reason 回显审批单或用户回答）、user-question-card（UserQuestion 交互面板，挂载在 ChatInput 上方）、tool-approval-card（AIDevToolApproval 专用卡片）、message-render（role 为 interrupt 时派发 InterruptMessageRender）
-
----
-
-# 中断类型 Interrupt
-
-> **分类**：type
-
-AG-UI [Interrupts](https://docs.ag-ui.com/drafts/interrupts) 协议相关类型，定义在 `src/ag-ui/types/interrupt.ts`，由 `@blueking/chat-x` 导出。
-
-中断链路分为两段：
-
-1. Agent 返回 `RUN_FINISHED { outcome: { type: 'interrupt', interrupts } }`，前端渲染等待用户处理的 UI。
-2. 用户操作后调用 `onInterruptResume(payload, interrupt?)`，业务侧按 `payload.operation` 分支处理，并将 `payload` 作为 `RunAgentInput.resume` 回传给 Agent。
-
-## InterruptResumeOperation
-
-统一标识用户在「中断消息 / 活动消息」上触发的、需回传 Agent 处理的动作：
-
-```typescript
-enum InterruptResumeOperation {
-  /** 主动取消第三方工具审批 */
-  ApprovalCancel = 'approval_cancel',
-  /** 刷新第三方工具审批：刷新审批单状态 */
-  ApprovalRefresh = 'approval_refresh',
-  /** 重试失败的流程节点（bkflow） */
-  FlowNodeRetry = 'flow_node_retry',
-  /** 跳过失败的流程节点（bkflow） */
-  FlowNodeSkip = 'flow_node_skip',
-}
-```
-
-业务侧通过 `onInterruptResume` 回调的 `payload.operation` 字段进行分支处理；新增操作类型只需扩展此枚举，回调契约与透传链路保持不变。
-
-## RunFinishedOutcome
-
-`RUN_FINISHED` 事件的 `outcome` 联合类型：
-
-```typescript
-type RunFinishedOutcome =
-  | { interrupts: Interrupt[]; type: 'interrupt' }
-  | { type: 'success' };
-```
-
-| `type`        | 说明                                                                 |
-| ------------- | -------------------------------------------------------------------- |
-| `'interrupt'` | 等待用户响应；`interrupts` 驱动 UI 渲染审批卡片、用户问题面板等       |
-| `'success'`   | 用户已通过 `resume` 处理；按 `result.reason` 在会话内回显审批单（`AIDevToolApproval`）或用户回答（`UserQuestion`） |
-
-## BaseInterrupt
-
-所有中断项的公共结构：
-
-```typescript
-type BaseInterrupt<T extends InterruptReason, M extends Record<string, any>> = {
-  expiresAt?: string;
-  id: string;
-  message?: string;
-  metadata?: M;
-  properties?: Record<string, any>;
-  reason: T;
-  toolCallId: string;
-};
-```
-
-## AIDevToolApprovalInterrupt
-
-AI Dev 第三方工具审批中断，`reason` 为 `InterruptReason.AIDevToolApproval`（`'aidev:tool_approval'`）：
-
-```typescript
-type AIDevToolApprovalInterruptPayloadMetaData = {
-  ticket: {
-    approvers: string[];
-    sn: string;
-    status: APPROVAL_STATUS;
-    submit_time: string;
-    title: string;
-    url: string;
-  };
-};
-
-type AIDevToolApprovalInterrupt = BaseInterrupt<
-  InterruptReason.AIDevToolApproval,
-  AIDevToolApprovalInterruptPayloadMetaData
->;
-```
-
-## AIDevToolApprovalResume
-
-AI Dev 第三方工具审批中断响应（resume 后用于 `outcome.success` 时会话内回显审批单）。`payload.metadata` 透传中断时的 `metadata`（含 `ticket`），以便复用 `ToolApprovalCard` 只读渲染：
-
-```typescript
-type AIDevToolApprovalResume = BaseResume<
-  InterruptReason.AIDevToolApproval,
-  { metadata: AIDevToolApprovalInterruptPayloadMetaData }
->;
-```
-
-## UserQuestionInterrupt
-
-用户回答问题中断，`reason` 为 `InterruptReason.UserQuestion`（`'aidev:user_question'`）。交互面板由 `ChatContainer` 挂载到 `ChatInput` 上方。
-
-```typescript
-type UserQuestionInterrupt = BaseInterrupt<
-  InterruptReason.UserQuestion,
-  {
-    questions: UserQuestionItem[];
-  }
->;
-
-type UserQuestionItem = {
-  header: string;
-  /** 是否多选；仅选择题语义，自定义表单类问题可不传 */
-  multiSelect?: boolean;
-  options?: UserQuestionOptionItem[];
-  question: string;
-};
-
-type UserQuestionOptionItem = {
-  description: string;
-  label: string;
-};
-```
-
-约定：
-
-- `multiSelect: false` 表示单选题，`true` 表示多选题；**不传**时 UI 不展示单选/多选标签，默认选择题组件仍按单选行为处理。
-- 前端会为每道**选择题**追加 `label: 'others'` 的自由输入项；后端无需重复下发该选项。
-- 当用户选择 Others 时，`answer[].description` 为用户输入文本。
-- 业务可通过 `UserQuestionCard` 的 `#question` slot 渲染自定义表单；作答有效时调用 `setAnswer` 回传 `UserQuestionAnswerItem`，无效时传 `undefined`。
-- UI 一次只展示一题：标题栏 `< 当前题 / 总题数 >` 切换；单选预设选项作答后自动跳下一题，多选 / Others 需手动切换（协议字段不变）。
-
-## Interrupt
-
-当前支持的中断联合类型：
-
-```typescript
-type Interrupt =
-  | AIDevToolApprovalInterrupt
-  | UserQuestionInterrupt
-  | BaseInterrupt<InterruptReason, Record<string, any>>;
-```
-
-## InterruptResult
-
-中断处理结果（resume 后回传/持久化，用于 `outcome.success` 时会话内回显）。按 `reason` 区分不同结果形态，统一具备 `BaseResume` 的 `{ interruptId, reason, status }`；新增中断类型的回显结果只需在此联合扩展：
-
-```typescript
-type InterruptResult = AIDevToolApprovalResume | UserQuestionResume;
-```
-
-## InterruptResume 联合类型
-
-用户操作后通过 `onInterruptResume` 回传的负载（与 `InterruptResult` 用途不同：`InterruptResume` 侧重**动作回传**，`InterruptResult` 侧重**success 态会话内回显**）：
-
-```typescript
-type InterruptResume = FlowNodeResume | ToolApprovalResume | UserQuestionResume;
-```
-
-| 类型                 | `operation` / `reason`              | 说明                                                         |
-| -------------------- | ----------------------------------- | ------------------------------------------------------------ |
-| `ToolApprovalResume` | `InterruptResumeOperation.ApprovalCancel` / `ApprovalRefresh` | 第三方工具审批取消 / 刷新审批单状态                           |
-| `FlowNodeResume`     | `flow_node_retry` / `flow_node_skip` | FlowAgent 失败节点重试 / 跳过；**无**对应 `Interrupt` 项     |
-| `UserQuestionResume` | `InterruptReason.UserQuestion`（`reason` 字段） | 用户回答问题                                                 |
-
-### ToolApprovalResume
-
-```typescript
-type ToolApprovalResume = {
-  operation: InterruptResumeOperation.ApprovalCancel | InterruptResumeOperation.ApprovalRefresh;
-  payload: { interrupt_id: number | string };
-};
-```
-
-### FlowNodeResume
-
-流程节点不属于 interrupt，节点定位信息（`task_id` / `node_id`）随 `payload` 回传；此时 `onInterruptResume` 的第二个 `interrupt` 参数**不传**。
-
-```typescript
-type FlowNodeResume = {
-  operation: InterruptResumeOperation.FlowNodeRetry | InterruptResumeOperation.FlowNodeSkip;
-  payload: {
-    node_id: string;
-    task_id: number;
-  };
-};
-```
-
-## BaseResume / UserQuestionResume
-
-`UserQuestion` 的 resume payload 为单个对象，与 `chat-helper` 的 `IResume` 保持一致：
-
-```typescript
-type BaseResume<T extends InterruptReason, P extends Record<string, any>> = {
-  interruptId: string;
-  payload: P;
-  reason: T;
-  status: 'cancelled' | 'resolved';
-};
-
-type UserQuestionAnswerItem = {
-  answer: UserQuestionOptionItem[];
-  multiSelect?: boolean;
-  question: string;
-};
-
-type UserQuestionResume = BaseResume<
-  InterruptReason.UserQuestion,
-  {
-    answers: UserQuestionAnswerItem[];
-  }
->;
-```
-
-示例：
-
-```typescript
-const resume: UserQuestionResume = {
-  interruptId: 'interrupt_user_question',
-  reason: InterruptReason.UserQuestion,
-  status: 'resolved',
-  payload: {
-    answers: [
-      {
-        question: '请选择语言',
-        multiSelect: true,
-        answer: [
-          { label: 'Java', description: 'Java' },
-          { label: 'others', description: 'Rust' },
-        ],
-      },
-    ],
-  },
-};
-```
-
-## InterruptMessage
-
-`MessageRole.Interrupt` 对应的消息类型，`content` 承载 outcome、可选说明文案与 resume 结果：
-
-```typescript
-type InterruptMessage = BaseMessage<
-  MessageRole.Interrupt,
-  {
-    message?: string;
-    outcome?: RunFinishedOutcome;
-    result?: InterruptResult;
-    runId?: string;
-    threadId?: string;
-  }
->;
-```
-
-| 字段       | 说明                                                         |
-| ---------- | ------------------------------------------------------------ |
-| `message`  | 消息组顶部可选说明文案，由 `InterruptMessageRender` 展示     |
-| `outcome`  | `type: 'interrupt'` 时从 `interrupts` 渲染交互；`success` 时进入已处理态 |
-| `result`   | 用户 resume 后回传/持久化的 `InterruptResult`；按 `reason` 在会话内回显审批单或用户回答 |
-| `runId`    | 关联 AG-UI run 标识                                          |
-| `threadId` | 关联会话线程标识                                             |
-
-## OnInterruptResume
-
-用户完成中断操作或 FlowAgent 节点操作后的回调（由 `ChatContainer` / `MessageContainer` / `MessageRender` 透传）：
-
-```typescript
-type OnInterruptResume = (
-  payload: InterruptResume,
-  interrupt?: Interrupt,
-) => Promise<void> | void;
-```
-
-| 参数        | 说明                                                                                                       |
-| ----------- | ---------------------------------------------------------------------------------------------------------- |
-| `payload`   | 用户操作产生的 resume 负载；通过 `payload.operation`（或 `UserQuestionResume.reason`）区分动作类型         |
-| `interrupt` | 原始中断项；审批取消、用户问题等中断来源**必传**；FlowAgent 节点重试 / 跳过等非中断来源**不传**             |
-
-| `payload.operation`              | 触发场景                         | `interrupt` |
-| -------------------------------- | -------------------------------- | ----------- |
-| `approval_cancel`                | `ToolApprovalCard` 取消审批      | 必传        |
-| `flow_node_retry` / `flow_node_skip` | `FlowAgentContent` 失败节点操作 | 不传        |
-| —（`UserQuestionResume`）        | `UserQuestionCard` 提交回答      | 必传        |
-
-## 使用示例
-
-```typescript
-import {
-  APPROVAL_STATUS,
-  InterruptReason,
-  InterruptResumeOperation,
-  MessageRole,
-  MessageStatus,
-  type InterruptMessage,
-  type OnInterruptResume,
-} from '@blueking/chat-x';
-
-const message: InterruptMessage = {
-  id: 'msg_interrupt_1',
-  messageId: 'msg_interrupt_1',
-  role: MessageRole.Interrupt,
-  status: MessageStatus.Pending,
-  content: {
-    message: '需要您处理以下中断',
-    outcome: {
-      type: 'interrupt',
-      interrupts: [
-        {
-          id: 'interrupt_approval_1',
-          reason: InterruptReason.AIDevToolApproval,
-          toolCallId: 'tool_call_approval_1',
-          metadata: {
-            ticket: {
-              approvers: ['张三'],
-              sn: 'REV-2026-04-24-001',
-              status: APPROVAL_STATUS.PENDING,
-              submit_time: '2026-04-24 14:30:15',
-              title: '算法方案评审单',
-              url: 'https://example.com/tickets/REV-2026-04-24-001',
-            },
-          },
-        },
-        {
-          id: 'interrupt_question_1',
-          reason: InterruptReason.UserQuestion,
-          toolCallId: 'tool_call_question_1',
-          message: '请选择实现方案',
-          metadata: {
-            questions: [
-              {
-                header: '请选择实现方案',
-                multiSelect: false,
-                question: '你希望采用哪种排序实现？',
-                options: [
-                  { label: 'basic', description: '基础冒泡排序' },
-                  { label: 'optimized', description: '提前终止优化版' },
-                ],
-              },
-            ],
-          },
-        },
-      ],
-    },
-  },
-};
-
-const handleInterruptResume: OnInterruptResume = async (payload, interrupt) => {
-  if ('operation' in payload) {
-    switch (payload.operation) {
-      case InterruptResumeOperation.ApprovalCancel:
-        console.log('取消审批', payload.payload.interrupt_id, interrupt?.id);
-        break;
-      case InterruptResumeOperation.ApprovalRefresh:
-        console.log('刷新审批单', payload.payload.interrupt_id, interrupt?.id);
-        break;
-      case InterruptResumeOperation.FlowNodeRetry:
-      case InterruptResumeOperation.FlowNodeSkip:
-        console.log('流程节点操作', payload.operation, payload.payload);
-        break;
-    }
-    return;
-  }
-  // UserQuestionResume
-  console.log('用户问题 resume', interrupt?.id, payload);
-};
-```
-
-## 关联文档
-
-- [常量枚举 Constants](./constants.md) — `InterruptReason`、`APPROVAL_STATUS`
-- [消息类型 Messages](./messages.md) — `InterruptMessage` 在消息联合类型中的位置
-- [InterruptMessage 中断消息](../components/agent/interrupt-message)
-- [UserQuestionCard 用户问题中断](../components/agent/user-question-card)
-- [ToolApprovalCard 审批卡片](../components/agent/tool-approval-card)