@kweaver-ai/chatkit 0.1.16 → 0.1.18

package/dist/components/dip/DIPBase.d.ts

@@ -1,7 +1,7 @@
-import { ApplicationContext, ChatMessage, OnboardingInfo, WebSearchQuery, ChartDataSchema, ConversationHistory, DefaultToolResult } from '../../types';
+import { ApplicationContext, ChatMessage, OnboardingInfo, WebSearchQuery, ChartDataSchema, ConversationHistory, DefaultToolResult, WebProcessorDataSchema } from '../../types';
 import { Constructor } from '../../utils/mixins';
 /**
- * DIP 的 AssistantMessage 接口
+ * DIP �?AssistantMessage 接口
  * 对应 agent-app.schemas.yaml#/components/schemas/Message
  */
 interface AssistantMessage {
@@ -19,7 +19,7 @@ interface AssistantMessage {
 }
 /**
  * OtherTypeAnswer 接口
- * 智能体输出的非文本类型内容
+ * 智能体输出的非文本类型内�?
  * 对应 agent-app.schemas.yaml#/components/schemas/OtherTypeAnswer
  */
 interface OtherTypeAnswer {
@@ -31,7 +31,7 @@ interface OtherTypeAnswer {
 }
 /**
  * SkillInfo 接口
- * 调用技能的技能详情
+ * 调用技能的技能详�?
  * 对应 agent-app.schemas.yaml#/components/schemas/SkillInfo
  */
 interface SkillInfo {
@@ -45,7 +45,7 @@ interface SkillInfo {
 }
 /**
  * Progress 接口
- * 智能体执行过程中的一个步骤
+ * 智能体执行过程中的一个步�?
  */
 interface Progress {
     stage?: string;
@@ -56,7 +56,7 @@ interface Progress {
 }
 /**
  * EventMessage 接口
- * DIP 的 Event Stream Message
+ * DIP �?Event Stream Message
  */
 interface EventMessage {
     seq_id?: number;
@@ -65,39 +65,39 @@ interface EventMessage {
     content?: any;
 }
 /**
- * DIPBase 的 props 接口
+ * DIPBase �?props 接口
  */
 export interface DIPBaseProps {
-    /** AISHU DIP 的 Agent Key,用作路径参数 */
+    /** AISHU DIP �?Agent Key,用作路径参数 */
     agentKey: string;
-    /** 访问令牌,需要包含 Bearer 前缀 (已废弃，请使用 token 属性) */
+    /** 访问令牌,需要包�?Bearer 前缀 (已废弃，请使�?token 属�? */
     bearerToken?: string;
-    /** 服务端基础地址,应包含 /api/agent-app/v1 前缀 */
+    /** 服务端基础地址,应包�?/api/agent-app/v1 前缀 */
     baseUrl?: string;
-    /** agent 版本，"v0"表示最新版本，默认 "v0" */
+    /** agent 版本�?v0"表示最新版本，默认 "v0" */
     agentVersion?: string;
-    /** 智能体执行引擎版本，最新为"v2"，默认 "v2" */
+    /** 智能体执行引擎版本，最新为"v2"，默�?"v2" */
     executorVersion?: string;
-    /** 智能体所属的业务域,用于 agent-factory API */
+    /** 智能体所属的业务�?用于 agent-factory API */
     businessDomain?: string;
     /** 调用接口时携带的令牌 */
     token?: string;
-    /** 刷新 token 的方法 */
+    /** 刷新 token 的方�?*/
     refreshToken?: () => Promise<string>;
 }
 /**
  * DIPBase Mixin 函数
- * 根据 TypeScript 官方文档实现的 mixin 模式
+ * 根据 TypeScript 官方文档实现�?mixin 模式
  *
- * 该 mixin 为基础类添加 AISHU DIP API 的集成能力，包括：
+ * �?mixin 为基础类添�?AISHU DIP API 的集成能力，包括�?
  * - getOnboardingInfo(): 获取开场白信息
- * - generateConversation(): 创建新会话
- * - reduceAssistantMessage(): 从 EventStream 中提取出 action 和 content，并根据 action 将 content 增量更新到 AssistantMessage
- * - shouldRefreshToken(): 判断 API 响应的状态码是否是 401，如果是，则表示需要刷新 Token
+ * - generateConversation(): 创建新会�?
+ * - reduceAssistantMessage(): �?EventStream 中提取出 action �?content，并根据 action �?content 增量更新�?AssistantMessage
+ * - shouldRefreshToken(): 判断 API 响应的状态码是否�?401，如果是，则表示需要刷�?Token
  * - terminateConversation(): 终止会话
  *
- * @param Base 基础类，通常是 CopilotBase 或 AssistantBase
- * @returns 混入 DIP 功能后的类
+ * @param Base 基础类，通常�?CopilotBase �?AssistantBase
+ * @returns 混入 DIP 功能后的�?
  */
 export declare function DIPBaseMixin<TBase extends Constructor>(Base: TBase): {
     new (...args: any[]): {
@@ -109,138 +109,149 @@ export declare function DIPBaseMixin<TBase extends Constructor>(Base: TBase): {
         agentInfo: any;
         /** agent 版本 */
         dipVersion: string;
-        /** 智能体执行引擎版本 */
+        /** 智能体执行引擎版�?*/
         dipExecutorVersion: string;
-        /** 业务域 */
+        /** 业务�?*/
         dipBusinessDomain: string;
         /** DIP 调用接口时携带的令牌 */
         dipToken: string;
-        /** DIP 刷新 token 的方法 */
+        /** DIP 刷新 token 的方�?*/
         dipRefreshToken?: () => Promise<string>;
-        /** LeftHeaderTool 使用的 API 方法（构造时缓存，避免流式消息时重复创建） */
+        /** LeftHeaderTool 使用�?API 方法（构造时缓存，避免流式消息时重复创建�?*/
         _leftHeaderApiMethods?: {
             getKnowledgeNetworksDetail: (id: string) => Promise<any>;
             getKnowledgeNetworkObjectTypes: (id: string, offset?: number, limit?: number) => Promise<any>;
             getMetricInfoByIds: (ids: string[]) => Promise<any[]>;
         };
         /**
-         * 获取开场白和预置问题
-         * 调用 AISHU DIP 的 agent-factory API 获取智能体配置信息，提取开场白和预置问题
+         * 获取开场白和预置问�?
+         * 调用 AISHU DIP �?agent-factory API 获取智能体配置信息，提取开场白和预置问�?
          * API 端点: GET /api/agent-factory/v3/agent-market/agent/{agent_key}/version/v0
          * 注意：该方法是一个无状态无副作用的函数，不允许修改 state
-         * @returns 返回开场白信息，包含开场白文案和预置问题
+         * @returns 返回开场白信息，包含开场白文案和预置问�?
          */
         getOnboardingInfo(): Promise<OnboardingInfo>;
         /**
          * 创建新的会话
-         * 调用 DIP API 创建新的会话，返回会话 ID
+         * 调用 DIP API 创建新的会话，返回会�?ID
          * API 端点: POST /app/{agent_key}/conversation
          * 注意：该方法是一个无状态无副作用的函数，不允许修改 state
-         * @param title 会话标题，通常是用户发送的第一条消息内容
+         * @param title 会话标题，通常是用户发送的第一条消息内�?
          * @returns 返回新创建的会话 ID
          */
         generateConversation(title?: string): Promise<string>;
         /**
-         * 调用 DIP API 发送消息(流式)
+         * 调用 DIP API 发送消�?流式)
          * 该方法实现了完整的消息发送逻辑,子类无需覆盖
          * @param text 用户输入
-         * @param ctx 应用上下文
+         * @param ctx 应用上下�?
          * @param conversationID 发送的对话消息所属的会话 ID
-         * @param regenerateMessageId 需要重新生成的助手消息 ID（可选，用于重新生成功能）
+         * @param regenerateMessageId 需要重新生成的助手消息 ID（可选，用于重新生成功能�?
          * @returns 返回助手消息
          */
         sendMessage(text: string, ctx: ApplicationContext, conversationID?: string, regenerateMessageId?: string): Promise<ChatMessage>;
         /**
-         * 将 API 接口返回的 EventStream 增量解析成完整的 AssistantMessage 对象
+         * �?API 接口返回�?EventStream 增量解析成完整的 AssistantMessage 对象
          * 根据设计文档实现白名单机制和 JSONPath 处理
          *
          * 处理流程（符合文档流程图）：
          * 1. 解析 EventMessage
-         * 2. 检查 AssistantMessage 实例是否已经存在
-         * 3. 如果不存在且 key 包含 assistant_message，则初始化 AssistantMessage 对象
-         * 4. 检查 action 和 JSONPath 是否在白名单中
+         * 2. 检�?AssistantMessage 实例是否已经存在
+         * 3. 如果不存在且 key 包含 assistant_message，则初始�?AssistantMessage 对象
+         * 4. 检�?action �?JSONPath 是否在白名单�?
          * 5. 如果在白名单中，根据 action 处理 content 并执行后处理
-         * 6. 处理完成后，检查 AssistantMessage.message.id 并同步更新 ChatMessage.messageId
-         *    保证 AssistantMessage.id 和 ChatMessage.messageId 保持一致
+         * 6. 处理完成后，检�?AssistantMessage.message.id 并同步更�?ChatMessage.messageId
+         *    保证 AssistantMessage.id �?ChatMessage.messageId 保持一�?
          *
-         * @param eventMessage 接收到的一条 Event Message
-         * @param prev 上一次增量更新后的 AssistantMessage 对象
-         * @param messageId 当前正在更新的消息 ID
+         * @param eventMessage 接收到的一�?Event Message
+         * @param prev 上一次增量更新后�?AssistantMessage 对象
+         * @param messageId 当前正在更新的消�?ID
          * @returns 返回更新后的 AssistantMessage 对象
          */
         reduceAssistantMessage<T = any, K = any>(eventMessage: T, prev: K, messageId: string): K;
         /**
-         * 解析原始事件为 EventMessage
+         * 解析原始事件�?EventMessage
          */
         parseEventMessage(raw: any): EventMessage;
         /**
-         * 将 key 数组转换为 JSONPath 字符串
+         * �?key 数组转换�?JSONPath 字符�?
          * 例如: ["message", "content", "middle_answer", "progress", 0]
          * => "message.content.middle_answer.progress[0]"
          */
         keyToJSONPath(key: Array<string | number>): string;
         /**
-         * 白名单定义
-         * 根据设计文档 3.2 Event Message 白名单
+         * 白名单定�?
+         * 根据设计文档 3.2 Event Message 白名�?
          *
-         * 注意：postProcess 方法需要调用 appendMarkdownBlock 和 appendWebSearchBlock
-         * 这些方法需要在子类中实现
+         * 注意：postProcess 方法需要调�?appendMarkdownBlock �?appendWebSearchBlock
+         * 这些方法需要在子类中实�?
          */
         getWhitelistEntry(action: string, jsonPath: string): {
             postProcess?: (assistantMessage: AssistantMessage, content: any, messageId: string) => void;
         } | null;
         /**
-         * 从 Progress 对象中提取 Web 搜索查询
-         * 根据 OpenAPI 规范，搜索数据在 answer.choices[0].message.tool_calls 中
-         * tool_calls[0] 是 SearchIntent（输入），tool_calls[1] 是 SearchResult（输出）
+         * 在流式结束后，将完整�?AssistantMessage 结构一次性应用到指定 ChatMessage�?
+         * - 遍历 middle_answer.progress，按顺序调用 appendSkillOrLLMContentToMessage 组装所有工具和 LLM 内容�?
+         * - 基于 message.ext 同步 messageContext（相关问题、耗时、Token 等），与历史会话逻辑保持一�?
+         *
+         * 作为受保护方法暴露，便于子类在特殊场景下自定义流式结果的应用逻辑�?
+         */
+        applyAssistantMessageFromStream(assistantMessage: AssistantMessage, messageId: string): void;
+        /**
+         * �?Progress 对象中提�?Web 搜索查询
+         * 根据 OpenAPI 规范，搜索数据在 answer.choices[0].message.tool_calls �?
+         * tool_calls[0] �?SearchIntent（输入），tool_calls[1] �?SearchResult（输出）
          */
         extractWebSearchQuery(progress: any): WebSearchQuery | null;
         /**
-         * 从 Progress 对象中提取 Json2Plot 图表数据
-         * 根据 OpenAPI 规范，Json2Plot 数据在 answer.choices[0].message.tool_calls 中
-         * tool_calls 中包含 Json2PlotAnswer，格式为 { result: Json2PlotResult, full_result: Json2PlotFullResult }
+         * �?Progress 对象中提�?Json2Plot 图表数据
+         * 根据 OpenAPI 规范，Json2Plot 数据�?answer.choices[0].message.tool_calls �?
+         * tool_calls 中包�?Json2PlotAnswer，格式为 { result: Json2PlotResult, full_result: Json2PlotFullResult }
          * Json2PlotResult 包含: data_sample, chart_config, title, text
          * Json2PlotFullResult 包含: data, chart_config, title, text
          * ChartConfig 包含: xField, yField, seriesField, chart_type, groupField, isStack, isGroup
          */
         extractJson2PlotData(progress: any): ChartDataSchema | null;
         /**
+         * 提取 WebProcessor 数据
+         */
+        extractWebProcessorData(answer: any): WebProcessorDataSchema | null; /**
          * 推断数据类型
          */
         inferDataType(value: any): "string" | "number" | "date" | "boolean";
         /**
          * 计算耗时（毫秒）
          * @param startTime 开始时间戳
-         * @param endTime 结束时间戳
-         * @returns 耗时（毫秒），如果时间戳无效则返回 undefined
+         * @param endTime 结束时间�?
+         * @returns 耗时（毫秒），如果时间戳无效则返�?undefined
          */
         calculateConsumeTime(startTime?: number, endTime?: number): number | undefined;
         /**
          * 处理技能调用的统一方法
          * 根据设计文档 3.2 Event Message 白名单中的后处理逻辑
-         * @param skillInfo 技能信息
+         * @param skillInfo 技能信�?
          * @param answer 技能执行的 answer 字段
          * @param messageId 消息 ID
-         * @param consumeTime 耗时（毫秒），可选
+         * @param consumeTime 耗时（毫秒），可�?
          */
         processSkillExecution(skillInfo: SkillInfo | undefined, answer: any, messageId: string, consumeTime?: number): void;
         /**
-         * 处理 middle_answer.progress 中的一个元素
+         * 处理 middle_answer.progress 中的一个元�?
          * 根据设计文档 3.2 Event Message 白名单中的后处理逻辑
          * @param content Progress 对象
          * @param messageId 消息 ID
          */
         processMiddleAnswerProgress(content: Progress, messageId: string): void;
         /**
-         * 从 answer.choices 中提取 Web 搜索查询
+         * �?answer.choices 中提�?Web 搜索查询
          * 用于处理 middle_answer.progress 中的搜索结果
          */
         extractWebSearchQueryFromAnswer(answer: any): WebSearchQuery | null;
         /**
-         * 从 skill_info.args 和 answer 中提取图表数据并转换为 ChartDataSchema
-         * 用于处理 json2plot 工具的输出
-         * @param args 技能参数数组（保留用于 API 一致性，实际数据从 answer 中提取）
-         * @param answer 技能执行的 answer 字段，包含 result 或 full_result
+         * �?skill_info.args �?answer 中提取图表数据并转换�?ChartDataSchema
+         * 用于处理 json2plot 工具的输�?
+         * @param args 技能参数数组（保留用于 API 一致性，实际数据�?answer 中提取）
+         * @param answer 技能执行的 answer 字段，包�?result �?full_result
          * @returns ChartDataSchema 对象，如果解析失败则返回 null
          */
         extractChartDataFromArgs(_args: Array<{
@@ -249,11 +260,11 @@ export declare function DIPBaseMixin<TBase extends Constructor>(Base: TBase): {
             value?: string;
         }> | undefined, answer: any): ChartDataSchema | null;
         /**
-         * 从 skill_info.args 和 answer 中提取代码执行结果
+         * �?skill_info.args �?answer 中提取代码执行结�?
          * 用于处理 execute_code 工具的输入和输出
          * @param args skill_info.args 数组，包含执行的代码
-         * @param answer 技能执行的 answer 字段，包含执行结果
-         * @returns ExecuteCodeResult 对象，包含 input 和 output
+         * @param answer 技能执行的 answer 字段，包含执行结�?
+         * @returns ExecuteCodeResult 对象，包�?input �?output
          */
         extractExecuteCodeResult(args: Array<{
             name?: string;
@@ -264,15 +275,15 @@ export declare function DIPBaseMixin<TBase extends Constructor>(Base: TBase): {
             output: string;
         } | null;
         /**
-         * 从 skill_info.args 和 answer 中提取 Text2SQL 结果
+         * �?skill_info.args �?answer 中提�?Text2SQL 结果
          * 用于处理 text2sql 工具的输入和输出
-         * 根据 OpenAPI 规范，Text2SqlResult 包含 result 和 full_result
-         * - result: Text2SqlResultData（包含 data_desc，但可能只有数据样本）
-         * - full_result: Text2SqlFullResultData（包含完整数据，但没有 data_desc）
+         * 根据 OpenAPI 规范，Text2SqlResult 包含 result �?full_result
+         * - result: Text2SqlResultData（包�?data_desc，但可能只有数据样本�?
+         * - full_result: Text2SqlFullResultData（包含完整数据，但没�?data_desc�?
          * 优先使用 full_result，如果没有则使用 result
-         * @param args skill_info.args 数组，包含查询文本
-         * @param answer 技能执行的 answer 字段，包含 SQL 执行结果
-         * @returns Text2SqlResult 对象，包含 input、sql、data 等信息
+         * @param args skill_info.args 数组，包含查询文�?
+         * @param answer 技能执行的 answer 字段，包�?SQL 执行结果
+         * @returns Text2SqlResult 对象，包�?input、sql、data 等信�?
          */
         extractText2SqlResult(args: Array<{
             name?: string;
@@ -297,15 +308,15 @@ export declare function DIPBaseMixin<TBase extends Constructor>(Base: TBase): {
             explanation?: any;
         } | null;
         /**
-         * 从 skill_info.args 和 answer 中提取 Text2Metric 结果
+         * �?skill_info.args �?answer 中提�?Text2Metric 结果
          * 用于处理 text2metric 工具的输入和输出
-         * 根据 OpenAPI 规范，Text2MetricResult 包含 result 和 full_result
-         * - result: Text2MetricResultData（包含 data_desc，但可能只有数据样本）
-         * - full_result: Text2MetricFullResultData（包含完整数据，但没有 data_desc）
+         * 根据 OpenAPI 规范，Text2MetricResult 包含 result �?full_result
+         * - result: Text2MetricResultData（包�?data_desc，但可能只有数据样本�?
+         * - full_result: Text2MetricFullResultData（包含完整数据，但没�?data_desc�?
          * 优先使用 full_result，如果没有则使用 result
-         * @param args skill_info.args 数组，包含查询参数
-         * @param answer 技能执行的 answer 字段，包含指标查询结果
-         * @returns Text2MetricResult 对象，包含 title、args、data 等信息
+         * @param args skill_info.args 数组，包含查询参�?
+         * @param answer 技能执行的 answer 字段，包含指标查询结�?
+         * @returns Text2MetricResult 对象，包�?title、args、data 等信�?
          */
         extractText2MetricResult(args: Array<{
             name?: string;
@@ -317,14 +328,14 @@ export declare function DIPBaseMixin<TBase extends Constructor>(Base: TBase): {
             data?: Array<Record<string, any>>;
         } | null;
         /**
-         * 从 skill_info.args 和 answer 中提取 AfSailor 结果
+         * �?skill_info.args �?answer 中提�?AfSailor 结果
          * 用于处理 af_sailor 工具的输入和输出
          * 根据 OpenAPI 规范，AfSailorResult 包含 result
-         * - result: AfSailorResultData（包含 text、cites、result_cache_key）
-         * 根据 ChatKit.pdf，AfSailorResult 包含 data（Array<Record<string, string>>）
+         * - result: AfSailorResultData（包�?text、cites、result_cache_key�?
+         * 根据 ChatKit.pdf，AfSailorResult 包含 data（Array<Record<string, string>>�?
          * @param _args skill_info.args 数组，包含查询参数（当前未使用，保留以保持接口一致性）
-         * @param answer 技能执行的 answer 字段，包含找数查询结果
-         * @returns AfSailorResult 对象，包含 data、text、cites 等信息
+         * @param answer 技能执行的 answer 字段，包含找数查询结�?
+         * @returns AfSailorResult 对象，包�?data、text、cites 等信�?
          */
         extractAfSailorResult(_args: Array<{
             name?: string;
@@ -337,14 +348,14 @@ export declare function DIPBaseMixin<TBase extends Constructor>(Base: TBase): {
             result_cache_key?: string;
         } | null;
         /**
-         * 从 skill_info.args 和 answer 中提取 DatasourceFilter 结果
+         * �?skill_info.args �?answer 中提�?DatasourceFilter 结果
          * 用于处理 datasource_filter 工具的输入和输出
          * 根据 OpenAPI 规范，DatasourceFilterResult 包含 result
-         * - result: DatasourceFilterResultData（包含 result、result_cache_key）
+         * - result: DatasourceFilterResultData（包�?result、result_cache_key�?
          * - result.result: DataCatalogMatch[]（数据目录匹配结果列表）
          * @param _args skill_info.args 数组，包含查询参数（当前未使用，保留以保持接口一致性）
          * @param answer 技能执行的 answer 字段，包含数据源过滤结果
-         * @returns DatasourceFilterResult 对象，包含 result、result_cache_key 等信息
+         * @returns DatasourceFilterResult 对象，包�?result、result_cache_key 等信�?
          */
         extractDatasourceFilterResult(_args: Array<{
             name?: string;
@@ -355,12 +366,12 @@ export declare function DIPBaseMixin<TBase extends Constructor>(Base: TBase): {
             result_cache_key?: string;
         } | null;
         /**
-         * 从 skill_info.args 和 answer 中提取 DatasourceRerank 结果
-         * 用于处理 datasource_rerank 工具的输入和输出，与 datasource_filter 处理方式一致
+         * �?skill_info.args �?answer 中提�?DatasourceRerank 结果
+         * 用于处理 datasource_rerank 工具的输入和输出，与 datasource_filter 处理方式一�?
          * 根据 OpenAPI 规范，DatasourceRerankResult 包含 result（DataCatalogMatch[]）及 result_cache_key
          * @param _args skill_info.args 数组，包含查询参数（当前未使用，保留以保持接口一致性）
          * @param answer 技能执行的 answer 字段，包含数据源重排结果
-         * @returns DatasourceRerankResult 对象，包含 result、result_cache_key 等信息
+         * @returns DatasourceRerankResult 对象，包�?result、result_cache_key 等信�?
          */
         extractDatasourceRerankResult(_args: Array<{
             name?: string;
@@ -371,14 +382,14 @@ export declare function DIPBaseMixin<TBase extends Constructor>(Base: TBase): {
             result_cache_key?: string;
         } | null;
         /**
-         * 将技能调用或 LLM 回答的内容追加到消息中
-         * 用于历史消息解析，根据 stage 和 skill_info 将内容添加到 ChatMessage.content 数组
-         * @param item Progress 或 OtherTypeAnswer 对象
+         * 将技能调用或 LLM 回答的内容追加到消息�?
+         * 用于历史消息解析，根�?stage �?skill_info 将内容添加到 ChatMessage.content 数组
+         * @param item Progress �?OtherTypeAnswer 对象
          * @param message ChatMessage 对象
          */
         appendSkillOrLLMContentToMessage(item: Progress | OtherTypeAnswer, message: ChatMessage): void;
         /**
-         * 构造默认工具结果
+         * 构造默认工具结�?
          * 对应设计文档 4.32 DefaultToolResult 及默认工具处理逻辑
          */
         buildDefaultToolResult(skillInfo: SkillInfo | undefined, answer: any): {
@@ -387,60 +398,60 @@ export declare function DIPBaseMixin<TBase extends Constructor>(Base: TBase): {
         } | null;
         /**
          * 执行 upsert 操作
-         * 将 content 赋值到 JSONPath 指定的位置
+         * �?content 赋值到 JSONPath 指定的位�?
          */
         applyUpsert(obj: AssistantMessage, key: Array<string | number>, content: any): AssistantMessage;
         /**
          * 执行 append 操作
-         * 如果 JSONPath 是数组下标，在该位置插入新对象
+         * 如果 JSONPath 是数组下标，在该位置插入新对�?
          * 否则在文本后追加内容
          */
         applyAppend(obj: AssistantMessage, key: Array<string | number>, content: any): AssistantMessage;
         /**
-         * 获取嵌套属性
+         * 获取嵌套属�?
          */
         getNestedProperty(obj: any, key: Array<string | number>): any;
         /**
-         * 设置嵌套属性
+         * 设置嵌套属�?
          */
         setNestedProperty(obj: any, key: Array<string | number>, value: any): void;
         /**
-         * 按路径不可变设置：只克隆从根到 key 路径上的节点，其余引用复用，避免全量深拷贝大对象
+         * 按路径不可变设置：只克隆从根�?key 路径上的节点，其余引用复用，避免全量深拷贝大对象
          */
         immutableSetNested(obj: any, key: Array<string | number>, value: any): any;
         /**
-         * 不可变 upsert：按路径更新，不深拷贝整棵树
+         * 不可�?upsert：按路径更新，不深拷贝整棵树
          */
         immutableApplyUpsert(obj: AssistantMessage, key: Array<string | number>, content: any): AssistantMessage;
         /**
-         * 不可变 append：按路径追加后按路径更新，不深拷贝整棵树
+         * 不可�?append：按路径追加后按路径更新，不深拷贝整棵树
          */
         immutableApplyAppend(obj: AssistantMessage, key: Array<string | number>, content: any): AssistantMessage;
         /**
-         * 检查是否需要刷新 token
-         * AISHU DIP 平台返回 401 状态码时表示 token 失效
+         * 检查是否需要刷�?token
+         * AISHU DIP 平台返回 401 状态码时表�?token 失效
          * @param status HTTP 状态码
-         * @param error 错误响应体
-         * @returns 返回是否需要刷新 token
+         * @param error 错误响应�?
+         * @returns 返回是否需要刷�?token
          */
         shouldRefreshToken(status: number, _error: any): boolean;
         /**
          * 终止会话
-         * 调用 DIP 的 /app/{agent_key}/chat/termination 接口终止指定会话
-         * 若返回 401 会先调用 refreshToken 获取新 token 并重试一次
+         * 调用 DIP �?/app/{agent_key}/chat/termination 接口终止指定会话
+         * 若返�?401 会先调用 refreshToken 获取�?token 并重试一�?
          * @param conversationId 要终止的会话 ID
          * @returns 返回 Promise，成功时 resolve，失败时 reject
          */
         terminateConversation(conversationId: string): Promise<void>;
         /**
-         * 执行 API 调用，并在需要时自动刷新 token 并重试一次
+         * 执行 API 调用，并在需要时自动刷新 token 并重试一�?
          * @param apiCall API 调用函数
          * @returns API 调用结果
          */
         executeDataAgentWithTokenRefresh<T>(apiCall: () => Promise<T>): Promise<T>;
         /**
          * 获取历史会话列表
-         * 调用 DIP 的 GET /app/{agent_key}/conversation 接口获取会话列表
+         * 调用 DIP �?GET /app/{agent_key}/conversation 接口获取会话列表
          * API 端点: GET /app/{agent_key}/conversation?page={page}&size={size}
          * 注意：该方法是一个无状态无副作用的函数，不允许修改 state
          * @param page 分页页码，默认为 1
@@ -449,9 +460,9 @@ export declare function DIPBaseMixin<TBase extends Constructor>(Base: TBase): {
          */
         getConversations(page?: number, size?: number): Promise<ConversationHistory[]>;
         /**
-         * 获取指定会话 ID 的对话消息列表
-         * 调用 DIP 的 GET /app/{agent_key}/conversation/{conversation_id} 接口获取会话详情
-         * 如果对话消息是 AI 助手消息，则需要调用 reduceAssistantMessage() 解析消息
+         * 获取指定会话 ID 的对话消息列�?
+         * 调用 DIP �?GET /app/{agent_key}/conversation/{conversation_id} 接口获取会话详情
+         * 如果对话消息�?AI 助手消息，则需要调�?reduceAssistantMessage() 解析消息
          * API 端点: GET /app/{agent_key}/conversation/{conversation_id}
          * 注意：该方法是一个无状态无副作用的函数，不允许修改 state
          * @param conversationId 会话 ID
@@ -459,8 +470,8 @@ export declare function DIPBaseMixin<TBase extends Constructor>(Base: TBase): {
          */
         getConversationMessages(conversationId: string): Promise<ChatMessage[]>;
         /**
-         * 删除指定 ID 的会话
-         * 调用 DIP 的 DELETE /app/{agent_key}/conversation/{conversation_id} 接口删除会话
+         * 删除指定 ID 的会�?
+         * 调用 DIP �?DELETE /app/{agent_key}/conversation/{conversation_id} 接口删除会话
          * API 端点: DELETE /app/{agent_key}/conversation/{conversation_id}
          * 注意：该方法是一个无状态无副作用的函数，不允许修改 state
          * @param conversationID 会话 ID
@@ -469,7 +480,7 @@ export declare function DIPBaseMixin<TBase extends Constructor>(Base: TBase): {
         deleteConversation(conversationID: string): Promise<void>;
         /**
          * 获取知识网络详情
-         * 调用 DIP 的 GET /api/ontology-manager/v1/knowledge-networks/{id} 接口
+         * 调用 DIP �?GET /api/ontology-manager/v1/knowledge-networks/{id} 接口
          * API 端点: GET /api/ontology-manager/v1/knowledge-networks/{id}
          * 注意：该方法是一个无状态无副作用的函数，不允许修改 state
          * @param id 知识网络 ID
@@ -477,19 +488,19 @@ export declare function DIPBaseMixin<TBase extends Constructor>(Base: TBase): {
          */
         getKnowledgeNetworksDetail(id: string): Promise<any>;
         /**
-         * 获取知识网络的对象类型
-         * 调用 DIP 的 GET /api/ontology-manager/v1/knowledge-networks/{id}/object-types 接口
+         * 获取知识网络的对象类�?
+         * 调用 DIP �?GET /api/ontology-manager/v1/knowledge-networks/{id}/object-types 接口
          * API 端点: GET /api/ontology-manager/v1/knowledge-networks/{id}/object-types
          * 注意：该方法是一个无状态无副作用的函数，不允许修改 state
          * @param id 知识网络 ID
          * @param offset 偏移量，默认 0
-         * @param limit 每页返回条数，默认 -1（全部）
+         * @param limit 每页返回条数，默�?-1（全部）
          * @returns 返回对象类型列表
          */
         getKnowledgeNetworkObjectTypes(id: string, offset?: number, limit?: number): Promise<any>;
         /**
          * 根据指标 ID 获取指标信息
-         * 调用 DIP 的 GET /api/mdl-data-model/v1/metric-models/{ids} 接口
+         * 调用 DIP �?GET /api/mdl-data-model/v1/metric-models/{ids} 接口
          * API 端点: GET /api/mdl-data-model/v1/metric-models/{ids}
          * 注意：该方法是一个无状态无副作用的函数，不允许修改 state
          * @param ids 指标 ID 列表，多个用逗号隔开