@blueking/chat-x 0.0.45-beta.5 → 0.0.45-beta.6

package/dist/mcp/generated/docs/tool-approval-card.md

@@ -1,148 +0,0 @@
-<!-- AI SUMMARY -->
-## 快速了解
-
-渲染 AIDevToolApproval 中断的审批信息与取消操作。 源码位置：src/components/chat-message/interrupt-message/tool-approval-card.vue。
-
-### 关联组件
-- **interrupt-message** — InterruptMessageRender 按 reason 派发渲染
-
----
-<!-- FULL DOC -->
-
-# ToolApprovalCard 审批卡片
-## 源码事实
-
-- **源码位置**：`src/components/chat-message/interrupt-message/tool-approval-card.vue`
-- **能力域**：Agent 能力
-- **能力说明**：渲染 AIDevToolApproval 中断的审批信息与取消操作。
-
-> **能力域**：Agent 能力
-
-AI Dev 第三方工具审批（`InterruptReason.AIDevToolApproval`）专用卡片，由 [InterruptMessageRender](/components/agent/interrupt-message) 按 `reason` 动态挂载。
-
-> **通常不需要单独引入**；仅在需要独立预览卡片样式时使用。
-
-## 渲染结构
-
-```
-ToolApprovalCard
-├── 标题栏：左侧色条 + 单据标题 + 复制图标 + 状态徽章（评审中/已通过/已拒绝/已撤销等）
-├── 字段区：单据编号、提交时间
-├── 处理人：当前处理人（overflow-tips 省略）
-└── 操作区：查看单据详情（新窗口打开 url）、取消审批（仅 pending / draft）
-```
-
-状态徽章样式：
-
-| `ticket.status`                         | 视觉     |
-| --------------------------------------- | -------- |
-| `pending`、`draft`                      | 蓝色评审中 |
-| `approved`                              | 绿色通过 |
-| `rejected`、`cancelled`、`expired`、`abandoned` | 红色终态 |
-| `revoked`                               | 橙色已撤销 |
-
-## 基础用法（待审批）
-
-> `ToolApprovalCard` 为 `InterruptMessageRender` 内部子组件，**未从 `@blueking/chat-x` 包入口导出**。业务侧通过构造 `InterruptMessage` 触发渲染即可；下方为类型与数据结构参考。
-
-```vue
-<template>
-  <!-- 业务侧推荐：由 MessageRender / MessageContainer 自动渲染 -->
-  <InterruptMessageRender
-    :content="interruptMessage.content"
-    role="interrupt"
-    :status="interruptMessage.status"
-    :on-interrupt-resume="handleInterruptResume"
-  />
-</template>
-
-<script setup lang="ts">
-  import {
-    InterruptMessageRender,
-    APPROVAL_STATUS,
-    InterruptReason,
-    MessageRole,
-    MessageStatus,
-    type InterruptMessage,
-    type AIDevToolApprovalInterrupt,
-  } from '@blueking/chat-x';
-
-  const interrupt: AIDevToolApprovalInterrupt = {
-    id: 'interrupt_1',
-    reason: InterruptReason.AIDevToolApproval,
-    toolCallId: 'tool_call_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/001',
-      },
-    },
-  };
-
-  const interruptMessage: InterruptMessage = {
-    id: 'msg_1',
-    messageId: 'msg_1',
-    role: MessageRole.Interrupt,
-    status: MessageStatus.Pending,
-    content: {
-      outcome: { type: 'interrupt', interrupts: [interrupt] },
-    },
-  };
-
-  const handleInterruptResume = async (payload, interrupt) => {
-    console.log(payload, interrupt.id);
-  };
-</script>
-```
-
-**渲染效果**（文档站直接挂载 `ToolApprovalCard` 预览卡片 UI）
-
-## 已通过 / 已拒绝 / 已撤销
-
-```vue
-<div>
-  <InterruptMessageRender
-    :content="{ outcome: { type: 'interrupt', interrupts: [approvedInterrupt] } }"
-    role="interrupt"
-  />
-  <InterruptMessageRender
-    :content="{ outcome: { type: 'interrupt', interrupts: [rejectedInterrupt] } }"
-    role="interrupt"
-  />
-  <InterruptMessageRender
-    :content="{ outcome: { type: 'interrupt', interrupts: [revokedInterrupt] } }"
-    role="interrupt"
-  />
-</div>
-```
-
-**渲染效果**
-
-## API
-
-### Props
-
-| 属性名            | 类型                         | 默认值 | 说明                                         |
-| ----------------- | ---------------------------- | ------ | -------------------------------------------- |
-| interrupt         | `AIDevToolApprovalInterrupt` | —      | **必填**，含 `metadata.ticket`               |
-| onInterruptResume | `OnInterruptResume`          | —      | 取消审批时触发，签名为 `(payload, interrupt)`，payload 为 `{ operation: InterruptResumeOperation.ApprovalCancel, payload: { interrupt_id } }` |
-
-### Events / Slots / Expose
-
-无。打开链接、复制剪贴板在组件内部完成；取消审批通过 `onInterruptResume({ operation: InterruptResumeOperation.ApprovalCancel, payload: { interrupt_id: interrupt.id } }, interrupt)` 通知业务侧处理。
-
-## 依赖
-
-- `bkui-vue`：`Button`、`Loading`
-- `useClipboard` — 复制单据
-- `v-overflow-tips` — 处理人超长省略
-
-## 关联组件
-
-- [InterruptMessage 中断消息](/components/agent/interrupt-message)
-- [中断类型 Interrupt](../../types/interrupt.md)
-- [常量枚举 Constants](../../types/constants.md) — `APPROVAL_STATUS`、`APPROVAL_STATUS_MAP`

