@deep-eye/core 0.9.0 → 1.0.0

package/CHANGELOG.md

@@ -2,6 +2,106 @@
 
 此文件记录 `@deep-eye/core` 的用户可见变更。新版本采用语义化版本，并按 `Added`、`Changed`、`Fixed`、`Removed` 分类记录。
 
+## [1.0.0] - 2026-07-31
+
+### Added
+
+- 新增共享侧栏拖拽手柄 `ChatSidebarResizeHandle`：细线 + 胶囊 grip，悬浮淡蓝色高亮，仅在侧栏打开且非全屏展开时显示。
+- 官方文档全面重写：安装引入、Props/事件/插槽、使用示例与全局 FAQ，覆盖 `ChatBot`、`ChatMessage`、`ChatSender`、`D3MindMap` 完整使用链路。
+- 文档示例补充可预览样例 PDF（`/files/q3.pdf`），并按 VitePress `base` 路径解析。
+
+### Changed
+
+- 侧栏宽度拖拽改为相对 `ChatBot` 根节点边界计算，嵌入非全屏容器时拖拽跟随指针，不再使用 `window.innerWidth`。
+- 工具调用图标轨道与思维链（`ChatReasoning`）脑图标对齐；同组工具名列宽同步，参数摘要水平对齐。
+- 文档与对外表述统一为企业 Agent Responses 协议，不再使用「火山方舟」措辞。
+
+### Fixed
+
+- 修复侧栏拖拽手柄被消息区/`overflow: hidden` 裁切、仅显示一半的问题。
+- 修复文档站点 PDF 预览因缺少 base 前缀与素材文件导致的 Vite 提示页问题。
+
+## [0.11.0] - 2026-07-29
+
+### Added
+
+- 新增 `ChatProvider`，统一提供七牛上传配置、只可收紧的附件限制、`ChatTheme`、颜色模式和实例 renderer。
+- 新增七牛 getToken + XHR 直传状态机，支持并发、进度、去重、取消、手动重试和完整响应校验。
+- 新增用户附件区、图片灯箱、可拖拽文件预览侧栏、Vue Office 与 Vidstack 懒加载预览、严格 sandbox HTML 预览。
+- 新增 `ChatReasoning`、`ChatToolGroup`、`ChatQueue`、`ChatFilePreview`、`ChatImageLightbox` 等公开 primitives。
+- 新增受控 `toolStates`、强类型 `tool-action`、工具审批、孤立工具结果警告与 renderer 注册 API。
+- 新增流式消息队列，支持编辑、删除、拖拽/按钮排序以及终态自动出队。
+- `ChatBot` 新增 `consume(Response)` 与 `abort()`，直接消费火山方舟 Responses API 原始 HTTP SSE，并公开 18 种官方事件与完整 `ResponseObject` 类型。
+- 标准 messages 支持 system、user、assistant、tool 四种角色，以及 text、image、video、audio、file 多模态输入。
+- `ConversationStreamStatus` 新增 `incomplete`；失败和异常 EOF 会保留已生成的部分 assistant 内容。
+- 正文、思考区流式输出改用逐帧平滑追赶，避免逐 delta 硬跳；思考区、工具调用结果区展开/收起高度过渡动画化。
+- 新增 `classifyChatError`，将失败归类为 `network`/`timeout`/`api`/`protocol`/`unknown`；`response-error` 事件随原始 `Error` 一并携带分类结果。
+- 用户主动停止（`aborted` 且无 error）时内联展示"已停止生成"状态，与失败态区分。
+- 多个并发工具调用改为扁平连接的时间线（去除嵌套的"执行了 A、B"分组折叠层，修复该分组标题因 `<button>` 默认居中样式导致与下方条目错位的问题），每条工具调用独立展开/折叠，完成态自动收起为单行摘要，视觉上更接近 Cursor/Codex 的工具调用列表。`running` 状态图标由易误读为"卡死转圈"的 spinner 改为随呼吸动画渐隐渐显的实心圆环。
+- 修复工具调用时间线中图标+连接线轨道占用行内布局宽度、导致工具名称文字比同一条消息里的正文文字多缩进约 26px 的问题：轨道改为绝对定位悬挂在内容左侧的空白区域，工具名称与正文文字现在水平起始位置对齐。
+- 修复工具调用展开详情后图标随连接线轨道整体高度垂直居中、与标题错位的问题：连接线改为固定顶部间距 + 弹性底部，图标始终与标题保持同一水平线，与折叠态一致。鼠标悬浮时仅 `tool-call-part__header`（标题行）显示背景色，不再覆盖到左侧图标与整行。
+- 文档新增连续 5 张图片堆叠展示示例（`ChatImageStackDemo`），演示折叠封面、九宫格展开与灯箱浏览。
+- `ChatSender` 新增 `quickActions`/`v-model:active-quick-action`，在 `+` 图标后可扩展一排快捷功能按钮，选中后收起为可移除的模式标签并联动占位符（豆包式交互）；模式标签的关闭按钮点击区域由 18px 增大到 22px，图标同步放大，避免误触/难以点击。
+
+### Changed
+
+- `ChatBot@send` 改为单一 `ChatSendPayload`；user 消息强制包含 `resource_files`，附件模型输入与持久化字段彻底分离。
+- `ChatSender` 改用可选 `v-model:draft` 与 `v-model:attachments`，流式时同时显示发送与停止操作。
+- assistant 固定按思考、工具组、最终正文渲染；思考区尊重用户手动展开选择。
+- 侧栏桌面默认宽度改为 42%，限制在 360px 至视口 72%，移动端使用全屏预览。
+- 默认消息操作栏只保留复制，错误以 assistant 内联状态显示并提供重试事件。
+- 一个 Responses 流统一聚合为一条 assistant 消息；正文、思考和 function call delta 立即显示，done 与终态 Response 权威校准结果。
+- `useConversation` 简化为 `appendMessage`、`setMessages` 与 `reset`。
+- Playground、README 与组件文档在原有富文本、工具、工件和表单示例上改用 Responses SSE。
+
+### Fixed
+
+- 兼容 `response.reasoning_summary_part.added` 中仅包含 `type: "summary_text"`、尚未包含 `text` 的官方事件序列。
+- 连续图片堆叠（`MediaImageStack`）折叠态的背景层不再向容器外溢出，避免遮挡上方消息文字。
+
+### Removed
+
+- 正文流式输出移除逐字闪烁的光标块，仅保留文字自然增长。
+- 移除复制操作栏的自绘 CSS 图标，改用 lucide `Copy`/`Check`/`CircleAlert`。
+- 移除 `ChatSender` 的 `modelValue`、`showToolbar`、`attach` 描述和 `(content, files?)` 发送签名。
+- 移除字符串 HTML 自定义菜单图标、blob 消息持久化与旧的独立 Sender 主题类型。
+- 移除公开的 `AiConversation` 组件导出。
+- 移除公开的 `useConversationStream`、completion/delta 类型、session/resume、event ID、last index 与 `[DONE]` 协议。
+- 移除 assistant 正文中的私有 Turn、`<summary>`、`<think>` 与 `🛠️` 标记解析。
+
+## [0.10.0] - 2026-07-28
+
+### Added
+
+- `ChatBot` 新增可完整替换内置输入框的 `#sender`，并透传 `#message`、`#prepend`、`#append`。
+- `AiConversation` 新增消息外壳及列表前后扩展插槽，`ChatMessage` 新增只替换规范化正文的 `#content`。
+- `ConversationMessage` 新增不透明业务扩展字段 `metadata`。
+- `useConversationStream` 新增 `ConversationStreamEvent`、`onEvent`、`initialLastIndex` 和响应式 `lastIndex`。
+
+### Changed
+
+- SSE 消费兼容标准 `data:`、`data:data:`、heartbeat、`event: session` 和 `event: end`；只有明确的 DONE 标记会完成，异常 EOF 可由调用方显式续传。
+- 原始 SSE 事件与完整 JSON chunk 会保留未知字段，数字 `lastEventId` 与逻辑 `lastIndex` 独立维护。
+
+### Fixed
+
+- 恢复 OpenAI 标准 tool-call delta 类型及按调用索引合并行为。
+- `ChatSender` 在浏览器媒体 API 不可用时安全降级。
+
+## [0.9.1] - 2026-07-28
+
+### Added
+
+- `ChatBot` 默认工件侧边栏新增 Preview/Code、复制、下载、展开/收起和关闭操作栏。
+
+### Changed
+
+- 工件侧边栏在桌面端与移动端使用更稳定的响应式布局，自定义 `sidebar` 插槽仍可完整替换默认预览。
+
+### Fixed
+
+- 工件预览关闭操作恢复为明确的关闭图标与“关闭侧边栏”可访问语义。
+
 ## [0.7.0] - 2026-07-23
 
 ### Added

