@blueking/chat-helper 0.0.12-beta.28 → 0.0.12-beta.29

package/dist/agent/type.d.ts

@@ -199,3 +199,9 @@ export interface ILlmItemApi {
     tag_names?: string[];
     user_auth_mode?: string;
 }
+/**
+ * chat_completion execute_kwargs.stream_mode
+ * - start: 可创建生产者，开新一轮执行（默认）
+ * - attach: 仅接管/回放已有流，不允许新建生产者
+ */
+export type StreamMode = 'start' | 'attach';

package/dist/agent/type.ts.js

@@ -22,4 +22,8 @@
  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF
  * CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
  * IN THE SOFTWARE.
- */ /** 后端 llms/ 原始响应项（字段可能缺省） */ export { };
+ */ /**
+ * chat_completion execute_kwargs.stream_mode
+ * - start: 可创建生产者，开新一轮执行（默认）
+ * - attach: 仅接管/回放已有流，不允许新建生产者
+ */ export { };

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

@@ -3,7 +3,7 @@ import { MessageRole, MessageStatus, UserOperation } from '../message';
 import type { IRequestConfig, ISSEProtocol } from '../http';
 import type { IMediatorModule } from '../mediator';
 import type { IMessageProperty, IUserMessage, IUserOperationPayload } from '../message/type';
-import type { IAgentInfo, ILlmItem, ILlmListQuery } from './type';
+import type { IAgentInfo, ILlmItem, ILlmListQuery, StreamMode } from './type';
 /**
  * Agent 模块
  * @param options - 配置选项
@@ -2099,7 +2099,7 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
     pollResumeSession: (sessionCode: string, model?: string) => void;
     clearLongPollTimer: () => void;
     userOperationStreamRequest: (sessionCode: string, operation: UserOperation, payload: IUserOperationPayload, config?: IRequestConfig, model?: string) => Promise<void>;
-    streamRequest: ({ sessionCode, model, url, config, resume, input, lastMessageId, isReconnect, }: {
+    streamRequest: ({ sessionCode, model, url, config, resume, input, lastMessageId, isReconnect, streamMode, }: {
         sessionCode: string;
         model?: string;
         url?: string;
@@ -2109,6 +2109,7 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
         lastMessageId?: string;
         /** 内部静默重连，不重置重连计数 */
         isReconnect?: boolean;
+        streamMode?: StreamMode;
     }) => Promise<void>;
 };
 export type IAgentModule = ReturnType<typeof useAgent>;

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

@@ -111,14 +111,18 @@ import { SessionStatus } from '../session/type.ts.js';
 const RECONNECT_BASE_DELAY_MS = 1000;
 const RECONNECT_MAX_DELAY_MS = 8000;
 const getReconnectDelayMs = (attempt)=>Math.min(RECONNECT_BASE_DELAY_MS * Math.pow(2, attempt - 1), RECONNECT_MAX_DELAY_MS);
+/** 后端 attach_only 且无可接管流时抛出（见 StreamAttachUnavailableError） */ const isStreamAttachUnavailableError = (error)=>/No active or replayable stream/i.test(error.message);
 /**
  * 判断流式错误是否可静默重连。
- * 不重试：Abort、401/403 等业务 4xx（408/429 除外）；可重试：网络错误、5xx、无状态码的中断。
+ * 不重试：Abort、attach 无流、401/403 等业务 4xx（408/429 除外）；可重试：网络错误、5xx、无状态码的中断。
  */ const isRecoverableStreamError = (error)=>{
     var _requestError_response;
     if (error.name === 'AbortError') {
         return false;
     }
+    if (isStreamAttachUnavailableError(error)) {
+        return false;
+    }
     const requestError = error;
     const statusFromResponse = (_requestError_response = requestError.response) === null || _requestError_response === void 0 ? void 0 : _requestError_response.status;
     const statusFromMessage = error.message.match(/status code (\d+)/i);
@@ -318,7 +322,8 @@ const getReconnectDelayMs = (attempt)=>Math.min(RECONNECT_BASE_DELAY_MS * Math.p
                 url: ctx === null || ctx === void 0 ? void 0 : ctx.url,
                 config: ctx === null || ctx === void 0 ? void 0 : ctx.config,
                 lastMessageId: lastMessageId !== undefined ? String(lastMessageId) : undefined,
-                isReconnect: true
+                isReconnect: true,
+                /** 静默重连：仅接管已有流，禁止后端新建 producer */ streamMode: 'attach'
             });
             return 'reconnected';
         });