package/dist/mcp/generated/docs/use-flow-node-actions.md

@@ -1,124 +0,0 @@
-<!-- AI SUMMARY -->
-## 快速了解
-
-useFlowNodeActions 接收 onInterruptResume 与 openNodeDetail，返回 getNodeActions(task, node)。 失败节点按 retryable/skippable 展示重试/跳过，详情恒在末尾；点击 resume 时不传 interrupt。
-
-### 关联组件
-- **flow-agent-content** — FlowAgentContent 内部消费，驱动节点行尾按钮组渲染
-
----
-<!-- FULL DOC -->
-
-# useFlowNodeActions 节点行尾操作
-
-> **分类**：composable
-
-将 FlowAgent 节点行尾的「详情（打开侧栏）」与「重试 / 跳过（回传 Agent resume）」聚合为统一的声明式操作列表。`FlowAgentContent` 只需遍历 `getNodeActions` 返回值渲染按钮，显隐与点击行为均收敛于此 composable。
-
-源码：`src/components/chat-content/flow-agent-content/use-flow-node-actions.ts`
-
-## 函数签名
-
-```typescript
-function useFlowNodeActions(options: {
-  /** resume 回调（与第三方审批取消同一回调，按 payload.operation 分流） */
-  onInterruptResume: Ref<OnInterruptResume | undefined>;
-  /** 打开节点详情侧栏（复用 useFlowTab 的能力） */
-  openNodeDetail: (task: BkFlowTask, node: BkFlowNode) => void;
-}): {
-  getNodeActions: (task: FlowTaskVM, node: FlowNodeVM) => FlowNodeActionVM[];
-};
-```
-
-## 返回值：FlowNodeActionVM
-
-```typescript
-type FlowNodeActionId =
-  | 'detail'
-  | InterruptResumeOperation.FlowNodeRetry
-  | InterruptResumeOperation.FlowNodeSkip;
-
-interface FlowNodeActionVM {
-  icon: Component;
-  id: FlowNodeActionId;
-  label: string;
-  run: () => void;
-}
-```
-
-| 字段    | 说明                           |
-| ------- | ------------------------------ |
-| `icon`  | 按钮图标组件                   |
-| `id`    | 唯一标识，用于 `v-for` key     |
-| `label` | 国际化文案                     |
-| `run`   | 点击执行（详情或 resume）      |
-
-## 操作显隐规则
-
-| 操作 | `id`               | 显隐条件                                   | 点击行为                                      |
-| ---- | ------------------ | ------------------------------------------ | --------------------------------------------- |
-| 重试 | `flow_node_retry`  | `convergedState === 'failed'` 且 `retryable` | 调用 `onInterruptResume`，**不传** `interrupt` |
-| 跳过 | `flow_node_skip`   | `convergedState === 'failed'` 且 `skippable` | 同上                                          |
-| 详情 | `detail`           | 始终（Share 模式由上层组件隐藏整组）       | 调用 `openNodeDetail(task.raw, node.raw)`     |
-
-展示顺序：重试 → 跳过 → 详情。
-
-## resume 负载格式
-
-```typescript
-// 重试
-onInterruptResume?.({
-  operation: InterruptResumeOperation.FlowNodeRetry,
-  payload: { node_id: node.id, task_id: task.task_id },
-});
-
-// 跳过
-onInterruptResume?.({
-  operation: InterruptResumeOperation.FlowNodeSkip,
-  payload: { node_id: node.id, task_id: task.task_id },
-});
-```
-
-## 使用示例
-
-`FlowAgentContent` 内部用法（业务侧通常通过 `MessageRender` 传入 `onInterruptResume`，无需直接调用本 composable）：
-
-```typescript
-import { toRef } from 'vue';
-import { useFlowNodeActions } from '@blueking/chat-x';
-// 或相对路径：'./use-flow-node-actions'
-
-const { getNodeActions } = useFlowNodeActions({
-  onInterruptResume: toRef(props, 'onInterruptResume'),
-  openNodeDetail,
-});
-
-// 模板中
-// v-for="action in getNodeActions(task, node)" :key="action.id"
-// @click.stop="action.run()"
-```
-
-## 扩展新操作
-
-在 `RESUME_ACTION_DEFS` 注册表中追加一项即可，需声明 `visible` 与 `operation` 枚举：
-
-```typescript
-const RESUME_ACTION_DEFS: FlowNodeResumeActionDef[] = [
-  // 现有：重试、跳过
-  {
-    icon: MyIcon,
-    id: InterruptResumeOperation.MyNewOp, // 需先在 InterruptResumeOperation 扩展
-    label: () => t('新操作'),
-    visible: node => /* 自定义显隐 */,
-  },
-];
-```
-
-同时在 `interrupt.ts` 扩展 `InterruptResumeOperation` 与 `FlowNodeResume` 联合类型。
-
-## 关联文档
-
-- [FlowAgentContent 执行内容](/components/agent/flow-agent-content) — 消费方组件
-- [中断类型 Interrupt](/types/interrupt) — `InterruptResumeOperation`、`FlowNodeResume`、`OnInterruptResume`
-- [ActivityMessage 活动消息](/components/message/activity-message) — `onInterruptResume` 透传链路
-- [MessageRender 消息渲染器](/components/message/message-render) — 顶层透传入口