package/README.md

@@ -1,148 +1,202 @@
 # @deep-eye/core
 
-深瞳前端团队企业级 Vue 3 组件库，提供 AI 会话、思维导图等可视化组件。
+深瞳前端团队的企业级 Vue 3 组件库，提供 AI 对话（`ChatBot` / `ChatMessage` / `ChatSender`）与可视化思维导图（`D3MindMap`）两类核心能力。
+
+## 环境要求
+
+| 依赖    | 最低版本                                    |
+| ------- | ------------------------------------------- |
+| Node.js | 22.0.0（LTS）                               |
+| Vue     | 3.5.0（peerDependency，需宿主项目自行安装） |
+
+组件库只发布 ES Module 与 CommonJS 两种产物，不提供浏览器 `<script>` 标签可用的 UMD/IIFE 版本，也不支持 `app.use(...)` 整体注册；请通过包管理器安装后使用具名导入。
 
 ## 安装
 
 ```bash
 pnpm add @deep-eye/core
+# 或 npm install @deep-eye/core / yarn add @deep-eye/core
 ```
 
-## 组件
-
-### AI Conversation
-
-完整的 AI 会话渲染方案，支持流式输出、多模态内容、用户交互表单等。
+在应用入口手动引入一次样式（不会被自动注入）：
 
-#### AiConversation
+```ts
+import '@deep-eye/core/style.css'
+```
 
