@blueking/chat-helper 0.0.12-beta.18 → 0.0.12-beta.19

package/README.md

@@ -324,6 +324,17 @@ http.message; // Message API
 
 一般情况下，您不需要直接使用 `http` 模块，因为 `agent`、`session` 和 `message` 模块已经封装了常用的业务逻辑。
 
+**`http.message.getMessages`（可单独使用）**：
+
+```typescript
+// (sessionCode: string, limit?: number, config?: IRequestConfig, fuzzy?: string) => Promise<IMessage[]>
+// GET session_content/content/ — 支持可选 fuzzy 模糊检索
+const messages = await http.message.getMessages(sessionCode);
+const filtered = await http.message.getMessages(sessionCode, undefined, undefined, '关键词');
+```
+
+> 业务层 `message.getMessages(sessionCode)` 未透传 `fuzzy`。需要模糊检索时请直接调用 `http.message.getMessages`。`fuzzy` 位于参数末尾，不影响既有 `limit` / `config` 调用。
+
 ## 配置选项
 
 ### requestData（必需）
@@ -416,7 +427,6 @@ useChatHelper({
 **拦截器使用场景**：
 
 1. **请求拦截器**：
-
    - 添加认证 token
    - 添加请求时间戳
    - 添加请求 ID
@@ -994,8 +1004,8 @@ class SafeProtocol extends AGUIProtocol {
       mode.value === 'creative'
         ? 'chat_completion_creative/'
         : mode.value === 'precise'
-        ? 'chat_completion_precise/'
-        : undefined;
+          ? 'chat_completion_precise/'
+          : undefined;
 
     // 自定义请求参数
     agent.chat(userInput.value, session.current.sessionCode, endpoint, {
@@ -1555,13 +1565,11 @@ interface IToolMessage {
 **参数：**
 
 - `options.requestData` (必需)
-
   - `urlPrefix: string` - API 基础路径
   - `data?: Record<string, unknown> | (() => Record<string, unknown>)` - 额外的请求数据
   - `headers?: Record<string, string> | (() => Record<string, string>)` - 额外的请求头
 
 - `options.interceptors` (可选)
-
   - `request?: (config: IRequestConfig) => IRequestConfig` - 请求拦截器
   - `response?: (response: IResponse) => IResponse` - 响应拦截器
 

package/dist/agent/use-agent.ts.js

@@ -246,7 +246,7 @@ const getReconnectDelayMs = (attempt)=>Math.min(RECONNECT_BASE_DELAY_MS * Math.p
         runFinished = false;
         clearReconnectTimer(false);
     };
-    /** 裁掉尾部尚未完成的非用户消息，避免 DLQ 重放时重复气泡 */ const pruneTrailingIncompleteMessages = ()=>{
+    /** 裁掉尾部尚未完成的非用户消息，避免断线重放时重复气泡 */ const pruneTrailingIncompleteMessages = ()=>{
         var _mediator_message;
         const list = (_mediator_message = mediator.message) === null || _mediator_message === void 0 ? void 0 : _mediator_message.list.value;
         if (!(list === null || list === void 0 ? void 0 : list.length)) {
@@ -401,7 +401,7 @@ const getReconnectDelayMs = (attempt)=>Math.min(RECONNECT_BASE_DELAY_MS * Math.p
                     finishSuccessfully();
                     return;
                 }
-                // 连接被干净掐断且未收到 RUN_FINISHED：尝试静默重连
+                // 连接被干净掐断且未收到终端事件（RUN_FINISHED / RUN_ERROR）：尝试静默重连
                 void attemptSilentReconnect(sessionCode, streamId).then((result)=>{
                     if (!isActiveStream()) {
                         return;
@@ -454,7 +454,9 @@ const getReconnectDelayMs = (attempt)=>Math.min(RECONNECT_BASE_DELAY_MS * Math.p
                     return;
                 }
                 const typedEvent = event;
-                if ((typedEvent === null || typedEvent === void 0 ? void 0 : typedEvent.type) === EventType.RunFinished) {
+                // RUN_FINISHED / RUN_ERROR 均为终端事件：关流后走正常收尾，勿静默重连
+                // （用户 stop 后后端推 RUN_ERROR「用户已取消」，而非 RUN_FINISHED）
+                if ((typedEvent === null || typedEvent === void 0 ? void 0 : typedEvent.type) === EventType.RunFinished || (typedEvent === null || typedEvent === void 0 ? void 0 : typedEvent.type) === EventType.RunError) {
                     runFinished = true;
                 }
                 (_usedProtocol_onMessage = usedProtocol.onMessage) === null || _usedProtocol_onMessage === void 0 ? void 0 : _usedProtocol_onMessage.call(usedProtocol, event);

package/dist/event/ag-ui.d.ts

@@ -133,7 +133,7 @@ export declare class AGUIProtocol implements ISSEProtocol {
     handleTextMessageEndEvent(event: ITextMessageEndEvent): void;
     /**
      * 处理文本消息开始事件
-     * 断线续传时 DLQ 会重放事件：同 messageId 已存在则重置内容，避免重复气泡/文本翻倍
+     * 断线续传时会重放缓存事件：同 messageId 已存在则重置内容，避免重复气泡/文本翻倍
      */
     handleTextMessageStartEvent(event: ITextMessageStartEvent): void;
     /**

package/dist/event/ag-ui.ts.js

@@ -380,7 +380,7 @@ import { CustomEventName, EventType, FlowTaskState, RunFinishedOutcomeType } fro
     }
     /**
    * 处理文本消息开始事件
-   * 断线续传时 DLQ 会重放事件：同 messageId 已存在则重置内容，避免重复气泡/文本翻倍
+   * 断线续传时会重放缓存事件：同 messageId 已存在则重置内容，避免重复气泡/文本翻倍
    */ handleTextMessageStartEvent(event) {
         const existing = this.messageModule.getMessageByMessageId(event.messageId);
         if (existing) {

package/dist/http/index.d.ts

@@ -43,7 +43,7 @@ export declare const useHttp: (options: IUseChatHelperOptions) => {
         isResumeSession: (sessionCode: string, config?: import("./fetch").IRequestConfig) => Promise<boolean>;
     };
     message: {
-        getMessages: (sessionCode: string, limit?: number, config?: import("./fetch").IRequestConfig) => Promise<import("..").IMessage[]>;
+        getMessages: (sessionCode: string, limit?: number, config?: import("./fetch").IRequestConfig, fuzzy?: string) => Promise<import("..").IMessage[]>;
         plusMessage: (data: import("..").IMessage, config?: import("./fetch").IRequestConfig) => Promise<import("..").IActivityMessage | import("..").IAssistantMessage | import("..").IDeveloperMessage | import("..").IGuideMessage | import("..").IHiddenAssistantMessage | import("..").IHiddenGuideMessage | import("..").IHiddenMessage | import("..").IHiddenSystemMessage | import("..").IHiddenUserMessage | import("..").IInfoMessage | import("..").IPauseMessage | import("..").IPlaceholderMessage | import("..").IReasoningMessage | import("..").ISystemMessage | import("..").ITemplateAssistantMessage | import("..").ITemplateGuideMessage | import("..").ITemplateHiddenMessage | import("..").ITemplateSystemMessage | import("..").ITemplateUserMessage | import("..").IToolMessage | import("..").IUserMessage | import("..").IInterruptMessage>;
         modifyMessage: (data: import("..").IMessage, config?: import("./fetch").IRequestConfig) => Promise<import("..").IActivityMessage | import("..").IAssistantMessage | import("..").IDeveloperMessage | import("..").IGuideMessage | import("..").IHiddenAssistantMessage | import("..").IHiddenGuideMessage | import("..").IHiddenMessage | import("..").IHiddenSystemMessage | import("..").IHiddenUserMessage | import("..").IInfoMessage | import("..").IPauseMessage | import("..").IPlaceholderMessage | import("..").IReasoningMessage | import("..").ISystemMessage | import("..").ITemplateAssistantMessage | import("..").ITemplateGuideMessage | import("..").ITemplateHiddenMessage | import("..").ITemplateSystemMessage | import("..").ITemplateUserMessage | import("..").IToolMessage | import("..").IUserMessage | import("..").IInterruptMessage>;
         deleteMessage: (id: string, config?: import("./fetch").IRequestConfig) => Promise<import("..").IMessage>;

package/dist/http/module/index.d.ts

@@ -38,7 +38,7 @@ export declare const useModule: (fetchClient: FetchClient) => {
         isResumeSession: (sessionCode: string, config?: import("../fetch").IRequestConfig) => Promise<boolean>;
     };
     message: {
-        getMessages: (sessionCode: string, limit?: number, config?: import("../fetch").IRequestConfig) => Promise<import("../..").IMessage[]>;
+        getMessages: (sessionCode: string, limit?: number, config?: import("../fetch").IRequestConfig, fuzzy?: string) => Promise<import("../..").IMessage[]>;
         plusMessage: (data: import("../..").IMessage, config?: import("../fetch").IRequestConfig) => Promise<import("../..").IActivityMessage | import("../..").IAssistantMessage | import("../..").IDeveloperMessage | import("../..").IGuideMessage | import("../..").IHiddenAssistantMessage | import("../..").IHiddenGuideMessage | import("../..").IHiddenMessage | import("../..").IHiddenSystemMessage | import("../..").IHiddenUserMessage | import("../..").IInfoMessage | import("../..").IPauseMessage | import("../..").IPlaceholderMessage | import("../..").IReasoningMessage | import("../..").ISystemMessage | import("../..").ITemplateAssistantMessage | import("../..").ITemplateGuideMessage | import("../..").ITemplateHiddenMessage | import("../..").ITemplateSystemMessage | import("../..").ITemplateUserMessage | import("../..").IToolMessage | import("../..").IUserMessage | import("../..").IInterruptMessage>;
         modifyMessage: (data: import("../..").IMessage, config?: import("../fetch").IRequestConfig) => Promise<import("../..").IActivityMessage | import("../..").IAssistantMessage | import("../..").IDeveloperMessage | import("../..").IGuideMessage | import("../..").IHiddenAssistantMessage | import("../..").IHiddenGuideMessage | import("../..").IHiddenMessage | import("../..").IHiddenSystemMessage | import("../..").IHiddenUserMessage | import("../..").IInfoMessage | import("../..").IPauseMessage | import("../..").IPlaceholderMessage | import("../..").IReasoningMessage | import("../..").ISystemMessage | import("../..").ITemplateAssistantMessage | import("../..").ITemplateGuideMessage | import("../..").ITemplateHiddenMessage | import("../..").ITemplateSystemMessage | import("../..").ITemplateUserMessage | import("../..").IToolMessage | import("../..").IUserMessage | import("../..").IInterruptMessage>;
         deleteMessage: (id: string, config?: import("../fetch").IRequestConfig) => Promise<import("../..").IMessage>;

package/dist/http/module/message.d.ts

@@ -19,7 +19,7 @@ export interface IShareMessagesResponse {
  * @returns message 相关 http 接口
  */
 export declare const useMessage: (fetchClient: FetchClient) => {
-    getMessages: (sessionCode: string, limit?: number, config?: IRequestConfig) => Promise<IMessage[]>;
+    getMessages: (sessionCode: string, limit?: number, config?: IRequestConfig, fuzzy?: string) => Promise<IMessage[]>;
     plusMessage: (data: IMessage, config?: IRequestConfig) => Promise<import("../../message/type").IActivityMessage | import("../../message/type").IAssistantMessage | import("../../message/type").IDeveloperMessage | import("../../message/type").IGuideMessage | import("../../message/type").IHiddenAssistantMessage | import("../../message/type").IHiddenGuideMessage | import("../../message/type").IHiddenMessage | import("../../message/type").IHiddenSystemMessage | import("../../message/type").IHiddenUserMessage | import("../../message/type").IInfoMessage | import("../../message/type").IPauseMessage | import("../../message/type").IPlaceholderMessage | import("../../message/type").IReasoningMessage | import("../../message/type").ISystemMessage | import("../../message/type").ITemplateAssistantMessage | import("../../message/type").ITemplateGuideMessage | import("../../message/type").ITemplateHiddenMessage | import("../../message/type").ITemplateSystemMessage | import("../../message/type").ITemplateUserMessage | import("../../message/type").IToolMessage | import("../../message/type").IUserMessage | import("../../message/type").IInterruptMessage>;
     modifyMessage: (data: IMessage, config?: IRequestConfig) => Promise<import("../../message/type").IActivityMessage | import("../../message/type").IAssistantMessage | import("../../message/type").IDeveloperMessage | import("../../message/type").IGuideMessage | import("../../message/type").IHiddenAssistantMessage | import("../../message/type").IHiddenGuideMessage | import("../../message/type").IHiddenMessage | import("../../message/type").IHiddenSystemMessage | import("../../message/type").IHiddenUserMessage | import("../../message/type").IInfoMessage | import("../../message/type").IPauseMessage | import("../../message/type").IPlaceholderMessage | import("../../message/type").IReasoningMessage | import("../../message/type").ISystemMessage | import("../../message/type").ITemplateAssistantMessage | import("../../message/type").ITemplateGuideMessage | import("../../message/type").ITemplateHiddenMessage | import("../../message/type").ITemplateSystemMessage | import("../../message/type").ITemplateUserMessage | import("../../message/type").IToolMessage | import("../../message/type").IUserMessage | import("../../message/type").IInterruptMessage>;
     deleteMessage: (id: string, config?: IRequestConfig) => Promise<IMessage>;

package/dist/http/module/message.ts.js

@@ -56,10 +56,11 @@ import { transferMessage2MessageApi, transferMessageApi2Message } from '../trans
  * @param fetchClient - 请求客户端
  * @returns message 相关 http 接口
  */ export const useMessage = (fetchClient)=>{
-    // 获取会话内容列表
-    const getMessages = (sessionCode, limit, config)=>fetchClient.get(`session_content/content/`, {
+    // 获取会话内容列表（fuzzy 置于末尾，避免影响既有 limit/config 调用）
+    const getMessages = (sessionCode, limit, config, fuzzy)=>fetchClient.get(`session_content/content/`, {
             session_code: sessionCode,
-            limit
+            limit,
+            fuzzy
         }, config).then((res)=>res.map(transferMessageApi2Message));
     // 新增会话内容
     const plusMessage = (data, config)=>fetchClient.post(`session_content/`, transferMessage2MessageApi(data), config).then(transferMessageApi2Message);

package/dist/index.d.ts

@@ -13380,7 +13380,7 @@ export declare const useChatHelper: (options: IUseChatHelperOptions) => {
             isResumeSession: (sessionCode: string, config?: import("./http").IRequestConfig) => Promise<boolean>;
         };
         message: {
-            getMessages: (sessionCode: string, limit?: number, config?: import("./http").IRequestConfig) => Promise<import("./message").IMessage[]>;
+            getMessages: (sessionCode: string, limit?: number, config?: import("./http").IRequestConfig, fuzzy?: string) => Promise<import("./message").IMessage[]>;
             plusMessage: (data: import("./message").IMessage, config?: import("./http").IRequestConfig) => Promise<import("./message").IActivityMessage | import("./message").IAssistantMessage | import("./message").IDeveloperMessage | import("./message").IGuideMessage | import("./message").IHiddenAssistantMessage | import("./message").IHiddenGuideMessage | import("./message").IHiddenMessage | import("./message").IHiddenSystemMessage | import("./message").IHiddenUserMessage | import("./message").IInfoMessage | import("./message").IPauseMessage | import("./message").IPlaceholderMessage | import("./message").IReasoningMessage | import("./message").ISystemMessage | import("./message").ITemplateAssistantMessage | import("./message").ITemplateGuideMessage | import("./message").ITemplateHiddenMessage | import("./message").ITemplateSystemMessage | import("./message").ITemplateUserMessage | import("./message").IToolMessage | import("./message").IUserMessage | import("./message").IInterruptMessage>;
             modifyMessage: (data: import("./message").IMessage, config?: import("./http").IRequestConfig) => Promise<import("./message").IActivityMessage | import("./message").IAssistantMessage | import("./message").IDeveloperMessage | import("./message").IGuideMessage | import("./message").IHiddenAssistantMessage | import("./message").IHiddenGuideMessage | import("./message").IHiddenMessage | import("./message").IHiddenSystemMessage | import("./message").IHiddenUserMessage | import("./message").IInfoMessage | import("./message").IPauseMessage | import("./message").IPlaceholderMessage | import("./message").IReasoningMessage | import("./message").ISystemMessage | import("./message").ITemplateAssistantMessage | import("./message").ITemplateGuideMessage | import("./message").ITemplateHiddenMessage | import("./message").ITemplateSystemMessage | import("./message").ITemplateUserMessage | import("./message").IToolMessage | import("./message").IUserMessage | import("./message").IInterruptMessage>;
             deleteMessage: (id: string, config?: import("./http").IRequestConfig) => Promise<import("./message").IMessage>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blueking/chat-helper",
-  "version": "0.0.12-beta.18",
+  "version": "0.0.12-beta.19",
   "description": "",
   "main": "./dist/index.ts.js",
   "types": "./dist/index.d.ts",