package/dist/mcp/generated/docs/user-question-answered-card.md

@@ -1,106 +0,0 @@
-<!-- AI SUMMARY -->
-## 快速了解
-
-在 UserQuestion resume 成功后回显用户回答或取消状态。 源码位置：src/components/chat-message/interrupt-message/user-question/user-question-answered-card.vue。
-
-### 关联组件
-- **interrupt-message** — outcome.success 且 reason 为 UserQuestion 时挂载本组件
-- **user-question-card** — 待回答面板，与本组件成对出现
-
----
-<!-- FULL DOC -->
-
-# UserQuestionAnsweredCard 用户问题回答回显
-
-> **能力域**：Agent 能力
-
-## 源码事实
-
-- **源码位置**：`src/components/chat-message/interrupt-message/user-question/user-question-answered-card.vue`
-- **能力说明**：在 UserQuestion resume 成功后回显用户回答或取消状态。
-
-由 [InterruptMessageRender](/components/agent/interrupt-message) 在 `content.outcome.type === 'success'` 且 `result.reason === InterruptReason.UserQuestion` 时渲染。默认逐条展示选择题答案；业务可通过 `#answer` slot 自定义回显形态（如自定义表单字段）。
-
-## 基础用法
-
-```vue
-<template>
-  <UserQuestionAnsweredCard
-    :answers="answers"
-    status="resolved"
-  />
-</template>
-
-<script setup lang="ts">
-  import { UserQuestionAnsweredCard, type UserQuestionAnswerItem } from '@blueking/chat-x';
-
-  const answers: UserQuestionAnswerItem[] = [
-    {
-      question: '你希望采用哪种实现？',
-      multiSelect: false,
-      answer: [{ label: 'optimized', description: '优化版' }],
-    },
-  ];
-</script>
-```
-
-**渲染效果**
-
-## 已取消（跳过）
-
-```vue
-<UserQuestionAnsweredCard
-  :answers="[]"
-  status="cancelled"
-/>
-```
-
-**渲染效果**
-
-## 自定义回显（#answer slot）
-
-当待回答阶段使用了自定义 `#question` 表单时，可通过 `#answer` slot 自定义回显：
-
-```vue
-<UserQuestionAnsweredCard
-  :answers="answers"
-  status="resolved"
->
-  <template #answer="{ item, index, status }">
-    <MyCustomAnswerView :data="item" :index="index" :status="status" />
-  </template>
-</UserQuestionAnsweredCard>
-```
-
-`InterruptMessageRender`、`MessageRender`、`MessageContainer` 提供 `#answeredQuestion` slot，参数与 `#answer` 一致，逐层透传至本组件。使用 `ChatContainer` 时若覆盖了 `#message` 插槽，需在自定义 `MessageRender` 中继续透传 `#answeredQuestion`。
-
-## API
-
-### Props
-
-| 属性名  | 类型                         | 默认值       | 说明                                   |
-| ------- | ---------------------------- | ------------ | -------------------------------------- |
-| answers | `UserQuestionAnswerItem[]`   | —            | **必填**，已回答内容列表               |
-| status  | `'resolved' \| 'cancelled'` | `'resolved'` | resume 状态：`resolved` 已回复，`cancelled` 已取消（跳过） |
-
-### Slots
-
-| 插槽名 | 参数                                              | 说明                                                         |
-| ------ | ------------------------------------------------- | ------------------------------------------------------------ |
-| answer | `{ item, index, status }`                         | 自定义单题回答回显；未覆盖时默认渲染 `answer[].description \|\| label` |
-
-| 参数   | 类型                              | 说明                     |
-| ------ | --------------------------------- | ------------------------ |
-| item   | `UserQuestionAnswerItem`          | 当前题的回答数据         |
-| index  | `number`                          | 题目序号（从 0 开始）    |
-| status | `'resolved' \| 'cancelled'`      | 与 Props.status 一致     |
-
-### Events / Expose
-
-无。
-
-## 关联文档
-
-- [InterruptMessage 中断消息](/components/agent/interrupt-message)
-- [UserQuestionCard 用户问题中断](/components/agent/user-question-card)
-- [中断类型 Interrupt](../../types/interrupt.md)