-渲染完整的会话列表，内置自动滚动、流式动画和操作栏。
+## 快速开始：ChatBot
 
 ```vue
-<script setup lang=”ts”>
+<script setup lang="ts">
 import { ref } from 'vue'
-import {
-  AiConversation,
-  type ChatActionbarCopyPayload,
-  type ConversationMessage,
-} from '@deep-eye/core'
-import '@deep-eye/core/style.css'
+import { ChatBot } from '@deep-eye/core'
+import type { ChatBotExpose, ChatSendPayload, ConversationMessage } from '@deep-eye/core'
 
+const chatBotRef = ref<ChatBotExpose>()
 const messages = ref<ConversationMessage[]>([
-  { id: 'user-1', role: 'user', content: '你好' },
-  { id: 'assistant-1', role: 'assistant', content: '你好，有什么可以帮你？' },
+  { role: 'assistant', content: '你好，有什么可以帮助你？' },
 ])
 
-function saveReply(message: ConversationMessage): void {
-  console.log('保存消息', message)
-}
-
-function onCopy(payload: ChatActionbarCopyPayload): void {
-  console.log('复制内容', payload.text)
+async function handleSend(payload: ChatSendPayload) {
+  // payload.message 已写入 v-model:messages，适合业务持久化。
+  // payload.modelInput 是本次请求发给模型的结构化输入。
+  const response = await fetch('/api/responses', {
+    method: 'POST',
+    headers: { 'content-type': 'application/json' },
+    body: JSON.stringify({ input: [payload.modelInput], stream: true }),
+  })
+  await chatBotRef.value?.consume(response)
 }
 </script>
 
 <template>
-  <AiConversation :messages=”messages” auto-scroll=”smart” @copy=”onCopy”>
-    <template #assistant-actionbar=”{ message }”>
-      <button type=”button” @click=”saveReply(message)”>保存</button>
-    </template>
-  </AiConversation>
+  <ChatBot ref="chatBotRef" v-model:messages="messages" @send="handleSend" style="height: 600px" />
 </template>
 ```
 
-已完成的助手回复会显示默认复制操作。`#assistant-actionbar`、`ChatMessage` 的 `#actionbar` 与 `ChatActionbar` 默认插槽均为追加插槽，不会替换复制操作；流式输出期间不显示操作栏。
+`ChatBot` 直接消费**企业 Agent Responses API** 返回的原始 HTTP SSE `Response` 对象，不接受 completion chunk、`[DONE]`、session/resume 或其他自定义流格式。`consume()` 在 `response.output_text.delta`、reasoning 与 function call 参数到达时立即更新最后一条 assistant 消息；`response.completed.response` / `response.incomplete.response` 作为终态权威结果做一次性校准。
 
-**流式渲染**
+```ts
+await chatBotRef.value?.consume(response, {
+  signal: controller.signal,
+  onEvent(event, frame) {
+    console.log(event.type, event.sequence_number, frame.raw)
+  },
+})
+```
 
-将后端的 OpenAI 兼容 `chat.completion.chunk` SSE 响应交给 `useConversationStream().consume(response)`，即可得到可传入 `AiConversation` 的消息列表。渲染会隐藏 `LLM Running`、`🛠️` 和 `<summary>` 运行标记，但不改写原始消息。
+`response.failed`、`error`、未知事件类型、非法序号和异常 EOF 会使 `consume()` 抛出异常，同时保留已收到的部分 assistant 内容；`response.incomplete` 会保留部分内容并正常结束；调用 `abort()` 后流状态变为 `aborted`。
+
+## 标准消息模型
+
+```ts
+import type { ConversationMessage } from '@deep-eye/core'
+
+const messages: ConversationMessage[] = [
+  { role: 'system', content: '回答要简洁。' },
+  { role: 'user', resource_files: [], content: '描述这张图' },
+  {
+    role: 'assistant',
+    reasoning_content: '先识别主体，再概括场景。',
+    content: '图片中是一片山谷。',
+    tool_calls: [
+      {
+        id: 'call_1',
+        type: 'function',
+        function: { name: 'search', arguments: '{"query":"山谷"}' },
+      },
+    ],
+  },
+  { role: 'tool', tool_call_id: 'call_1', content: '{"count":3}' },
+]
+```
 
-**用户交互表单**
+`user.content` 保存原文，附件通过 `resource_files` 携带；`ChatSendPayload.modelInput` 是发送时临时映射出的模型输入（text / image / video / audio / file parts），不会写入 `messages`。assistant 支持 `content`、`reasoning_content`、`encrypted_content` 与 `tool_calls`；tool 消息通过 `tool_call_id` 关联对应的工具调用。
 
-AskUserForm 使用 `ASK_USER_FORM_SYSTEM_PROMPT`；单选自动提交，多选点击”确认”，`required=false` 可跳过。
+## 主要组件
 
-#### ChatSender
+| 组件          | 用途                                                                                  |
+| ------------- | ------------------------------------------------------------------------------------- |
+| `ChatBot`     | 完整聊天界面：消息列表、输入框、附件、工具调用、可选工件侧栏，内置 Responses SSE 消费 |
+| `ChatMessage` | 单条标准消息的渲染：富文本、多模态、思考区、工具调用，可脱离 `ChatBot` 独立使用       |
+| `ChatSender`  | 独立输入框：草稿、附件上传、截图、语音、快捷功能                                      |
+| `D3MindMap`   | 交互式思维导图：缩放、拖拽、展开折叠、多套内置主题                                    |
 