@@ -327,16 +332,17 @@ 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 }) {
+        var _ref = _async_to_generator(function*({ sessionCode, model, url, config, resume, input, lastMessageId, isReconnect = false, /** start 可启动新一轮执行；attach 仅接管/回放已有流 */ streamMode = 'start' }) {
             var _previousController_abort, _mediator_http;
             if (!isReconnect) {
                 resetStreamReconnectState();
             }
             activeStreamContext = {
                 sessionCode,
-                model: model,
+                model,
                 url,
-                config
+                config,
+                streamMode
             };
             // 先递增世代再 abort 旧连接，避免旧流 onDone 误触发二次重连
             const streamId = ++activeStreamId;
@@ -426,6 +432,31 @@ const getReconnectDelayMs = (attempt)=>Math.min(RECONNECT_BASE_DELAY_MS * Math.p
                 if (!isActiveStream() || manualAbort) {
                     return;
                 }
+                // attach 时后端无可接管流：视为本轮已结束，勿静默重连空转
+                if (streamMode === 'attach' && isStreamAttachUnavailableError(error)) {
+                    var _mediator_session;
+                    const settleAttachUnavailable = ()=>{
+                        var _mediator_session_current_value, _mediator_session;
+                        if (!isActiveStream() || manualAbort || !isSameActiveSession(sessionCode)) {
+                            if (isActiveStream()) {
+                                isChatting.value = false;
+                            }
+                            return;
+                        }
+                        if (((_mediator_session = mediator.session) === null || _mediator_session === 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.status) !== SessionStatus.Running) {
+                            finishSuccessfully();
+                            return;
+                        }
+                        isChatting.value = false;
+                    };
+                    const refresh = (_mediator_session = mediator.session) === null || _mediator_session === void 0 ? void 0 : _mediator_session.getSession(sessionCode);
+                    if (refresh) {
+                        void refresh.catch(()=>undefined).then(settleAttachUnavailable);
+                    } else {
+                        settleAttachUnavailable();
+                    }
+                    return;
+                }
                 if (!isRecoverableStreamError(error)) {
                     failWithError(error);
                     return;
@@ -479,6 +510,7 @@ const getReconnectDelayMs = (attempt)=>Math.min(RECONNECT_BASE_DELAY_MS * Math.p
                     input,
                     execute_kwargs: {
                         stream: true,
+                        stream_mode: streamMode,
                         persist_input: !!input,
                         last_message_id: lastMessageId,
                         resume
@@ -547,7 +579,8 @@ const getReconnectDelayMs = (attempt)=>Math.min(RECONNECT_BASE_DELAY_MS * Math.p
                 model,
                 url,
                 config,
-                lastMessageId
+                lastMessageId,
+                /** 切会话/刷新恢复：仅接管已有流 */ streamMode: 'attach'
             });
         }
     };

package/dist/index.d.ts

@@ -2101,7 +2101,7 @@ export declare const useChatHelper: (options: IUseChatHelperOptions) => {
         pollResumeSession: (sessionCode: string, model?: string) => void;
         clearLongPollTimer: () => void;
         userOperationStreamRequest: (sessionCode: string, operation: import("./message").UserOperation, payload: import("./message").IUserOperationPayload, config?: import("./http").IRequestConfig, model?: string) => Promise<void>;
-        streamRequest: ({ sessionCode, model, url, config, resume, input, lastMessageId, isReconnect, }: {
+        streamRequest: ({ sessionCode, model, url, config, resume, input, lastMessageId, isReconnect, streamMode, }: {
             sessionCode: string;
             model?: string;
             url?: string;
@@ -2110,6 +2110,7 @@ export declare const useChatHelper: (options: IUseChatHelperOptions) => {
             input?: string;
             lastMessageId?: string;
             isReconnect?: boolean;
+            streamMode?: import("./agent").StreamMode;
         }) => Promise<void>;
     };
     session: {

package/package.json

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