@mxmweb/rtext 1.3.10 → 1.4.3

package/thought_chain_types.d.ts

@@ -0,0 +1,64 @@
+/**
+ * 思维链相关的业务类型与节点状态枚举定义
+ * 2025-12-19 新增: 抽取统一的思维链类型，供历史会话与实时 SSE 复用。
+ */
+/**
+ * 思维链节点业务类型
+ * - plan: 理解与规划
+ * - retrieve: 召回 / 检索
+ * - think: 深度思考
+ * - reason: 推理
+ */
+export type ThoughtBusinessType = 'plan' | 'retrieve' | 'think' | 'reason';
+/**
+ * 思维链节点状态枚举
+ * 1. 运行中 2. 完成 3. 失败 4. 异常
+ */
+export type ThoughtNodeStatus = 1 | 2 | 3 | 4;
+/**
+ * 思维链节点统一结构
+ * 用于在 UI 组件中展示 plan / retrieve / think 的进度与内容。
+ */
+export interface ThoughtNode {
+    /** 节点唯一标识，可以由业务类型与顺序组合生成 */
+    id: string;
+    /** 业务类型：plan / retrieve / think */
+    businessType: ThoughtBusinessType;
+    /** 当前状态：待执行 / 运行中 / 完成 / 失败 / 异常 */
+    nodeStatus: ThoughtNodeStatus;
+    /** UI 中展示的标题，例如“理解规划完成”、“召回成功”等 */
+    title: string;
+    /** 主体内容文案，通常为模型生成的自然语言描述 */
+    content: string;
+    /** 原始业务数据，便于后续在弹窗中展示完整 JSON 或调试 */
+    rawContent?: any;
+}
+/**
+ * 思维链渲染模式
+ * - live: 实时流式 SSE 场景
+ * - history: 历史会话详情场景
+ */
+export type ThoughtChainRenderMode = 'live' | 'history';
+/**
+ * 思维链版本控制模式
+ * - auto: 默认按数据自动识别新老版本
+ * - v1: 强制使用旧版 <think> 解析逻辑
+ * - v2: 强制使用新版 chain + businessType/nodeStatus 逻辑
+ */
+export type ThoughtChainVersionMode = 'auto' | 'v1' | 'v2';
+/**
+ * 当前思维链解析版本开关
+ * 后续如果需要从外部注入（例如环境变量或运行时配置），可以调整为由上层传入。
+ */
+export declare const DEFAULT_THOUGHT_CHAIN_VERSION: ThoughtChainVersionMode;
+/**
+ * SSE 消息体的思维链相关字段
+ * 说明: 为了避免直接修改示例中的原始 SSEMessage 定义，将这一部分单独抽象，
+ * 由具体使用方通过交叉类型扩展。
+ */
+export interface ThoughtSSEMeta {
+    /** 节点业务类型：plan / retrieve / think */
+    businessType?: ThoughtBusinessType;
+    /** 节点状态：1.待执行 2.运行中 3.执行完成 4.执行失败 5.异常 */
+    nodeStatus?: ThoughtNodeStatus;
+}

package/utils/thought_chain_mapper.d.ts

@@ -0,0 +1,39 @@
+import { ThoughtNode, ThoughtBusinessType, ThoughtNodeStatus } from '../thought_chain_types';
+/**
+ * 历史 chain 原始节点类型（与后端对齐）
+ */
+export interface RawChainNode {
+    businessType: ThoughtBusinessType;
+    nodeStatus: ThoughtNodeStatus;
+    content: string;
+    type?: string;
+    [key: string]: any;
+}
+/**
+ * 统一的标题映射
+ */
+export declare function getThoughtTitleByBusinessType(type: ThoughtBusinessType): string;
+/**
+ * 将历史回复中的 chain 数组映射为 UI 使用的 ThoughtNode 列表
+ * 2025-12-19 新增: 支持 rtext 思维链 UI 升级。
+ * 2025-01-28 更新: 支持历史数据中的 reply.content 结构。
+ */
+export declare function mapReplyChainToNodes(chain: RawChainNode[] | undefined | null): ThoughtNode[];
+/**
+ * SSE 消息在当前文件中只需要关心与思维链相关的字段。
+ * 这里使用 Pick 代替直接引入完整类型，避免与示例组件产生循环依赖。
+ */
+export interface ThoughtSSEChunkMeta {
+    businessType?: ThoughtBusinessType;
+    nodeStatus?: ThoughtNodeStatus;
+    reply?: {
+        content?: string;
+        type?: string;
+    };
+}
+/**
+ * 将实时 SSE chunk 合并到现有 ThoughtNode 列表中
+ * - 若尚未存在对应业务类型，则创建一个新的节点
+ * - 若已存在，则根据 nodeStatus 更新状态与内容（追加文本）
+ */
+export declare function mergeLiveChunkToNodes(nodes: ThoughtNode[], chunk: ThoughtSSEChunkMeta): ThoughtNode[];

package/examples/sseDemo/index.d.ts

@@ -1 +0,0 @@
-export default function SSEDemo(): import("react/jsx-runtime").JSX.Element;