package/dist/mcp/generated/docs/user-question-card.md

@@ -1,228 +0,0 @@
-<!-- AI SUMMARY -->
-## 快速了解
-
-渲染 UserQuestion 中断的待回答面板，支持单选、多选、Others 与跳过。 源码位置：src/components/chat-message/interrupt-message/user-question/user-question-card.vue。
-
-### 关联组件
-- **interrupt-message** — outcome.success 时挂载 UserQuestionAnsweredCard 回显回答
-- **chat-container** — 检测最近待回答 UserQuestion 并把 UserQuestionCard 放在输入区上方
-- **interrupt** — 定义 UserQuestionInterrupt 与 UserQuestionResume 协议
-
----
-<!-- FULL DOC -->
-
-# UserQuestionCard 用户问题中断
-## 源码事实
-
-- **源码位置**：`src/components/chat-message/interrupt-message/user-question/user-question-card.vue`
-- **能力域**：Agent 能力
-- **能力说明**：渲染 UserQuestion 中断的待回答面板，支持单选、多选、Others 与跳过。
-
-> **能力域**：Agent 能力
-
-`UserQuestionCard` 用于渲染 `InterruptReason.UserQuestion`（`'aidev:user_question'`）中断。它通常由 `ChatContainer` 自动挂载到 `ChatInput` 上方，用户回答后通过 `onInterruptResume(payload, interrupt)` 回传 `UserQuestionResume`。
-
-## 交互能力
-
-- **单选 / 多选**：每道题通过 `multiSelect` 控制选择行为；未传时不展示单选/多选标签，默认仍按单选处理。
-- **Others 自由输入**：默认 [UserQuestionChoice](/components/agent/user-question-choice) 为每道题追加 `label: 'others'` 输入项，输入文本写入 `answer[].description`。
-- **自定义作答形态**：通过 `#question` slot 可替换默认选择题，渲染任意表单；作答有效时调用 `setAnswer` 回传 `UserQuestionAnswerItem`，无效时传 `undefined`。
-- **完成校验**：所有题目均已作答（`setAnswer` 收到有效答案）后才允许点击「完成」。
-- **跳过**：点击「跳过」返回 `status: 'cancelled'` 与空 `answers`。
-- **输入框发送**：存在待回答 UserQuestion 时，用户也可在 `ChatInput` 直接发送；`ChatContainer` 会调用 `onSendMessage` 并在第三参数附带与「跳过」等价的 skip `payload` 及 `interrupt`，输入框内容不会自动清空。
-
-## 数据协议
-
-待回答中断：
-
-```typescript
-const interrupt = {
-  id: 'interrupt_user_question',
-  reason: InterruptReason.UserQuestion,
-  toolCallId: 'tool_call_user_question',
-  message: '请选择实现方案',
-  metadata: {
-    questions: [
-      {
-        header: '请选择实现方案',
-        multiSelect: false,
-        question: '你希望采用哪种冒泡排序实现？',
-        options: [
-          { label: 'basic', description: '基础冒泡排序' },
-          { label: 'optimized', description: '优化版冒泡排序' },
-        ],
-      },
-    ],
-  },
-};
-```
-
-完成回答后生成的 resume：
-
-```typescript
-const payload = {
-  interruptId: 'interrupt_user_question',
-  reason: InterruptReason.UserQuestion,
-  status: 'resolved',
-  payload: {
-    answers: [
-      {
-        question: '你希望采用哪种冒泡排序实现？',
-        multiSelect: false,
-        answer: [{ label: 'optimized', description: '优化版冒泡排序' }],
-      },
-    ],
-  },
-};
-```
-
-## 基础用法
-
-> 业务侧通常不直接使用本组件；推荐构造 `InterruptMessage` 后交给 `ChatContainer` / `MessageContainer` 渲染。下面示例用于说明组件 API 和 payload 形状。
-
-```vue
-<template>
-  <UserQuestionCard
-    :interrupt="pendingInterrupt"
-    :on-resume="handleResume"
-  />
-</template>
-
-<script setup lang="ts">
-  import { InterruptReason, UserQuestionCard, type OnInterruptResume } from '@blueking/chat-x';
-
-  const pendingInterrupt = {
-    id: 'interrupt_user_question',
-    reason: InterruptReason.UserQuestion,
-    toolCallId: 'tool_call_user_question',
-    metadata: {
-      questions: [
-        {
-          header: '请选择实现方案',
-          multiSelect: false,
-          question: '你希望采用哪种实现？',
-          options: [{ label: 'basic', description: '基础冒泡排序' }],
-        },
-      ],
-    },
-  };
-
-  const handleResume: OnInterruptResume = async (payload, interrupt) => {
-    console.log(interrupt.id, payload);
-  };
-</script>
-```
-
-**渲染效果**
-
-## 已回答回显
-
-`InterruptMessageRender` 在 `content.outcome.type === 'success'` 且 `content.result.reason === InterruptReason.UserQuestion` 时，会在会话内渲染 `UserQuestionAnsweredCard`。
-
-```vue
-<UserQuestionAnsweredCard
-  :answers="answers"
-  status="resolved"
-/>
-```
-
-**渲染效果**
-
-## ChatContainer 自动挂载
-
-`ChatContainer` 内部通过 `useMessageGroup` 查找最近一条 `outcome.type === 'interrupt'` 的 `UserQuestion`，并在 `ChatInput` 的 `#interrupt` 插槽中渲染 `UserQuestionCard`：
-
-```vue
-<ChatContainer
-  v-model="inputValue"
-  :messages="messages"
-  :on-interrupt-resume="handleResume"
-  :on-send-message="handleSendMessage"
-/>
-```
-
-- 卡片内「完成 / 跳过」→ `onInterruptResume(payload, interrupt)`
-- 输入框直接发送 → `onSendMessage(content, docSchema, { interrupt, payload })`，其中 `payload` 由 `buildSkipResumePayload(interrupt)` 生成（`status: 'cancelled'`）
-
-## 工具函数 buildSkipResumePayload
-
-从 `@blueking/chat-x` 导出，用于构造 UserQuestion 的 skip resume（与卡片「跳过」及输入框发送时容器注入的 `options.payload` 一致）：
-
-```typescript
-import { buildSkipResumePayload, InterruptReason } from '@blueking/chat-x';
-
-const payload = buildSkipResumePayload(interrupt);
-// {
-//   interruptId: interrupt.id,
-//   reason: InterruptReason.UserQuestion,
-//   status: 'cancelled',
-//   payload: { answers: [] },
-// }
-```
-
-## 自定义题目渲染（#question slot）
-
-默认每道题由 [UserQuestionChoice](/components/agent/user-question-choice) 渲染；业务可覆盖 `#question` slot 接入自定义表单：
-
-```vue
-<template>
-  <UserQuestionCard
-    :interrupt="pendingInterrupt"
-    :on-resume="handleResume"
-  >
-    <template #question="{ question, qIndex, answer, setAnswer, confirm }">
-      <!-- 自定义表单：作答有效时 setAnswer(answerItem)，无效时 setAnswer(undefined) -->
-      <MyCustomForm
-        :model="question"
-        @change="setAnswer"
-        @submit="confirm"
-      />
-    </template>
-  </UserQuestionCard>
-</template>
-```
-
-`ChatContainer` 提供同名 `#interruptQuestion` slot，参数与 `#question` 一致，透传自输入区上方的 `UserQuestionCard`。
-
-## API
-
-### UserQuestionCard Props
-
-| 属性名    | 类型                    | 默认值 | 说明                                   |
-| --------- | ----------------------- | ------ | -------------------------------------- |
-| interrupt | `UserQuestionInterrupt` | —      | **必填**，含 `metadata.questions`      |
-| onResume  | `OnInterruptResume`     | —      | 完成 / 跳过时触发，签名为 `(payload, interrupt)` |
-
-### UserQuestionAnsweredCard Props
-
-| 属性名  | 类型                         | 默认值       | 说明                         |
-| ------- | ---------------------------- | ------------ | ---------------------------- |
-| answers | `UserQuestionAnswerItem[]`   | —            | 已回答内容列表               |
-| status  | `'resolved' \| 'cancelled'` | `'resolved'` | 回显状态，决定展示已回复/已取消 |
-
-### UserQuestionCard Slots
-
-| 插槽名   | 参数                                                                                                              | 说明                                                                 |
-| -------- | ----------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------- |
-| question | `{ question, qIndex, answer, setAnswer, confirm }`                                                                | 自定义单题渲染；未覆盖时回退 [UserQuestionChoice](/components/agent/user-question-choice) |
-
-slot 参数说明：
-
-| 参数       | 类型                                              | 说明                                           |
-| ---------- | ------------------------------------------------- | ---------------------------------------------- |
-| question   | `UserQuestionItem`                                | 原始题目数据                                   |
-| qIndex     | `number`                                          | 题目序号（从 0 开始）                          |
-| answer     | `UserQuestionAnswerItem \| undefined`             | 当前题已组装答案，`undefined` 表示未作答       |
-| setAnswer  | `(answer: UserQuestionAnswerItem \| undefined) => void` | 写入/清空当前题答案                            |
-| confirm    | `() => void`                                      | 触发「完成」，等价点击底部完成按钮（需全部已答） |
-
-### Events / Expose
-
-无。
-
-## 关联文档
-
-- [中断类型 Interrupt](../../types/interrupt.md)
-- [UserQuestionChoice 选择题](/components/agent/user-question-choice)
-- [InterruptMessage 中断消息](/components/agent/interrupt-message)
-- [ChatContainer 聊天容器](/components/setup/chat-container)