@blueking/chat-helper 3.1.0-beta.2 → 3.1.0-beta.4

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

@@ -167,6 +167,7 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
                     function: {
                         arguments: string;
                         description?: string;
+                        function_type?: import("../message").FunctionCallType;
                         mcpName?: string;
                         name: string;
                     };
@@ -1185,6 +1186,7 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
                     function: {
                         arguments: string;
                         description?: string;
+                        function_type?: import("../message").FunctionCallType;
                         mcpName?: string;
                         name: string;
                     };
@@ -2106,7 +2108,7 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
     resendMessage: (messageId: string, sessionCode: string, newContent?: IUserMessage["content"], url?: string, config?: IRequestConfig, model?: string) => Promise<void>;
     resumeStreamingChat: (sessionCode: string, url?: string, config?: IRequestConfig, model?: string) => void;
     abortChat: () => void;
-    stopChat: (sessionCode: string) => Promise<void>;
+    stopChat: (sessionCode: string) => Promise<unknown>;
     getAgentInfo: () => Promise<void>;
     getLlms: (params?: ILlmListQuery, config?: IRequestConfig) => Promise<ILlmItem[]>;
     reset: (protocol: ISSEProtocol) => void;

package/dist/agent/use-agent.spec.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -158,6 +158,9 @@ const getReconnectDelayMs = (attempt)=>Math.min(RECONNECT_BASE_DELAY_MS * Math.p
     /** 当前轮次已静默重连次数 */ let reconnectAttempt = 0;
     /** 本轮流是否已收到 RUN_FINISHED */ let runFinished = false;
     /** 流世代号：新开流时递增，用于忽略已被替换的旧 SSE 回调 */ let activeStreamId = 0;
+    /** 尚未结束的那条流的世代号；仅当它仍等于 activeStreamId 时才可被 stopChat 封口 */ let openStreamId = null;
+    /** 正在进行中的停止请求；同会话下一轮 start 需等它落定后再开新 producer */ let pendingStop = null;
+    /** 正在排队等 pendingStop 的 start（尚未发出请求）；被 stopChat / abortChat / 新的排队 start 替换即作废 */ let queuedStart = null;
     let reconnectTimer = null;
     let reconnectWaitResolve = null;
     let activeStreamContext = null;
@@ -272,6 +275,21 @@ const getReconnectDelayMs = (attempt)=>Math.min(RECONNECT_BASE_DELAY_MS * Math.p
         var _mediator_session_current_value, _mediator_session_current, _mediator_session;
         return sessionCode === ((_mediator_session = mediator.session) === null || _mediator_session === void 0 ? void 0 : (_mediator_session_current = _mediator_session.current) === null || _mediator_session_current === void 0 ? void 0 : (_mediator_session_current_value = _mediator_session_current.value) === null || _mediator_session_current_value === void 0 ? void 0 : _mediator_session_current_value.sessionCode);
     };
+    /** 仅为最后一条用户消息回填后端 id（input 型流的乐观消息用），不整表替换列表 */ const backfillLastUserMessageId = (sessionCode)=>{
+        var _mediator_http_message, _mediator_http;
+        const request = (_mediator_http = mediator.http) === null || _mediator_http === void 0 ? void 0 : (_mediator_http_message = _mediator_http.message) === null || _mediator_http_message === void 0 ? void 0 : _mediator_http_message.getMessages(sessionCode);
+        if (!request) {
+            return;
+        }
+        void request.then((res)=>{
+            var _mediator_message;
+            const lastUserMessage = (_mediator_message = mediator.message) === null || _mediator_message === void 0 ? void 0 : _mediator_message.list.value.findLast((item)=>item.role === MessageRole.User);
+            const lastApiUserMessage = res.findLast((item)=>item.role === MessageRole.User);
+            if (lastUserMessage && lastApiUserMessage) {
+                lastUserMessage.id = lastApiUserMessage.id;
+            }
+        }).catch(()=>undefined);
+    };
     /**
    * 尝试静默重连。
    * @param streamId - 发起重连的流世代；任一 await 后若已被新流/abort 取代则立即退出，避免 abort 掉更新流
@@ -334,6 +352,27 @@ const getReconnectDelayMs = (attempt)=>Math.min(RECONNECT_BASE_DELAY_MS * Math.p
     const streamRequest = function() {
         var _ref = _async_to_generator(function*({ sessionCode, model, url, config, resume, input, lastMessageId, isReconnect = false, /** start 可启动新一轮执行；attach 仅接管/回放已有流 */ streamMode = 'start' }) {
             var _previousController_abort, _mediator_http;
+            // 同会话新一轮 start 必须等在途 stop 落定，避免新 producer 在取消标记生效前启动。
+            // attach（切会话/静默重连）不等待。
+            if (streamMode === 'start' && (pendingStop === null || pendingStop === void 0 ? void 0 : pendingStop.sessionCode) === sessionCode) {
+                const ticket = {
+                    sessionCode
+                };
+                queuedStart = ticket;
+                // 等待期间保持生成态，界面仍展示停止按钮、禁止再次发送
+                isChatting.value = true;
+                yield pendingStop.promise.catch(()=>undefined);
+                const stillQueued = queuedStart === ticket;
+                if (stillQueued) {
+                    queuedStart = null;
+                }
+                if (!stillQueued || !isSameActiveSession(sessionCode)) {
+                    if (stillQueued) {
+                        isChatting.value = false;
+                    }
+                    return;
+                }
+            }
             if (!isReconnect) {
                 resetStreamReconnectState();
             }
@@ -342,14 +381,21 @@ const getReconnectDelayMs = (attempt)=>Math.min(RECONNECT_BASE_DELAY_MS * Math.p
                 model,
                 url,
                 config,
-                streamMode
+                streamMode,
+                input
             };
             // 先递增世代再 abort 旧连接，避免旧流 onDone 误触发二次重连
             const streamId = ++activeStreamId;
+            openStreamId = streamId;
             const previousController = chatAbortController;
             chatAbortController = new AbortController();
             previousController === null || previousController === void 0 ? void 0 : (_previousController_abort = previousController.abort) === null || _previousController_abort === void 0 ? void 0 : _previousController_abort.call(previousController);
             const isActiveStream = ()=>streamId === activeStreamId;
+            const closeOpenStream = ()=>{
+                if (openStreamId === streamId) {
+                    openStreamId = null;
+                }
+            };
             // ag-ui 协议需要注入消息模块
             if (usedProtocol instanceof AGUIProtocol) {
                 usedProtocol.injectMessageModule(mediator.message);
@@ -369,19 +415,11 @@ const getReconnectDelayMs = (attempt)=>Math.min(RECONNECT_BASE_DELAY_MS * Math.p
                 if (!isActiveStream()) {
                     return;
                 }
+                closeOpenStream();
                 isChatting.value = false;
                 (_usedProtocol_onDone = usedProtocol.onDone) === null || _usedProtocol_onDone === void 0 ? void 0 : _usedProtocol_onDone.call(usedProtocol);
                 if (input) {
-                    var // 刷新列表，获取前端 mock message 的 id，并更新到列表中
-                    _mediator_http_message, _mediator_http;
-                    (_mediator_http = mediator.http) === null || _mediator_http === void 0 ? void 0 : (_mediator_http_message = _mediator_http.message) === null || _mediator_http_message === void 0 ? void 0 : _mediator_http_message.getMessages(sessionCode).then((res)=>{
-                        var _mediator_message;
-                        const lastUserMessage = (_mediator_message = mediator.message) === null || _mediator_message === void 0 ? void 0 : _mediator_message.list.value.findLast((item)=>item.role === MessageRole.User);
-                        const lastApiUserMessage = res.findLast((item)=>item.role === MessageRole.User);
-                        if (lastUserMessage && lastApiUserMessage) {
-                            lastUserMessage.id = lastApiUserMessage.id;
-                        }
-                    });
+                    backfillLastUserMessageId(sessionCode);
                 }
                 // 轮询接口，判断是否可以继续聊天
                 pollResumeSession(sessionCode);
@@ -391,6 +429,7 @@ const getReconnectDelayMs = (attempt)=>Math.min(RECONNECT_BASE_DELAY_MS * Math.p
                 if (!isActiveStream()) {
                     return;
                 }
+                closeOpenStream();
                 isChatting.value = false;
                 (_usedProtocol_onError = usedProtocol.onError) === null || _usedProtocol_onError === void 0 ? void 0 : _usedProtocol_onError.call(usedProtocol, error);
             };
@@ -422,6 +461,7 @@ const getReconnectDelayMs = (attempt)=>Math.min(RECONNECT_BASE_DELAY_MS * Math.p
                     }
                     // abort / 切会话导致的失败：静默结束，不展示错误气泡
                     if (manualAbort || !isSameActiveSession(sessionCode)) {
+                        closeOpenStream();
                         isChatting.value = false;
                         return;
                     }
@@ -439,6 +479,7 @@ const getReconnectDelayMs = (attempt)=>Math.min(RECONNECT_BASE_DELAY_MS * Math.p
                         var _mediator_session_current_value, _mediator_session;
                         if (!isActiveStream() || manualAbort || !isSameActiveSession(sessionCode)) {
                             if (isActiveStream()) {
+                                closeOpenStream();
                                 isChatting.value = false;
                             }
                             return;
@@ -447,6 +488,7 @@ const getReconnectDelayMs = (attempt)=>Math.min(RECONNECT_BASE_DELAY_MS * Math.p
                             finishSuccessfully();
                             return;
                         }
+                        closeOpenStream();
                         isChatting.value = false;
                     };
                     const refresh = (_mediator_session = mediator.session) === null || _mediator_session === void 0 ? void 0 : _mediator_session.getSession(sessionCode);
@@ -473,6 +515,7 @@ const getReconnectDelayMs = (attempt)=>Math.min(RECONNECT_BASE_DELAY_MS * Math.p
                         return;
                     }
                     if (manualAbort || !isSameActiveSession(sessionCode)) {
+                        closeOpenStream();
                         isChatting.value = false;
                         return;
                     }
@@ -640,6 +683,34 @@ const getReconnectDelayMs = (attempt)=>Math.min(RECONNECT_BASE_DELAY_MS * Math.p
         resumeAbortController = null;
     };
     /**
+   * 按流世代封口（用户主动停止时同步执行）。
+   * 使当前流世代失效，后续 SSE 事件不再进入协议层；但不断开连接，
+   * 让后端在原连接上完成取消收尾。无可封流时（已结束 / 已 abort）不做任何事。
+   * @returns 是否实际封住了一条流
+   */ const sealOpenStream = (sessionCode)=>{
+        var _mediator_message_settleStoppedTurn, _mediator_message, // 本轮唯一的 receive-end 出口；真实关流的 onDone 已因世代失效不会再触发
+        _usedProtocol_onDone;
+        if (openStreamId === null || openStreamId !== activeStreamId) {
+            return false;
+        }
+        if ((activeStreamContext === null || activeStreamContext === void 0 ? void 0 : activeStreamContext.sessionCode) !== sessionCode) {
+            return false;
+        }
+        const sealedInput = activeStreamContext.input;
+        (_mediator_message = mediator.message) === null || _mediator_message === void 0 ? void 0 : (_mediator_message_settleStoppedTurn = _mediator_message.settleStoppedTurn) === null || _mediator_message_settleStoppedTurn === void 0 ? void 0 : _mediator_message_settleStoppedTurn.call(_mediator_message, sessionCode);
+        if (sealedInput) {
+            backfillLastUserMessageId(sessionCode);
+        }
+        isChatting.value = false;
+        clearReconnectTimer(false);
+        clearLongPollTimer();
+        // 先失效世代：此后该连接的 onMessage/onDone/onError 与重连尝试都会直接返回
+        activeStreamId += 1;
+        openStreamId = null;
+        (_usedProtocol_onDone = usedProtocol.onDone) === null || _usedProtocol_onDone === void 0 ? void 0 : _usedProtocol_onDone.call(usedProtocol);
+        return true;
+    };
+    /**
    * 中止聊天（纯前端中止，后端继续处理）
    * 会使当前流世代失效，避免 abort 后的 onDone 误触发 finishSuccessfully / pollResumeSession
    */ const abortChat = ()=>{
@@ -647,6 +718,9 @@ const getReconnectDelayMs = (attempt)=>Math.min(RECONNECT_BASE_DELAY_MS * Math.p
         manualAbort = true;
         // 先失效世代，再 abort：FetchClient 同步触发的 onDone 会因 isActiveStream=false 直接返回
         activeStreamId += 1;
+        openStreamId = null;
+        pendingStop = null;
+        queuedStart = null;
         clearReconnectTimer(false);
         clearLongPollTimer();
         isChatting.value = false;
@@ -654,12 +728,44 @@ const getReconnectDelayMs = (attempt)=>Math.min(RECONNECT_BASE_DELAY_MS * Math.p
         chatAbortController = null;
     };
     /**
-   * 停止会话，后端中止
+   * 取消排队中的 start：它尚未发到后端，本地结算即可，无需再发停止请求
+   * @returns 是否实际取消了排队的 start
+   */ const cancelQueuedStart = (sessionCode)=>{
+        var _mediator_message_settleStoppedTurn, _mediator_message;
+        if ((queuedStart === null || queuedStart === void 0 ? void 0 : queuedStart.sessionCode) !== sessionCode) {
+            return false;
+        }
+        queuedStart = null;
+        isChatting.value = false;
+        (_mediator_message = mediator.message) === null || _mediator_message === void 0 ? void 0 : (_mediator_message_settleStoppedTurn = _mediator_message.settleStoppedTurn) === null || _mediator_message_settleStoppedTurn === void 0 ? void 0 : _mediator_message_settleStoppedTurn.call(_mediator_message, sessionCode);
+        return true;
+    };
+    /**
+   * 停止会话，后端中止。
+   * 发请求前先同步封口，界面立即停止接受本轮流；请求记为 pendingStop，
+   * 同会话下一轮 start 会等它落定。失败仍 reject，且不解除封口。
+   * 若同会话有排队等待中的 start，只取消该 start 并等上一轮停止请求落定（其失败由上一轮调用方处理）。
    * @param sessionCode - 会话代码
    */ const stopChat = function() {
         var _ref = _async_to_generator(function*(sessionCode) {
-            var _mediator_http_message;
-            return (_mediator_http_message = mediator.http.message) === null || _mediator_http_message === void 0 ? void 0 : _mediator_http_message.stopChat(sessionCode);
+            var _mediator_http_message, _mediator_http;
+            if (cancelQueuedStart(sessionCode)) {
+                return pendingStop === null || pendingStop === void 0 ? void 0 : pendingStop.promise.catch(()=>undefined);
+            }
+            sealOpenStream(sessionCode);
+            const promise = Promise.resolve((_mediator_http = mediator.http) === null || _mediator_http === void 0 ? void 0 : (_mediator_http_message = _mediator_http.message) === null || _mediator_http_message === void 0 ? void 0 : _mediator_http_message.stopChat(sessionCode));
+            const record = {
+                sessionCode,
+                promise
+            };
+            pendingStop = record;
+            try {
+                return yield promise;
+            } finally{
+                if (pendingStop === record) {
+                    pendingStop = null;
+                }
+            }
         });
         return function stopChat(sessionCode) {
             return _ref.apply(this, arguments);

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

@@ -511,7 +511,8 @@ import { transferMessageApi2Message } from '../http/transform/index.ts.js';
                         mcpName: event.mcpName,
                         name: event.toolCallName,
                         arguments: '',
-                        description: event.description
+                        description: event.description,
+                        function_type: event.function_type
                     }
                 }
             ]

package/dist/event/type.d.ts

@@ -1,4 +1,4 @@
-import { type IMessageApi, type IMessageArtifact, type MessageRole, type MessageStatus } from '../message/type';
+import { type FunctionCallType, type IMessageApi, type IMessageArtifact, type MessageRole, type MessageStatus } from '../message/type';
 import type { JSONSchema4 } from 'json-schema';
 export declare enum CustomEventName {
     ArtifactsGenerated = "artifacts_generated",
@@ -392,6 +392,7 @@ export interface IToolCallResultEvent extends IBaseEvent {
 }
 export interface IToolCallStartEvent extends IBaseEvent {
     description?: string;
+    function_type?: FunctionCallType;
     mcpName?: string;
     parentMessageId?: string;
     toolCallId: string;

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

@@ -143,6 +143,7 @@ import { ActivityType, MessageRole, MessageType, resolveMessageCreatedAt } from
                                 arguments: toolCall['function'].arguments,
                                 name: toolCall['function'].name,
                                 description: toolCall['function'].description,
+                                function_type: toolCall['function'].function_type,
                                 mcpName: toolCall['function'].mcp_name
                             },
                             id: toolCall.id,
@@ -419,6 +420,7 @@ import { ActivityType, MessageRole, MessageType, resolveMessageCreatedAt } from
                                 arguments: toolCall['function'].arguments,
                                 name: toolCall['function'].name,
                                 description: toolCall['function'].description,
+                                function_type: toolCall['function'].function_type,
                                 mcp_name: toolCall['function'].mcpName
                             },
                             id: toolCall.id,

package/dist/index.d.ts

@@ -169,6 +169,7 @@ export declare const useChatHelper: (options: IUseChatHelperOptions) => {
                         function: {
                             arguments: string;
                             description?: string;
+                            function_type?: import("./message").FunctionCallType;
                             mcpName?: string;
                             name: string;
                         };
@@ -1187,6 +1188,7 @@ export declare const useChatHelper: (options: IUseChatHelperOptions) => {
                         function: {
                             arguments: string;
                             description?: string;
+                            function_type?: import("./message").FunctionCallType;
                             mcpName?: string;
                             name: string;
                         };
@@ -2108,7 +2110,7 @@ export declare const useChatHelper: (options: IUseChatHelperOptions) => {
         resendMessage: (messageId: string, sessionCode: string, newContent?: import("./message").IUserMessage["content"], url?: string, config?: import("./http").IRequestConfig, model?: string) => Promise<void>;
         resumeStreamingChat: (sessionCode: string, url?: string, config?: import("./http").IRequestConfig, model?: string) => void;
         abortChat: () => void;
-        stopChat: (sessionCode: string) => Promise<void>;
+        stopChat: (sessionCode: string) => Promise<unknown>;
         getAgentInfo: () => Promise<void>;
         getLlms: (params?: import("./agent").ILlmListQuery, config?: import("./http").IRequestConfig) => Promise<import("./agent").ILlmItem[]>;
         reset: (protocol: import("./http").ISSEProtocol) => void;
@@ -2241,6 +2243,7 @@ export declare const useChatHelper: (options: IUseChatHelperOptions) => {
                         function: {
                             arguments: string;
                             description?: string;
+                            function_type?: import("./message").FunctionCallType;
                             mcpName?: string;
                             name: string;
                         };
@@ -3197,6 +3200,7 @@ export declare const useChatHelper: (options: IUseChatHelperOptions) => {
                             function: {
                                 arguments: string;
                                 description?: string;
+                                function_type?: import("./message").FunctionCallType;
                                 mcpName?: string;
                                 name: string;
                             };
@@ -4174,6 +4178,7 @@ export declare const useChatHelper: (options: IUseChatHelperOptions) => {
                         function: {
                             arguments: string;
                             description?: string;
+                            function_type?: import("./message").FunctionCallType;
                             mcpName?: string;
                             name: string;
                         };
@@ -5130,6 +5135,7 @@ export declare const useChatHelper: (options: IUseChatHelperOptions) => {
                             function: {
                                 arguments: string;
                                 description?: string;
+                                function_type?: import("./message").FunctionCallType;
                                 mcpName?: string;
                                 name: string;
                             };
@@ -6108,6 +6114,7 @@ export declare const useChatHelper: (options: IUseChatHelperOptions) => {
                         function: {
                             arguments: string;
                             description?: string;
+                            function_type?: import("./message").FunctionCallType;
                             mcpName?: string;
                             name: string;
                         };
@@ -7064,6 +7071,7 @@ export declare const useChatHelper: (options: IUseChatHelperOptions) => {
                             function: {
                                 arguments: string;
                                 description?: string;
+                                function_type?: import("./message").FunctionCallType;
                                 mcpName?: string;
                                 name: string;
                             };
@@ -8041,6 +8049,7 @@ export declare const useChatHelper: (options: IUseChatHelperOptions) => {
                         function: {
                             arguments: string;
                             description?: string;
+                            function_type?: import("./message").FunctionCallType;
                             mcpName?: string;
                             name: string;
                         };
@@ -8997,6 +9006,7 @@ export declare const useChatHelper: (options: IUseChatHelperOptions) => {
                             function: {
                                 arguments: string;
                                 description?: string;
+                                function_type?: import("./message").FunctionCallType;
                                 mcpName?: string;
                                 name: string;
                             };
@@ -9998,6 +10008,7 @@ export declare const useChatHelper: (options: IUseChatHelperOptions) => {
                 function: {
                     arguments: string;
                     description?: string;
+                    function_type?: import("./message").FunctionCallType;
                     mcpName?: string;
                     name: string;
                 };
@@ -10951,6 +10962,7 @@ export declare const useChatHelper: (options: IUseChatHelperOptions) => {
                 function: {
                     arguments: string;
                     description?: string;
+                    function_type?: import("./message").FunctionCallType;
                     mcpName?: string;
                     name: string;
                 };
@@ -11909,6 +11921,7 @@ export declare const useChatHelper: (options: IUseChatHelperOptions) => {
                 function: {
                     arguments: string;
                     description?: string;
+                    function_type?: import("./message").FunctionCallType;
                     mcpName?: string;
                     name: string;
                 };
@@ -12766,6 +12779,7 @@ export declare const useChatHelper: (options: IUseChatHelperOptions) => {
             sessionCode?: string;
             status: import("./message").MessageStatus;
         };
+        settleStoppedTurn: (sessionCode?: string) => void;
         getMessageByMessageId: (id: string) => {
             activityType: import("./message").ActivityType;
             content: {
@@ -12863,6 +12877,7 @@ export declare const useChatHelper: (options: IUseChatHelperOptions) => {
                 function: {
                     arguments: string;
                     description?: string;
+                    function_type?: import("./message").FunctionCallType;
                     mcpName?: string;
                     name: string;
                 };

package/dist/message/type.d.ts

@@ -43,6 +43,12 @@ export declare enum MessageType {
     Function = "function",
     Text = "text"
 }
+export declare enum FunctionCallType {
+    Function = "function",
+    Mcp = "mcp",
+    Skill = "skill",
+    Subagent = "subagent"
+}
 export declare enum UserOperation {
     FlowNodeRetry = "flow_node_retry",
     FlowNodeSkip = "flow_node_skip",
@@ -193,12 +199,14 @@ export interface IFlowAgentTaskNodeInfo {
 export interface IFunctionCall {
     arguments: string;
     description?: string;
+    function_type?: FunctionCallType;
     mcpName?: string;
     name: string;
 }
 export interface IFunctionCallApi {
     arguments: string;
     description?: string;
+    function_type?: FunctionCallType;
     mcp_name?: string;
     name: string;
 }

package/dist/message/type.ts.js

@@ -70,6 +70,13 @@ export var MessageType;
     MessageType["Function"] = "function";
     MessageType["Text"] = "text";
 })(MessageType || (MessageType = {}));
+export var FunctionCallType;
+(function(FunctionCallType) {
+    FunctionCallType["Function"] = "function";
+    FunctionCallType["Mcp"] = "mcp";
+    FunctionCallType["Skill"] = "skill";
+    FunctionCallType["Subagent"] = "subagent";
+})(FunctionCallType || (FunctionCallType = {}));
 export var UserOperation;
 (function(UserOperation) {
     UserOperation["FlowNodeRetry"] = "flow_node_retry";

package/dist/message/use-message.d.ts

@@ -103,6 +103,7 @@ export declare const useMessage: (mediator: IMediatorModule) => {
             function: {
                 arguments: string;
                 description?: string;
+                function_type?: import("./type").FunctionCallType;
                 mcpName?: string;
                 name: string;
             };
@@ -1056,6 +1057,7 @@ export declare const useMessage: (mediator: IMediatorModule) => {
             function: {
                 arguments: string;
                 description?: string;
+                function_type?: import("./type").FunctionCallType;
                 mcpName?: string;
                 name: string;
             };
@@ -2014,6 +2016,7 @@ export declare const useMessage: (mediator: IMediatorModule) => {
             function: {
                 arguments: string;
                 description?: string;
+                function_type?: import("./type").FunctionCallType;
                 mcpName?: string;
                 name: string;
             };
@@ -2871,6 +2874,7 @@ export declare const useMessage: (mediator: IMediatorModule) => {
         sessionCode?: string;
         status: MessageStatus;
     };
+    settleStoppedTurn: (sessionCode?: string) => void;
     getMessageByMessageId: (id: string) => {
         activityType: import("./type").ActivityType;
         content: {
@@ -2968,6 +2972,7 @@ export declare const useMessage: (mediator: IMediatorModule) => {
             function: {
                 arguments: string;
                 description?: string;
+                function_type?: import("./type").FunctionCallType;
                 mcpName?: string;
                 name: string;
             };

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

@@ -142,6 +142,38 @@ import { MessageRole, MessageStatus } from './type.ts.js';
                 MessageStatus.Streaming
             ].includes(item.status));
     };
+    /**
+   * 用户停止时把本轮尾段消息收成终态。
+   * 范围：最后一条 User 之后，跳过 Interrupt（中断卡片本身为 Pending，等待用户处理）。
+   * 尾段没有助手正文（仅有思考 / 工具调用，或完全为空）时补一条「用户已取消」（status=error），
+   * 与后端取消回写规则一致：后端仅在无助手文本输出时补写该条，刷新前后条目相同。
+   */ const settleStoppedTurn = (sessionCode)=>{
+        const messages = list.value;
+        let lastUserIndex = -1;
+        messages.forEach((item, index)=>{
+            if (item.role === MessageRole.User) {
+                lastUserIndex = index;
+            }
+        });
+        const tail = messages.slice(lastUserIndex + 1);
+        const nonInterruptTail = tail.filter((item)=>item.role !== MessageRole.Interrupt);
+        nonInterruptTail.forEach((item)=>{
+            if (item.status === MessageStatus.Streaming || item.status === MessageStatus.Pending) {
+                item.status = MessageStatus.Stop;
+            }
+        });
+        const hasAssistantText = nonInterruptTail.some((item)=>item.role === MessageRole.Assistant && typeof item.content === 'string' && item.content.trim() !== '');
+        if (!hasAssistantText) {
+            const cancelledMessage = _object_spread({
+                role: MessageRole.Assistant,
+                content: '用户已取消',
+                status: MessageStatus.Error
+            }, sessionCode ? {
+                sessionCode
+            } : {});
+            list.value.push(cancelledMessage);
+        }
+    };
     const getMessageByMessageId = (id)=>{
         return list.value.find((item)=>item.messageId === id);
     };
@@ -278,6 +310,7 @@ import { MessageRole, MessageStatus } from './type.ts.js';
         getMessages,
         clearMessages,
         getCurrentLoadingMessage,
+        settleStoppedTurn,
         getMessageByMessageId,
         modifyMessage,
         plusMessage,

package/dist/session/use-session.d.ts

@@ -119,6 +119,7 @@ export declare const useSession: (mediator: IMediatorModule) => {
                     function: {
                         arguments: string;
                         description?: string;
+                        function_type?: import("..").FunctionCallType;
                         mcpName?: string;
                         name: string;
                     };
@@ -1075,6 +1076,7 @@ export declare const useSession: (mediator: IMediatorModule) => {
                         function: {
                             arguments: string;
                             description?: string;
+                            function_type?: import("..").FunctionCallType;
                             mcpName?: string;
                             name: string;
                         };
@@ -2052,6 +2054,7 @@ export declare const useSession: (mediator: IMediatorModule) => {
                     function: {
                         arguments: string;
                         description?: string;
+                        function_type?: import("..").FunctionCallType;
                         mcpName?: string;
                         name: string;
                     };
@@ -3008,6 +3011,7 @@ export declare const useSession: (mediator: IMediatorModule) => {
                         function: {
                             arguments: string;
                             description?: string;
+                            function_type?: import("..").FunctionCallType;
                             mcpName?: string;
                             name: string;
                         };
@@ -3986,6 +3990,7 @@ export declare const useSession: (mediator: IMediatorModule) => {
                     function: {
                         arguments: string;
                         description?: string;
+                        function_type?: import("..").FunctionCallType;
                         mcpName?: string;
                         name: string;
                     };
@@ -4942,6 +4947,7 @@ export declare const useSession: (mediator: IMediatorModule) => {
                         function: {
                             arguments: string;
                             description?: string;
+                            function_type?: import("..").FunctionCallType;
                             mcpName?: string;
                             name: string;
                         };
@@ -5919,6 +5925,7 @@ export declare const useSession: (mediator: IMediatorModule) => {
                     function: {
                         arguments: string;
                         description?: string;
+                        function_type?: import("..").FunctionCallType;
                         mcpName?: string;
                         name: string;
                     };
@@ -6875,6 +6882,7 @@ export declare const useSession: (mediator: IMediatorModule) => {
                         function: {
                             arguments: string;
                             description?: string;
+                            function_type?: import("..").FunctionCallType;
                             mcpName?: string;
                             name: string;
                         };

package/package.json

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