-支持文本输入、文件上传、语音录音和截图的聊天输入框。
+```vue
+<script setup lang="ts">
+import { ChatMessage } from '@deep-eye/core'
+
+const message = {
+  role: 'assistant' as const,
+  reasoning_content: '正在整理要点。',
+  content: '答案支持 **Markdown**、公式和富媒体。',
+}
+</script>
+
+<template>
+  <ChatMessage :message="message" />
+</template>
+```
 
 ```vue
-<script setup lang=”ts”>
+<script setup lang="ts">
 import { ref } from 'vue'
 import { ChatSender } from '@deep-eye/core'
 
-const message = ref('')
+const draft = ref('')
+</script>
+
+<template>
+  <ChatSender v-model:draft="draft" show-attachment @send="(payload) => console.log(payload)" />
+</template>
+```
+
+```vue
+<script setup lang="ts">
+import { D3MindMap } from '@deep-eye/core'
 
-function handleSend(content: string, files?: File[]) {
-  console.log('发送消息', content, files)
-  message.value = ''
+const data = {
+  nodeData: {
+    id: 'root',
+    topic: '组件库',
+    root: true,
+    children: [{ id: 'chat', topic: 'ChatBot' }],
+  },
 }
 </script>
 
 <template>
-  <ChatSender
-    v-model=”message”
-    :show-screenshot=”true”
-    placeholder=”输入消息...”
-    @send=”handleSend”
-  />
+  <D3MindMap :data="data" height="600px" show-toolbar />
 </template>
 ```
 
-**文件附件功能**
+assistant `content` 原生支持 GFM、代码高亮、KaTeX 公式、图片/视频/音频，以及组件库定义的 mdoc 标签（工件卡片、Ask Form 表单）。将 `ARTIFACT_BLOCK_SYSTEM_PROMPT` 或 `ASK_USER_FORM_SYSTEM_PROMPT` 加入模型的 system prompt，即可引导模型输出对应语法；`ChatBot` 会自动把 Ask Form 固定在底部 dock，并在点击工件卡片时打开侧边栏预览。
 
-- 支持多文件上传，文件累加而不是替换
-- 图片文件显示为 120x120 缩略图卡片
-- 非图片文件显示文件名、扩展名标签和大小
-- 鼠标悬浮显示删除按钮
+## 进阶能力
 
-**截图功能**
+除以上四个主要组件外，`@deep-eye/core` 还导出一组可组合使用的 API，用于更细粒度的定制：
 
-设置 `show-screenshot` 启用截图选项。使用浏览器原生 `getDisplayMedia` API，支持截取屏幕、窗口或标签页，截图后自动添加到附件列表。
+- **`ChatProvider`**：统一配置上传方式、附件限制、主题、颜色模式与实例级 renderer，作用于内部所有 `ChatBot` 实例。
+- **`ConversationList`**、**`ChatQueue`**：多会话列表与流式消息队列（编辑、删除、排序、终态自动出队）。
+- **`registerToolRenderer`** / **`registerChatPreviewRenderer`**：注册自定义工具调用渲染器与附件预览渲染器。
+- **`useConversation`**：`messages` 数组的本地状态管理（`appendMessage`、`setMessages`、`reset`），不处理网络或 SSE。
+- **`useMindMapTheme`** / **`useMindMapLayout`**：`D3MindMap` 主题与布局的组合式函数。
+- 附件相关工具函数、`classifyChatError` 错误分类等。
 
-**语音录音**
+这些 API 的完整签名与用法示例见仓库 `packages/docs` 文档站点的「进阶用法」章节。
 
-内置语音录音功能，支持点击录音和长按录音两种模式，使用 Web Speech API 自动转换为文本。
+## 主题定制
 
-#### 组件导出
+组件的 Design Token 默认值已内联在各自根元素的 scoped 样式中，引入 `style.css` 后即可获得正确外观，**不存在**可单独引入的 `tokens.css` 文件。自定义主题时，直接在宿主容器上覆盖同名 CSS 自定义属性：
 
-| 组件             | 用途                                                      |
-| ---------------- | --------------------------------------------------------- |
-| `AiConversation` | 会话列表、自动滚动、AskUserForm 与 `#assistant-actionbar` |
-| `ChatMessage`    | 单条 `ConversationMessage`，支持 `#actionbar` 与 `@copy`  |
-| `ChatActionbar`  | 默认复制操作，支持默认插槽追加操作与 `@copy`              |
-| `ChatSender`     | 聊天输入框，支持文本、文件、语音和截图                    |
+```css
+.my-app {
+  --accent: #7c3aed; /* 主色：链接、发送按钮、选中态 */
+  --accent-hover: #6d28d9;
+  --accent-subtle: #f5f3ff; /* 用户消息气泡背景 */
+  --bg-canvas: #fafafa; /* 页面/容器底色 */
+  --radius-md: 10px; /* 气泡、附件圆角 */
+}
+```
 
-### D3MindMap
+`ChatBot` 支持三种深色模式触发方式：
 
-基于 D3.js 的思维导图可视化组件。
+```html
+<!-- 显式指定 -->
+<ChatBot data-chat-color-mode="dark" ... />
 
-```vue
-<script setup lang=”ts”>
-import { D3MindMap } from '@deep-eye/core'
-import type { MindMapNode } from '@deep-eye/core'
-
-const data: MindMapNode = {
-  name: '根节点',
-  children: [
-    { name: '子节点 1' },
-    { name: '子节点 2' },
-  ],
-}
-</script>
+<!-- 适配宿主已有的全局主题系统 -->
+<div data-theme="dark"><ChatBot ... /></div>
 
