netstar-ai-chat 1.1.3 → 1.2.0

package/README.md

@@ -1,6 +1,6 @@
 # @netstar/ai-chat
 
-Vue 3 AI 对话面板组件 — 可复用的智能对话 UI 组件，支持多 Agent 切换、工具调用可视化、人工审批流程。
+Vue 3 AI 对话面板组件 — 可复用的智能对话 UI，支持多 Agent 切换、思考过程可视、工具调用渲染、子智能体调用、人工审批流程。
 
 ## 安装
 
@@ -20,21 +20,20 @@ npm install vue ant-design-vue ant-design-x-vue @ant-design/icons-vue
     v-model="inputText"
     v-model:agent-key="currentAgent"
     @submit="handleSubmit"
-    @cancel="handleCancel"
-    @reset="handleReset"
   />
 </template>
 
 <script setup lang="ts">
-  import { ChatPanel, type AgentOption } from '@netstar/ai-chat';
+  import { ChatPanel, Langchain_py_AIMessage_V3, type AgentOption } from '@netstar/ai-chat';
   import '@netstar/ai-chat/style.css';
 
+  const agent = new Langchain_py_AIMessage_V3({
+    endpoint: 'http://localhost:8000/langgraph/stream',
+    historyEndpoint: 'http://localhost:8000/history',
+  });
+
   const agents: AgentOption[] = [
-    {
-      key: 'assistant',
-      label: '通用助手',
-      agent: myAgentInstance,
-    },
+    { key: 'assistant', label: '通用助手', agent },
   ];
 
   const roles = {
@@ -48,41 +47,49 @@ npm install vue ant-design-vue ant-design-x-vue @ant-design/icons-vue
 
 ### AgentRuntime 接口
 
-ChatPanel 通过 `AgentRuntime` 接口与具体 AI 后端解耦。任何实现了该接口的对象均可作为 Agent 传入：
-
-```typescript
-import type { AgentRuntime } from '@netstar/ai-chat';
-
-class MyAgent implements AgentRuntime {
-  async ask(query: string) {
-    /* SSE 流式请求 */
-  }
-  stop() {
-    /* 中止请求 */
-  }
-  reset() {
-    /* 清空历史 */
-  }
-  on(event, handler) {
-    /* 注册事件 */
-  }
-  off(event, handler) {
-    /* 移除事件 */
-  }
-  // ...
-}
+ChatPanel 通过 `AgentRuntime` 接口与 AI 后端解耦，支持多种后端实现：
+
+| 实现 | 说明 |
+|---|---|
+| `Langchain_py_AIMessage_V3` | **推荐** — LangGraph Python V3 SSE 流式接口，支持思考过程、子智能体 |
+| `Langchain_py_AIMessage` | LangGraph Python V1/V2 SSE 流式接口 |
+| `AI_SDK_AIMessage` | Vercel AI SDK 前端 Agent |
+| `AI_SDK_Save_AIMessage` | Vercel AI SDK + 服务端历史持久化 |
+| `Dify_SDK_AIMessage` | Dify 平台 API |
+
+### 消息渲染（V3 blocks）
+
+V3 Agent 通过 `MessageBlock[]` 描述消息的完整生命周期，ChatPanel 自动按阶段渲染：
+
 ```
+💡 思考：需要调用子智能体计算...
+     ┌─ general-purpose ─ 子代理 ──┐
+     │ 💡 思考：解析表达式...         │
+     │ ┌─ calculator ──────────────┐│
+     │ │ input: 10+10  output: 20  ││
+     │ └───────────────────────────┘│
+     │ 结果为 20                      │
+     └───────────────────────────────┘
+     子智能体返回结果 20
+10 + 10 = **20**
+```
+
+- **ReasoningBlock** — 思考/推理内容，折叠在思考容器内
+- **TextBlock** — 回复文本
+- **ToolCallBlock** — 工具调用节点，渲染为 `ToolCallNode`
+- **subAgentBlocks** — 子智能体的完整消息流，渲染为 `SubAgentNode`
 
 ### 工具调用可视化
 
-当 Agent 在流式响应中触发工具调用时，ChatPanel 会自动渲染 `ToolCallNode` 组件展示工具的执行状态。可通过 `toolRenderers` 自定义特定工具的渲染组件。
+通过 `toolRenderers` 为特定工具名提供自定义渲染组件，未匹配的工具回退到 `ToolCallNode`。
 
-### 人工审批 (Human-in-the-Loop)
+### 子智能体
 
-实现了 `ExtendedAgentRuntime` 的 Agent 支持中断/审批流程：
+当 V3 Agent 调用 `task` 工具时，ChatPanel 渲染 `SubAgentNode` 组件展示子智能体的完整推理过程，包括其思考内容、工具调用和输出。
 
-- 工具调用需要审批时，ChatPanel 自动显示审批 UI
-- 支持批准、拒绝、修改后批准三种决策
+### 人工审批 (Human-in-the-Loop)
+
+实现了 `ExtendedAgentRuntime` 的 Agent 支持中断/审批流程，支持批准、拒绝、修改后批准三种决策。
 
 ## Props
 
@@ -101,11 +108,34 @@ class MyAgent implements AgentRuntime {
 
 ## 导出
 
-- **ChatPanel** — 主对话面板组件
-- **AgentPicker** — Agent 选择器组件
-- **ToolCallNode** — 工具调用节点组件
-- **StreamMarkdown** — 流式 Markdown 渲染组件
-- **类型** — 完整的 TypeScript 类型定义
+### 组件
+
+- **ChatPanel** — 主对话面板
+- **AgentChat** — 多 Agent 对话容器
+- **AgentPicker** — Agent 选择器
+- **ToolCallNode** — 工具调用时间线节点
+- **SubAgentNode** — 子智能体渲染节点
+- **StreamMarkdown** — 流式 Markdown 渲染
+- **ThinkNode** — 思考内容渲染节点
+- **WriteTodosTopPanel** — 待办面板
+- **SaveModuleDocsRenderer** — 文档保存渲染器
+
+### Agent 运行时
+
+- **Langchain_py_AIMessage_V3** — LangGraph V3 SSE（推荐）
+- **Langchain_py_AIMessage** — LangGraph V1/V2 SSE
+- **AI_SDK_AIMessage** — Vercel AI SDK
+- **AI_SDK_Save_AIMessage** — Vercel AI SDK + 历史持久化
+- **Dify_SDK_AIMessage** — Dify 平台
+
+### 工具函数
+
+- `convertHistoryRecord` / `convertConversationDetail` — 历史记录转换
+- `extractTextContent` / `parseOpenAIAssistantToolCalls` — 消息解析
+
+### 类型
+
+所有类型通过 `@netstar/ai-chat` 统一导出，包括 `ChatMessage`、`MessageBlock`、`AgentRuntime`、`ExtendedAgentRuntime`、`ToolCallEvent`、`ToolTimelineItem` 等。
 
 ## License
 

package/dist/AgentChat/AIMessage.d.ts

@@ -1,469 +1,4 @@
-export type DecisionType = import('./LangchainMessage').DecisionType;
-export type InterruptEvent = import('./LangchainMessage').InterruptEvent;
-export type ResumeDecision = import('./LangchainMessage').ResumeDecision;
-export type CreateAgentDecision = import('./LangchainMessage').CreateAgentDecision;
-export type AnyResumeDecision = import('./LangchainMessage').AnyResumeDecision;
-/** 消息发送者角色 */
-export type ChatRole = 'ai' | 'user';
-/** 工具调用生命周期状态 */
-export type ToolCallStatus = 'error' | 'running' | 'success' | 'waiting';
-/**
- * Agent 层抛出的原始工具调用事件。
- * - `running`：工具已被调用，入参已知，等待执行结果。
- * - `success`：工具执行成功，output 为返回值。
- * - `error`  ：工具执行失败，error 为错误描述。
- */
-export interface ToolCallEvent {
-    /** 审批配置（status === 'waiting' 时存在，来自中断事件） */
-    approvalConfig?: {
-        /** 允许的决策类型 */
-        allowedDecisions: import('./LangchainMessage').DecisionType[];
-        /** 操作描述 */
-        description: string;
-        /** 中断事件 ID */
-        interruptId: string;
-    };
-    /** 工具执行耗时（毫秒），status 变为终态后才有值 */
-    durationMs?: number;
-    /** 错误信息（status === 'error' 时存在） */
-    error?: string;
-    /** 调用入参（任意结构，由具体工具定义） */
-    input?: unknown;
-    /** 调用输出（status === 'success' 时存在） */
-    output?: unknown;
-    /** 当前状态 */
-    status: ToolCallStatus;
-    /** 所处轮次序号（0-based），多步 Agent 循环时有值 */
-    stepNumber?: number;
-    /** 事件触发时的 Unix 时间戳（毫秒） */
-    timestamp: number;
-    /** 友好展示标题（优先于 toolName 展示，可选） */
-    title?: string;
-    /** 本次工具调用的唯一 ID（由模型分配） */
-    toolCallId: string;
-    /** 工具名称（程序标识符） */
-    toolName: string;
-}
-/** 连续文本段，指向宿主消息 `content` 的字符区间 `[start, end)`.
- * `end === -1` 表示延伸到 `content` 末尾（流式尚未结束时使用）。
- */
-export interface TextSegment {
-    /** 结束字符索引（不包含，-1 表示到消息末尾） */
-    end: number;
-    /** 起始字符索引（包含） */
-    start: number;
-    type: 'text';
-}
-/** 工具调用占位段，关联一次具体的工具调用 */
-export interface ToolSegment {
-    toolCallId: string;
-    type: 'tool';
-}
-/** 单个附件信息 */
-export interface AttachmentItem {
-    /** 附件唯一 ID（上传后由后端返回） */
-    id: string;
-    /** 文件名（含扩展名） */
-    name: string;
-    /** 文件大小（字节） */
-    size: number;
-    /** 文件 MIME 类型 */
-    type: string;
-    /** 可访问的预览/下载 URL（可选） */
-    url?: string;
-}
-/** 附件上传状态 */
-export type AttachmentStatus = 'done' | 'error' | 'uploading';
-/** 附件内容段，描述消息中携带的附件集合 */
-export interface AttachmentSegment {
-    attachments: AttachmentItem[];
-    type: 'attachment';
-}
-/** 消息内容段（文本段 | 工具调用段 | 附件段） */
-export type ContentSegment = AttachmentSegment | TextSegment | ToolSegment;
-/**
- * 工具调用时间线中的单条记录。
- * 由原始 ToolCallEvent 整合而来，包含截断后的预览字符串，
- * 可直接供 ChatPanel 渲染工具调用节点。
- */
-export interface ToolTimelineItem {
-    /**
-     * 审批配置（status === 'waiting' 时存在）。
-     * 当工具调用需要人工审批时，存储审批相关的配置信息。
-     */
-    approvalConfig?: {
-        /** 允许的决策类型 */
-        allowedDecisions: import('./LangchainMessage').DecisionType[];
-        /** 入参对象 */
-        args: Record<string, unknown>;
-        /** 操作描述 */
-        description: string;
-        /** 编辑内容（edit 审批时使用） */
-        editContent: string;
-        /** 中断事件 ID */
-        interruptId: string;
-    };
-    /** 工具执行耗时（毫秒） */
-    durationMs?: number;
-    /** 原始错误（供特定工具自定义渲染使用） */
-    error?: string;
-    /** 原始入参（供特定工具自定义渲染使用） */
-    input?: unknown;
-    /** 入参预览文本（已截断） */
-    inputPreview?: string;
-    /** 原始输出（供特定工具自定义渲染使用） */
-    output?: unknown;
-    /**
-     * 结果预览文本（已截断）。
-     * status === 'error' 时为错误信息，success 时为输出内容。
-     */
-    resultPreview?: string;
-    /** 调用发起时间（ms since epoch） */
-    startedAt: number;
-    status: ToolCallStatus;
-    /** 所处步骤序号（0-based） */
-    stepNumber?: number;
-    /** 友好展示标题 */
-    title?: string;
-    toolCallId: string;
-    toolName: string;
-}
-/**
- * ChatPanel 内部维护的消息结构。
- * - 用户消息仅含 role / key / content。
- * - AI 消息在流式输出时 loading 为 true，content 逐字追加；
- *   如有工具调用，toolTimeline 和 segments 同步更新。
- */
-export interface ChatMessage {
-    /**
-     * 消息正文（纯文本或 Markdown 字符串）。
-     * AI 消息在流式输出时逐字追加；工具调用不计入此字段。
-     */
-    content: string;
-    /** 消息唯一标识（渲染 key） */
-    key: string;
-    /** 消息是否正在加载（流式输出尚未结束） */
-    loading?: boolean;
-    /** 消息角色 */
-    role: ChatRole;
-    /**
-     * 内容段列表，描述文本与工具调用的交叉顺序。
-     * 无工具调用时为空，全部内容退化为单一文本段。
-     */
-    segments?: ContentSegment[];
-    /** 工具调用时间线（AI 消息专用，用于渲染工具调用节点） */
-    toolTimeline?: ToolTimelineItem[];
-}
-/** 已将字符范围解析为实际文本的渲染段 */
-export interface ResolvedTextSegment {
-    /** 已切片的文本内容，可直接传给 StreamMarkdown */
-    text: string;
-    type: 'text';
-}
-/** 已解析的工具调用渲染段 */
-export interface ResolvedToolSegment {
-    toolCallId: string;
-    type: 'tool';
-}
-/** 已解析的附件渲染段 */
-export interface ResolvedAttachmentSegment {
-    attachments: AttachmentItem[];
-    type: 'attachment';
-}
-/** 可直接供模板 v-for 消费的渲染段联合类型 */
-export type ResolvedSegment = ResolvedAttachmentSegment | ResolvedTextSegment | ResolvedToolSegment;
-/**
- * 历史会话摘要条目，用于侧边栏列表展示。
- * 与具体后端（Dify / 自研）无关，由 Agent 层负责适配。
- */
-export interface ConversationSummary {
-    /** 会话创建时间（ms since epoch，可选） */
-    createdAt?: number;
-    /** 会话唯一 ID */
-    id: string;
-    /** 会话标题（可能由用户命名或由模型自动生成） */
-    title: string;
-    /** 会话最后更新时间（ms since epoch，可选） */
-    updatedAt?: number;
-}
-/** 历史会话列表响应 */
-export interface ConversationListResult {
-    /** 是否还有更多分页数据 */
-    hasMore: boolean;
-    /** 本页会话摘要列表 */
-    items: ConversationSummary[];
-    /**
-     * 用于加载下一页的游标（通常为末条记录 ID）。
-     * `hasMore === false` 时可忽略。
-     */
-    nextCursor?: string;
-}
-/**
- * 单条原始消息记录（后端返回的最小结构）。
- * 与具体后端无关，由 Agent 层负责适配。
- */
-export interface HistoryMessageRecord {
-    /** AI 回复文本（Markdown） */
-    answer: string;
-    /** 所属会话 ID */
-    conversationId: string;
-    /** 消息创建时间（ms since epoch，可选） */
-    createdAt?: number;
-    /** 原始消息 ID */
-    id: string;
-    /** 用户问题文本 */
-    query: string;
-}
-/** 单条历史对话详情响应 */
-export interface ConversationDetailResult {
-    /** 会话 ID */
-    conversationId: string;
-    /** 是否还有更多历史消息（分页加载时使用） */
-    hasMore: boolean;
-    /** 用于加载更多的游标（通常为首条记录 ID） */
-    nextCursor?: string;
-    /** 原始消息记录列表（按时间升序） */
-    records: HistoryMessageRecord[];
-    /** 对话标题 */
-    title: string;
-}
-/**
- * 将单条 `HistoryMessageRecord` 转换为 ChatPanel 所需的一对消息（用户 + AI）。
- *
- * 转换规则：
- * - `record.query`  → `ChatMessage { role: 'user', content: query }`
- * - `record.answer` → `ChatMessage { role: 'ai',   content: answer }`
- *
- * @param record  单条原始历史消息
- * @param keyPrefix 生成唯一 key 的前缀（通常传 record.id）
- */
-export type HistoryRecordConverter = (record: HistoryMessageRecord, keyPrefix: string) => [userMsg: ChatMessage, aiMsg: ChatMessage];
-/**
- * 将完整 `ConversationDetailResult` 转换为可直接传入 ChatPanel
- * `initialMessages` prop 的 `ChatMessage[]` 数组（按时间升序）。
- */
-export type ConversationDetailConverter = (detail: ConversationDetailResult) => ChatMessage[];
-/**
- * `replyChange` 事件处理器。
- * @param delta    本次新增的文本片段（流式增量）
- * @param allReply 截至目前累积的完整回复内容
- */
-export type ReplyChangeHandler = (delta: string, allReply: string) => void;
-/** `stop` 事件处理器（Agent 主动停止或被中止时触发） */
-export type StopHandler = () => void;
-/** `toolCall` 事件处理器 */
-export type ToolCallHandler = (event: ToolCallEvent) => void;
-/** `interrupt` 事件处理器（工具调用需要审批时触发） */
-export type InterruptHandler = (event: import('./LangchainMessage').InterruptEvent) => void;
-/** Agent 可透传给上层的事件名 */
-export type AgentEventName = 'interrupt' | 'replyChange' | 'stop' | 'toolCall';
-/** Agent 事件透传载荷 */
-export type AgentEventPayload = {
-    agentKey: string;
-    args: [];
-    event: 'stop';
-} | {
-    agentKey: string;
-    args: [event: import('./LangchainMessage').InterruptEvent];
-    event: 'interrupt';
-} | {
-    agentKey: string;
-    args: [event: ToolCallEvent];
-    event: 'toolCall';
-} | {
-    agentKey: string;
-    args: [reply: string, allReply: string];
-    event: 'replyChange';
-};
-/** Agent 事件透传回调 */
-export type AgentEventCallback = (payload: AgentEventPayload) => void;
-/**
- * Agent 运行时接口。
- *
- * ChatPanel 通过此接口与具体 AI Agent 完全解耦：
- * 任何实现了该接口的对象均可作为 Agent 传入 ChatPanel。
- *
- * 典型实现：`ToolLoopAgentWapper`（见 wrapAgent.ts）
- */
-export interface AgentRuntime {
-    /**
-     * 向 Agent 提交用户问题并等待本轮回复完成。
-     * 流式文本内容通过 `replyChange` 事件推送，
-     * 工具调用事件通过 `toolCall` 事件推送。
-     * Promise resolve 表示本轮通信结束（成功或被中止）。
-     */
-    ask(query: string): Promise<unknown>;
-    /**
-     * 获取指定会话的历史消息详情，并直接返回可渲染的消息列表。
-     *
-     * 实现方负责将后端原始数据（结构因各后端而异）适配为 `ChatMessage[]`，
-     * 每条历史问答通常展开为 `[userMsg, aiMsg]` 两条记录，按时间升序排列。
-     *
-     * @param conversationId 目标会话 ID
-     * @param cursor 分页游标；首次加载时传 `undefined`，
-     *               后续翻页传上一次响应附带的游标值。
-     * @returns 可直接传入 ChatPanel `initialMessages` prop 的消息数组
-     */
-    getConversationDetail(conversationId: string, cursor?: string): Promise<ChatMessage[]>;
-    /**
-     * 获取历史会话列表（分页）。
-     *
-     * @param cursor 分页游标；首次加载时传 `undefined`，
-     *               后续翻页传上一次响应的 `nextCursor`。
-     * @returns 会话摘要列表及分页信息
-     */
-    listConversations(cursor?: string): Promise<ConversationListResult>;
-    /** 移除事件监听器 */
-    off(event: 'replyChange', handler: ReplyChangeHandler): void;
-    off(event: 'stop', handler: StopHandler): void;
-    off(event: 'toolCall', handler: ToolCallHandler): void;
-    /** 注册事件监听器 */
-    on(event: 'replyChange', handler: ReplyChangeHandler): void;
-    on(event: 'stop', handler: StopHandler): void;
-    on(event: 'toolCall', handler: ToolCallHandler): void;
-    /** 清空 Agent 内部的会话历史（不影响 ChatPanel 的消息列表） */
-    reset(): void;
-    /** 中止当前正在进行的请求，并触发 `stop` 事件 */
-    stop(): void;
-    /**
-     * 是否支持历史会话（可选）。
-     * 实现方根据后端配置判断，例如检查 historyEndpoint 是否已设置。
-     * 未实现时默认视为不支持历史功能。
-     */
-    supportsHistory?(): boolean;
-    /**
-     * 上传附件文件（可选）。
-     * 当实现方不支持附件功能时，返回 `undefined` 或抛出错误。
-     * @returns 上传后的附件信息（含后端返回的 ID）
-     */
-    uploadFile?(file: File): Promise<AttachmentItem>;
-}
-/**
- * 携带初始上下文注入能力的扩展 Agent 接口（可选实现）。
- * 用于在正式对话前向 Agent 注入系统级背景信息，
- * 如用户画像、会话元数据等。
- */
-export interface ExtendedAgentRuntime extends AgentRuntime {
-    /** 追加一条初始用户上下文（不计入对话历史展示） */
-    addInitialUserContext(context: string): void;
-    /** 清除全部初始用户上下文 */
-    clearInitialUserContexts(): void;
-    /** 移除中断事件监听器 */
-    offInterrupt(handler: InterruptHandler): void;
-    /** 注册中断事件监听器 */
-    onInterrupt(handler: InterruptHandler): void;
-    /**
-     * 对中断工具调用做出决策后，恢复 SSE 流。
-     * 调用方统一传递 ResumeDecision[]，内部按 resumeMode 转换为对应后端格式。
-     */
-    resume(decisions: import('./LangchainMessage').ResumeDecision[]): Promise<void>;
-    /** 覆盖全部初始用户上下文 */
-    setInitialUserContexts(contexts: string[]): void;
-}
-/**
- * 传入 ChatPanel `agents` prop 的单个配置项。
- * 支持多 Agent 切换时，每个 Agent 对应一条记录。
- */
-export interface AgentOption {
-    /** Agent 运行时实例 */
-    agent: AgentRuntime;
-    /** Sender footer 中的扩展控件（可选），切换 Agent 时自动替换 */
-    footerControls?: FooterControl[];
-    /** 用于唯一标识此 Agent，也作为下拉选项的 value */
-    key: string;
-    /** 下拉选择器中展示的友好名称 */
-    label: string;
-    /**
-     * 工具名称 → 自定义渲染组件（可选）。
-     *
-     * 当指定的工具名出现时，ChatPanel 会使用此处配置的组件替换默认
-     * `ToolCallNode`，实现工具级别的自定义 UI。
-     * 未配置的工具名仍回退到默认 `ToolCallNode`。
-     *
-     * 组件须满足 `ToolRendererProps` props 与 `ToolRendererEmits` emits 约定。
-     */
-    toolRenderers?: ToolRendererMap;
-}
-/** Sender footer 扩展控件 */
-export interface FooterControl {
-    /** Vue 组件定义，ChatPanel 会注入 props: agent, agentOption, disabled, ...props */
-    component: import('vue').Component;
-    /** 唯一标识（v-for key） */
-    key: string;
-    /** 透传给组件的额外 props（会与 agent/agentOption/disabled 合并） */
-    props?: Record<string, unknown>;
-}
-/**
- * 将任意 payload 序列化为截断后的预览字符串。
- * - `string`         → 直接使用
- * - `object / array` → JSON.stringify
- * - 其他             → String()
- * - 超出 `maxLength` 时截断并追加 "…"
- */
-export type PayloadPreviewFormatter = (payload: unknown, maxLength?: number) => string;
-/**
- * 自定义工具渲染组件的 props 约定。
- *
- * 与 `ToolCallNode` 保持完全一致，以便消费方可以直接以相同 prop 接口
- * 替换默认渲染组件，也可以将 `ToolCallNode` 作为基础组件复用。
- */
-export interface ToolRendererProps {
-    /** 当前节点是否已展开详情 */
-    expanded: boolean;
-    /** 审批操作是否正在处理中（应据此禁用按钮） */
-    resolving?: boolean;
-    /** 工具在本轮对话中的步骤序号（0-based，可选） */
-    stepNumber?: number;
-    /** 工具调用时间线条目，包含状态、入参、输出等完整上下文 */
-    tool: ToolTimelineItem;
-}
-/**
- * 自定义工具渲染组件的 emits 约定。
- *
- * 组件内部无需关心决策如何提交，只需 emit 对应事件，
- * ChatPanel 会统一处理并调用 Agent 的 resume 方法。
- */
-export interface ToolRendererEmits {
-    /** 批准工具操作；actionName 为工具名称或空字符串（由 ChatPanel 自动推断） */
-    approve: (actionName: string) => void;
-    /** 提交修改后批准；editedContent 为修改后的内容 */
-    edit: (actionName: string, editedContent: string) => void;
-    /** 拒绝工具操作 */
-    reject: (actionName: string) => void;
-    /** 切换展开/折叠详情面板 */
-    toggle: () => void;
-}
-/**
- * 工具名称 → 自定义渲染组件的映射表。
- *
- * key 为 `ToolTimelineItem.toolName`，value 为 Vue 组件定义。
- * 组件应满足 `ToolRendererProps` & `ToolRendererEmits` 约定。
- *
- * @example
- * ```ts
- * const toolRenderers: ToolRendererMap = {
- *   search_web: SearchWebToolRenderer,
- *   run_code:   CodeExecutionRenderer,
- * };
- * ```
- */
-export type ToolRendererMap = Record<string, import('vue').Component>;
-/**
- * 将 Unix 时间戳（毫秒）格式化为本地时间字符串，
- * 用于工具调用时间线的时间展示。
- */
-export type TimestampFormatter = (timestamp: number) => string;
-/**
- * 将耗时（毫秒）格式化为可读字符串。
- * 例：120 → "120ms"，1500 → "1.5s"，12000 → "12s"
- */
-export type DurationFormatter = (durationMs: number) => string;
-/**
- * 将 `ChatMessage` 的 `segments` 解析为可直接用于模板渲染的段列表。
- * - 若消息没有 `segments`（无工具调用），退化为单一 `ResolvedTextSegment`。
- * - `TextSegment` 的字符范围会被切片为实际文本。
- */
-export type SegmentResolver = (message: ChatMessage) => ResolvedSegment[];
+export type { AgentEventCallback, AgentEventName, AgentEventPayload, AgentOption, AgentRuntime, AnyResumeDecision, AttachmentItem, AttachmentSegment, AttachmentStatus, ChatMessage, ChatRole, ContentSegment, ConversationDetailConverter, ConversationDetailResult, ConversationListResult, ConversationSummary, CreateAgentDecision, DecisionType, DurationFormatter, ExtendedAgentRuntime, FooterControl, HistoryMessageRecord, HistoryRecordConverter, InterruptEvent, InterruptHandler, MessageBlock, PayloadPreviewFormatter, ReplyChangeHandler, ResolvedAttachmentSegment, ResolvedSegment, ResolvedTextSegment, ResolvedToolSegment, ResumeDecision, SegmentResolver, StopHandler, TextSegment, TimestampFormatter, ToolCallEvent, ToolCallHandler, ToolCallStatus, ToolRendererEmits, ToolRendererMap, ToolRendererProps, ToolSegment, ToolTimelineItem, } from '../types/index';
 /**
  * 将单条 `HistoryMessageRecord` 转换为一对 `ChatMessage`（用户 + AI）。
  *
@@ -476,7 +11,7 @@ export type SegmentResolver = (message: ChatMessage) => ResolvedSegment[];
  * const [userMsg, aiMsg] = convertHistoryRecord(record, record.id);
  * ```
  */
-export declare const convertHistoryRecord: HistoryRecordConverter;
+export declare const convertHistoryRecord: import('../types/index').HistoryRecordConverter;
 /**
  * 将完整 `ConversationDetailResult` 转换为 `ChatMessage[]`，
  * 可直接传入 ChatPanel 的 `initialMessages` prop。
@@ -492,4 +27,4 @@ export declare const convertHistoryRecord: HistoryRecordConverter;
  * // <ChatPanel :initial-messages="messages" ... />
  * ```
  */
-export declare const convertConversationDetail: ConversationDetailConverter;
+export declare const convertConversationDetail: import('../types/index').ConversationDetailConverter;