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

package/dist/agent/type.d.ts

@@ -58,6 +58,8 @@ export interface IAgentCommandComponentApi {
 }
 export interface IAgentInfo {
     agentName?: string;
+    /** Agent 类型：single 为普通智能体，claw 为 Claw 智能体 */
+    agentType?: 'claw' | 'single' | string;
     relatedSkills?: IRelatedSkill[];
     resources?: IAgentResourceItem[];
     saasUrl?: string;
@@ -79,6 +81,8 @@ export interface IAgentInfo {
 }
 export interface IAgentInfoApi {
     agent_name: string;
+    /** Agent 类型：single 为普通智能体，claw 为 Claw 智能体 */
+    agent_type?: 'claw' | 'single' | string;
     related_skills?: IRelatedSkillApi[];
     resources?: IAgentResourceItem[];
     saas_url?: string;
@@ -195,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 - 配置选项
@@ -12,6 +12,7 @@ import type { IAgentInfo, ILlmItem, ILlmListQuery } from './type';
 export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtocol) => {
     info: import("vue").Ref<{
         agentName?: string;
+        agentType?: "claw" | "single" | string;
         relatedSkills?: {
             description: string;
             icon: string;
@@ -1022,6 +1023,7 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
         };
     }, IAgentInfo | {
         agentName?: string;
+        agentType?: "claw" | "single" | string;
         relatedSkills?: {
             description: string;
             icon: string;
@@ -2097,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;
@@ -2107,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/http/transform/agent.spec.d.ts

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

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

@@ -63,6 +63,7 @@
             supportUpload: data.prompt_setting.support_upload
         } : undefined,
         agentName: data === null || data === void 0 ? void 0 : data.agent_name,
+        agentType: data === null || data === void 0 ? void 0 : data.agent_type,
         relatedSkills: data === null || data === void 0 ? void 0 : (_data_related_skills = data.related_skills) === null || _data_related_skills === void 0 ? void 0 : _data_related_skills.map((skill)=>({
                 id: skill.id,
                 skill_name: skill.skill_name,

package/dist/index.d.ts

@@ -14,6 +14,7 @@ export declare const useChatHelper: (options: IUseChatHelperOptions) => {
     agent: {
         info: import("vue").Ref<{
             agentName?: string;
+            agentType?: "claw" | "single" | string;
             relatedSkills?: {
                 description: string;
                 icon: string;
@@ -1024,6 +1025,7 @@ export declare const useChatHelper: (options: IUseChatHelperOptions) => {
             };
         }, import("./agent").IAgentInfo | {
             agentName?: string;
+            agentType?: "claw" | "single" | string;
             relatedSkills?: {
                 description: string;
                 icon: string;
@@ -2099,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;
@@ -2108,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.27",
+  "version": "0.0.12-beta.29",
   "description": "",
   "main": "./dist/index.ts.js",
   "types": "./dist/index.d.ts",
@@ -24,12 +24,14 @@
     "@blueking/cli-service": "0.1.0-beta.31",
     "eslint-plugin-simple-import-sort": "^10.0.0",
     "typescript": "^5.5.4",
+    "vitest": "^4.0.18",
     "vue-tsc": "^3.1.4"
   },
   "dependencies": {
     "@types/json-schema": "^7.0.15"
   },
   "scripts": {
-    "build": "bk-cli-service build && vue-tsc --emitDeclarationOnly"
+    "build": "bk-cli-service build && vue-tsc --emitDeclarationOnly",
+    "test": "vitest run"
   }
 }