-<template>
-  <D3MindMap :data=”data” height=”600px” show-toolbar />
-</template>
+<!-- 跟随操作系统 -->
+<ChatBot data-chat-color-mode="auto" ... />
 ```
 
-## Changelog
-
-每个功能版本的用户可见变化记录在 [CHANGELOG.md](./CHANGELOG.md)。发布前在文件顶部新增版本，并使用 `Added`、`Changed`、`Fixed` 或 `Removed` 分类。
+完整 Token 清单与深色模式覆盖示例见文档站点的「主题与深色模式」章节。
 
-## 技术要求
+## 完整文档
 
-- Node >= 22
-- Vue >= 3.5
+本 README 仅覆盖最小可用示例。完整的 Props / Events / Slots / Methods 参考、核心概念（消息模型与 Responses SSE 协议详解）、进阶用法与常见问题（FAQ），请查看仓库 `packages/docs` 目录下的 VitePress 文档站点源码。
 
 ## License
 

package/dist/components/chat/ChatBot.vue.d.ts

@@ -1,41 +1,72 @@
-import type { ChatSenderProps, AiConversationProps, ConversationMessage, ConversationUiAction } from './types';
-import type { Ref } from 'vue';
-interface Props {
-    messages: readonly ConversationMessage[] | Ref<readonly ConversationMessage[]>;
-    showSidebar?: boolean;
-    sidebarWidth?: string | number;
-    senderConfig?: Partial<ChatSenderProps>;
-    conversationConfig?: Partial<AiConversationProps>;
-}
+import { type ClassifiedChatError } from './chatErrors';
+import type { ChatActionbarCopyPayload, ChatBotExpose, ChatBotProps, ChatMessageProps, ChatComposerAttachment, ChatQueueItem, ChatResourceFile, ChatSendPayload, ChatToolActionPayload, ConversationMessage, ConversationStreamStatus, ConversationToolCall, ConversationUiAction, ResponseStreamEvent, ResponseSseFrame } from './types';
 type __VLS_Slots = {
     sidebar?: (props: {
         artifact: ConversationUiAction | null;
+        file: ChatResourceFile | null;
     }) => unknown;
+    sender?: () => unknown;
     'sender-prepend'?: () => unknown;
     'sender-append'?: () => unknown;
     empty?: () => unknown;
+    prepend?: () => unknown;
+    append?: () => unknown;
+    message?: (props: {
+        message: ConversationMessage;
+        index: number;
+        isLast: boolean;
+        messageProps: ChatMessageProps;
+    }) => unknown;
     'user-avatar'?: () => unknown;
     'assistant-avatar'?: () => unknown;
     'assistant-actionbar'?: (props: {
         message: unknown;
         copied: boolean;
     }) => unknown;
+    tool?: (props: {
+        toolCall: ConversationToolCall;
+        toolMessage?: import('./types').ToolMessage;
+        streaming: boolean;
+    }) => unknown;
+    'file-preview'?: (props: {
+        resource: ChatResourceFile;
+    }) => unknown;
 };
-declare const __VLS_base: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-    copy: (payload: unknown) => any;
+declare const __VLS_base: import("vue").DefineComponent<ChatBotProps, ChatBotExpose, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    stop: () => any;
+    copy: (payload: ChatActionbarCopyPayload) => any;
     action: (payload: ConversationUiAction) => any;
-    send: (content: string, files?: File[] | undefined) => any;
+    "tool-action": (payload: ChatToolActionPayload) => any;
+    send: (payload: ChatSendPayload) => any;
+    "update:draft": (draft: string) => any;
+    "update:attachments": (attachments: readonly ChatComposerAttachment[]) => any;
+    retry: (payload: ChatSendPayload | null, error: Error) => any;
+    "update:messages": (messages: ConversationMessage[]) => any;
+    "update:queue": (queue: readonly ChatQueueItem[]) => any;
     "artifact-open": (payload: ConversationUiAction) => any;
-}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{
-    onCopy?: ((payload: unknown) => any) | undefined;
+    "status-change": (status: ConversationStreamStatus) => any;
+    "response-event": (event: ResponseStreamEvent, frame: ResponseSseFrame) => any;
+    "response-error": (error: Error, info: ClassifiedChatError) => any;
+}, string, import("vue").PublicProps, Readonly<ChatBotProps> & Readonly<{
+    onStop?: (() => any) | undefined;
+    onCopy?: ((payload: ChatActionbarCopyPayload) => any) | undefined;
     onAction?: ((payload: ConversationUiAction) => any) | undefined;
-    onSend?: ((content: string, files?: File[] | undefined) => any) | undefined;
+    "onTool-action"?: ((payload: ChatToolActionPayload) => any) | undefined;
+    onSend?: ((payload: ChatSendPayload) => any) | undefined;
+    "onUpdate:draft"?: ((draft: string) => any) | undefined;
+    "onUpdate:attachments"?: ((attachments: readonly ChatComposerAttachment[]) => any) | undefined;
+    onRetry?: ((payload: ChatSendPayload | null, error: Error) => any) | undefined;
+    "onUpdate:messages"?: ((messages: ConversationMessage[]) => any) | undefined;
+    "onUpdate:queue"?: ((queue: readonly ChatQueueItem[]) => any) | undefined;
     "onArtifact-open"?: ((payload: ConversationUiAction) => any) | undefined;
+    "onStatus-change"?: ((status: ConversationStreamStatus) => any) | undefined;
+    "onResponse-event"?: ((event: ResponseStreamEvent, frame: ResponseSseFrame) => any) | undefined;
+    "onResponse-error"?: ((error: Error, info: ClassifiedChatError) => any) | undefined;
 }>, {
     showSidebar: boolean;
     sidebarWidth: string | number;
-    senderConfig: Partial<ChatSenderProps>;
-    conversationConfig: Partial<AiConversationProps>;
+    senderConfig: Partial<import("./types").ChatSenderProps>;
+    conversationConfig: import("./types").ConversationListConfig;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;

package/dist/components/chat/ChatBot.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChatBot.vue.d.ts","sourceRoot":"","sources":["../../../src/components/chat/ChatBot.vue"],"names":[],"mappings":"AAwZA,OAAO,KAAK,EACV,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,SAAS,CAAA;AAChB,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,KAAK,CAAA;AAI9B,UAAU,KAAK;IACb,QAAQ,EAAE,SAAS,mBAAmB,EAAE,GAAG,GAAG,CAAC,SAAS,mBAAmB,EAAE,CAAC,CAAA;IAC9E,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAC9B,YAAY,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAA;IACvC,kBAAkB,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAA;CAClD;AAUD,KAAK,WAAW,GAAG;IACjB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,QAAQ,EAAE,oBAAoB,GAAG,IAAI,CAAA;KAAE,KAAK,OAAO,CAAA;IACvE,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAA;IAChC,eAAe,CAAC,EAAE,MAAM,OAAO,CAAA;IAC/B,KAAK,CAAC,EAAE,MAAM,OAAO,CAAA;IACrB,aAAa,CAAC,EAAE,MAAM,OAAO,CAAA;IAC7B,kBAAkB,CAAC,EAAE,MAAM,OAAO,CAAA;IAClC,qBAAqB,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAA;CAClF,CAAC;AA8TF,QAAA,MAAM,UAAU;;;;;;;;;;;iBApVA,OAAO;kBACN,MAAM,GAAG,MAAM;kBACf,OAAO,CAAC,eAAe,CAAC;wBAClB,OAAO,CAAC,mBAAmB,CAAC;6EAqVjD,CAAC;AACH,QAAA,MAAM,YAAY,EAAS,eAAe,CAAC,OAAO,UAAU,EAAE,WAAW,CAAC,CAAC;wBACtD,OAAO,YAAY;AAAxC,wBAAyC;AAWzC,KAAK,eAAe,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IAChC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KACV,CAAA;CACD,CAAC"}
+{"version":3,"file":"ChatBot.vue.d.ts","sourceRoot":"","sources":["../../../src/components/chat/ChatBot.vue"],"names":[],"mappings":"AAs0BA,OAAO,EAAqB,KAAK,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAC1E,OAAO,KAAK,EACV,wBAAwB,EAExB,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,sBAAsB,EACtB,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,qBAAqB,EAErB,mBAAmB,EACnB,wBAAwB,EACxB,oBAAoB,EACpB,oBAAoB,EAEpB,mBAAmB,EACnB,gBAAgB,EACjB,MAAM,SAAS,CAAA;AAYhB,KAAK,WAAW,GAAG;IACjB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE;QAChB,QAAQ,EAAE,oBAAoB,GAAG,IAAI,CAAA;QACrC,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAAA;KAC9B,KAAK,OAAO,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,OAAO,CAAA;IACtB,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAA;IAChC,eAAe,CAAC,EAAE,MAAM,OAAO,CAAA;IAC/B,KAAK,CAAC,EAAE,MAAM,OAAO,CAAA;IACrB,OAAO,CAAC,EAAE,MAAM,OAAO,CAAA;IACvB,MAAM,CAAC,EAAE,MAAM,OAAO,CAAA;IACtB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE;QAChB,OAAO,EAAE,mBAAmB,CAAA;QAC5B,KAAK,EAAE,MAAM,CAAA;QACb,MAAM,EAAE,OAAO,CAAA;QACf,YAAY,EAAE,gBAAgB,CAAA;KAC/B,KAAK,OAAO,CAAA;IACb,aAAa,CAAC,EAAE,MAAM,OAAO,CAAA;IAC7B,kBAAkB,CAAC,EAAE,MAAM,OAAO,CAAA;IAClC,qBAAqB,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAA;IACjF,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE;QACb,QAAQ,EAAE,oBAAoB,CAAA;QAC9B,WAAW,CAAC,EAAE,OAAO,SAAS,EAAE,WAAW,CAAA;QAC3C,SAAS,EAAE,OAAO,CAAA;KACnB,KAAK,OAAO,CAAA;IACb,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,QAAQ,EAAE,gBAAgB,CAAA;KAAE,KAAK,OAAO,CAAA;CACpE,CAAC;AA8vBF,QAAA,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6EAKd,CAAC;AACH,QAAA,MAAM,YAAY,EAAS,eAAe,CAAC,OAAO,UAAU,EAAE,WAAW,CAAC,CAAC;wBACtD,OAAO,YAAY;AAAxC,wBAAyC;AAWzC,KAAK,eAAe,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IAChC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KACV,CAAA;CACD,CAAC"}

package/dist/components/chat/attachmentController.d.ts

@@ -0,0 +1,25 @@
+import type { ChatAttachmentError, ChatAttachmentLimits, ChatComposerAttachment, ChatUploadConfig, QiniuUploadFileItem } from './types';
+interface AttachmentUploadOptions {
+    config: ChatUploadConfig;
+    signal?: AbortSignal;
+    onProgress?: (progress: number) => void;
+}
+type AttachmentUpload = (file: File, options: AttachmentUploadOptions) => Promise<QiniuUploadFileItem>;
+export interface ChatAttachmentControllerOptions {
+    getAttachments: () => readonly ChatComposerAttachment[];
+    setAttachments: (attachments: readonly ChatComposerAttachment[]) => void;
+    getUploadConfig: () => ChatUploadConfig | undefined;
+    getLimits?: () => ChatAttachmentLimits;
+    onError?: (error: ChatAttachmentError, file?: File) => void;
+    upload?: AttachmentUpload;
+}
+export interface ChatAttachmentController {
+    addFiles: (files: readonly File[]) => Promise<void>;
+    retry: (id: string) => Promise<void>;
+    remove: (id: string) => void;
+    clear: () => void;
+    dispose: () => void;
+}
+export declare function createChatAttachmentController(options: ChatAttachmentControllerOptions): ChatAttachmentController;
+export {};
+//# sourceMappingURL=attachmentController.d.ts.map

package/dist/components/chat/attachmentController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachmentController.d.ts","sourceRoot":"","sources":["../../../src/components/chat/attachmentController.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,EACtB,gBAAgB,EAChB,mBAAmB,EACpB,MAAM,SAAS,CAAA;AAEhB,UAAU,uBAAuB;IAC/B,MAAM,EAAE,gBAAgB,CAAA;IACxB,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAA;CACxC;AAED,KAAK,gBAAgB,GAAG,CACtB,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,uBAAuB,KAC7B,OAAO,CAAC,mBAAmB,CAAC,CAAA;AAEjC,MAAM,WAAW,+BAA+B;IAC9C,cAAc,EAAE,MAAM,SAAS,sBAAsB,EAAE,CAAA;IACvD,cAAc,EAAE,CAAC,WAAW,EAAE,SAAS,sBAAsB,EAAE,KAAK,IAAI,CAAA;IACxE,eAAe,EAAE,MAAM,gBAAgB,GAAG,SAAS,CAAA;IACnD,SAAS,CAAC,EAAE,MAAM,oBAAoB,CAAA;IACtC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,mBAAmB,EAAE,IAAI,CAAC,EAAE,IAAI,KAAK,IAAI,CAAA;IAC3D,MAAM,CAAC,EAAE,gBAAgB,CAAA;CAC1B;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACnD,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACpC,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;IAC5B,KAAK,EAAE,MAAM,IAAI,CAAA;IACjB,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB;AAID,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,+BAA+B,GACvC,wBAAwB,CAkJ1B"}

package/dist/components/chat/attachments.d.ts

@@ -0,0 +1,12 @@
+import type { ChatAttachmentError, ChatAttachmentLimits, ChatComposerAttachment, ChatFileCategory, ChatResourceFile, ChatSendPayload, ConversationContentPart, QiniuUploadFileItem } from './types';
+export declare const DEFAULT_CHAT_ATTACHMENT_LIMITS: ChatAttachmentLimits;
+export declare function getFileExtension(fileName: string): string;
+export declare function classifyAttachment(file: Pick<File, 'name' | 'type'>): ChatFileCategory;
+export declare function createAttachmentFingerprint(file: Pick<File, 'name' | 'size' | 'lastModified'>): string;
+export declare function validateAttachmentFile(file: File, limits?: ChatAttachmentLimits): ChatAttachmentError | null;
+export declare function parseQiniuUploadResult(value: unknown): QiniuUploadFileItem;
+export declare function toChatResourceFile(result: QiniuUploadFileItem): ChatResourceFile;
+export declare function buildChatSendPayload(content: string, attachments: readonly ChatComposerAttachment[]): ChatSendPayload;
+export declare function resourceToContentPart(resource: ChatResourceFile): ConversationContentPart;
+export declare function createChatMessageId(): string;
+//# sourceMappingURL=attachments.d.ts.map

package/dist/components/chat/attachments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachments.d.ts","sourceRoot":"","sources":["../../../src/components/chat/attachments.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,EACtB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,uBAAuB,EACvB,mBAAmB,EAEpB,MAAM,SAAS,CAAA;AA8BhB,eAAO,MAAM,8BAA8B,EAAE,oBAM5C,CAAA;AAID,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGzD;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG,gBAAgB,CAOtF;AAED,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,cAAc,CAAC,GACjD,MAAM,CAER;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,IAAI,EACV,MAAM,GAAE,oBAAqD,GAC5D,mBAAmB,GAAG,IAAI,CAuB5B;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,mBAAmB,CAe1E;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,mBAAmB,GAAG,gBAAgB,CAOhF;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,SAAS,sBAAsB,EAAE,GAC7C,eAAe,CAoBjB;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,uBAAuB,CAYzF;AAED,wBAAgB,mBAAmB,IAAI,MAAM,CAM5C"}

package/dist/components/chat/chatContext.d.ts

@@ -0,0 +1,14 @@
+import { type ComputedRef } from 'vue';
+import type { ChatAttachmentLimits, ChatColorMode, ChatPreviewRendererMap, ChatTheme, ChatToolRendererMap, ChatUploadConfig } from './types';
+export interface ChatContext {
+    colorMode: ComputedRef<ChatColorMode>;
+    uploadConfig: ComputedRef<ChatUploadConfig | undefined>;
+    limits: ComputedRef<ChatAttachmentLimits>;
+    theme: ComputedRef<ChatTheme>;
+    previewRenderers: ComputedRef<ChatPreviewRendererMap>;
+    toolRenderers: ComputedRef<ChatToolRendererMap>;
+}
+export declare function provideChatContext(context: ChatContext): void;
+export declare function useChatContext(): ChatContext;
+export declare function resolveChatAttachmentLimits(...overrides: Array<Partial<ChatAttachmentLimits> | undefined>): ChatAttachmentLimits;
+//# sourceMappingURL=chatContext.d.ts.map

package/dist/components/chat/chatContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chatContext.d.ts","sourceRoot":"","sources":["../../../src/components/chat/chatContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,WAAW,EAAqB,MAAM,KAAK,CAAA;AAEpF,OAAO,KAAK,EACV,oBAAoB,EACpB,aAAa,EACb,sBAAsB,EACtB,SAAS,EACT,mBAAmB,EACnB,gBAAgB,EACjB,MAAM,SAAS,CAAA;AAEhB,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,WAAW,CAAC,aAAa,CAAC,CAAA;IACrC,YAAY,EAAE,WAAW,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAAA;IACvD,MAAM,EAAE,WAAW,CAAC,oBAAoB,CAAC,CAAA;IACzC,KAAK,EAAE,WAAW,CAAC,SAAS,CAAC,CAAA;IAC7B,gBAAgB,EAAE,WAAW,CAAC,sBAAsB,CAAC,CAAA;IACrD,aAAa,EAAE,WAAW,CAAC,mBAAmB,CAAC,CAAA;CAChD;AAaD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAE7D;AAED,wBAAgB,cAAc,IAAI,WAAW,CAE5C;AAED,wBAAgB,2BAA2B,CACzC,GAAG,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,oBAAoB,CAAC,GAAG,SAAS,CAAC,GAC7D,oBAAoB,CAYtB"}

package/dist/components/chat/chatErrors.d.ts

@@ -0,0 +1,16 @@
+export type ChatErrorKind = 'network' | 'timeout' | 'api' | 'protocol' | 'unknown';
+export interface ClassifiedChatError {
+    kind: ChatErrorKind;
+    error: Error;
+    code?: string;
+    status?: number;
+}
+/**
+ * Buckets a raw stream/request failure into a small set of kinds a host app or the
+ * in-conversation fallback can give distinct copy to. `TypeError` is what `fetch()` throws
+ * for connection-level failures (offline, DNS, refused, CORS); `TimeoutError` is the name
+ * `AbortSignal.timeout()` produces, so a host passing a timeout-bound signal is detected
+ * without this package owning any timeout logic itself.
+ */
+export declare function classifyChatError(error: Error): ClassifiedChatError;
+//# sourceMappingURL=chatErrors.d.ts.map

package/dist/components/chat/chatErrors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chatErrors.d.ts","sourceRoot":"","sources":["../../../src/components/chat/chatErrors.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,SAAS,GAAG,KAAK,GAAG,UAAU,GAAG,SAAS,CAAA;AAElF,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,aAAa,CAAA;IACnB,KAAK,EAAE,KAAK,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,KAAK,GAAG,mBAAmB,CAkBnE"}

package/dist/components/chat/chatQueue.d.ts

@@ -0,0 +1,6 @@
+import type { ChatQueueItem, ChatSendPayload } from './types';
+export declare function enqueueChatPayload(queue: readonly ChatQueueItem[], payload: ChatSendPayload): ChatQueueItem[];
+export declare function editChatQueueItem(queue: readonly ChatQueueItem[], id: string, content: string): ChatQueueItem[];
+export declare function removeChatQueueItem(queue: readonly ChatQueueItem[], id: string): ChatQueueItem[];
+export declare function moveChatQueueItem(queue: readonly ChatQueueItem[], fromIndex: number, toIndex: number): ChatQueueItem[];
+//# sourceMappingURL=chatQueue.d.ts.map

package/dist/components/chat/chatQueue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chatQueue.d.ts","sourceRoot":"","sources":["../../../src/components/chat/chatQueue.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAI7D,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,SAAS,aAAa,EAAE,EAC/B,OAAO,EAAE,eAAe,GACvB,aAAa,EAAE,CAEjB;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,SAAS,aAAa,EAAE,EAC/B,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,MAAM,GACd,aAAa,EAAE,CAMjB;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,EAAE,EAAE,EAAE,MAAM,GAAG,aAAa,EAAE,CAEhG;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,SAAS,aAAa,EAAE,EAC/B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,aAAa,EAAE,CAcjB"}

package/dist/components/chat/components/ArtifactPreview.vue.d.ts

@@ -0,0 +1,15 @@
+import type { ConversationUiAction } from '../types';
+type __VLS_Props = {
+    artifact: ConversationUiAction;
+    expanded?: boolean;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    close: () => any;
+    "toggle-expanded": () => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onClose?: (() => any) | undefined;
+    "onToggle-expanded"?: (() => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;
+//# sourceMappingURL=ArtifactPreview.vue.d.ts.map

package/dist/components/chat/components/ArtifactPreview.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArtifactPreview.vue.d.ts","sourceRoot":"","sources":["../../../../src/components/chat/components/ArtifactPreview.vue"],"names":[],"mappings":"AAmWA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAA;AAKpD,KAAK,WAAW,GAAG;IACjB,QAAQ,EAAE,oBAAoB,CAAA;IAC9B,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAC;AA+jBF,QAAA,MAAM,YAAY;;;;;;kFAGhB,CAAC;wBACkB,OAAO,YAAY;AAAxC,wBAAyC"}