@blueking/chat-helper 0.0.12-beta.10 → 0.0.12-beta.12

package/README.md

@@ -1885,13 +1885,19 @@ A: 使用 `agent.chat` 的 `url` 和 `config` 参数：
 // 使用不同的端点
 agent.chat(userInput, sessionCode, 'custom_chat/');
 
-// 添加自定义参数
+// 添加自定义请求参数（如 temperature）
 agent.chat(userInput, sessionCode, undefined, {
   data: {
     temperature: 0.8,
-    model: 'gpt-4',
   },
 });
+
+// 模型热切换：传入第 6 个参数 model（值为 llm_code，需在 GET llms/ 列表内）
+agent.chat(userInput, sessionCode, undefined, undefined, property, 'hy3-preview');
+
+// 拉取可用模型列表
+const llmList = await agent.getLlms({ llm_type: 'chat.completion' });
+// agent.models 同步更新
 ```
 
 ### Q: 消息列表如何实现自动滚动到底部？

package/dist/agent/type.d.ts

@@ -126,3 +126,72 @@ export interface IAgentResources {
     mcp?: IAgentResourceItem[];
     tool?: IAgentResourceItem[];
 }
+/** 模型能力属性（后端 property 字段） */
+export interface ILlmProperty {
+    agent_type?: string;
+    default?: boolean;
+    is_self_host?: boolean;
+    max_model_len?: number;
+    support_summary?: boolean;
+    support_thinking?: boolean;
+    support_thinking_quick?: boolean;
+    support_tools?: boolean;
+    support_vision?: boolean;
+    support_window?: boolean;
+}
+/** 可用模型列表查询参数 */
+export interface ILlmListQuery {
+    /** 模糊搜索关键词，按 llm_name / description / base_model 匹配 */
+    fuzzy?: string;
+    /** 模型类型，不传时默认 chat.completion */
+    llm_type?: string;
+    /** 按模型支持的功能过滤，逗号分隔，如 tool_call,vision */
+    supports?: string;
+}
+/**
+ * 可用模型项（对齐 plugin_api/llms/ 与 chat-x IModelOption）
+ * 字段以 snake_case 与后端保持一致，便于直接透传给 ModelSelector
+ */
+export interface ILlmItem {
+    /** 基础模型标识，如 hunyuan */
+    base_model?: string;
+    /** 模型描述 */
+    description?: string;
+    /** 是否禁用（前端扩展字段） */
+    disabled?: boolean;
+    /** 模型图标地址 */
+    icon?: string;
+    /** 模型主键 id */
+    id: number;
+    /** 模型编码（chat_completion 热切换传此值） */
+    llm_code: string;
+    /** 模型展示名（ModelSelector v-model 选中值） */
+    llm_name: string;
+    /** 模型类型，如 chat.completion */
+    llm_type: string;
+    /** 最大 token 数 */
+    max_token_size: number;
+    /** 模型能力属性 */
+    property: ILlmProperty;
+    /** 空间维度鉴权模式 */
+    space_auth_mode: string;
+    /** 标签名列表 */
+    tag_names?: string[];
+    /** 用户维度鉴权模式 */
+    user_auth_mode: string;
+}
+/** 后端 llms/ 原始响应项（字段可能缺省） */
+export interface ILlmItemApi {
+    base_model?: string;
+    description?: string;
+    icon?: string;
+    id?: number;
+    llm_code: string;
+    llm_name: string;
+    llm_type?: string;
+    max_token_size?: number;
+    property?: ILlmProperty | null;
+    space_auth_mode?: string;
+    tag_names?: string[];
+    user_auth_mode?: string;
+}

package/dist/agent/type.ts.js

@@ -22,4 +22,4 @@
  * 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.
- */ /** @deprecated 后端已改为扁平列表 IAgentResourceItem[]，不再使用分组结构 */ export { };
+ */ /** 后端 llms/ 原始响应项（字段可能缺省） */ export { };

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

@@ -1,9 +1,9 @@
-import { ApprovalInterruptTicketStatus, ResumeStatus, RunFinishedOutcomeType, type IResume } from '../event';
+import { ApprovalInterruptTicketStatus, EventType, ResumeStatus, RunFinishedOutcomeType, type IResume } from '../event';
 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 } from './type';
+import type { IAgentInfo, ILlmItem, ILlmListQuery } from './type';
 /**
  * Agent 模块
  * @param options - 配置选项
@@ -70,6 +70,17 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
             content?: ({
                 activityType: import("../message").ActivityType;
                 content: {
+                    artifacts: {
+                        name: string;
+                        outputId: string;
+                        size: number;
+                        type: string;
+                        previewUrl?: string;
+                        url?: string;
+                    }[];
+                    runId: string;
+                    status: "complete" | "empty";
+                } | {
                     nodes: Record<string, import("../event").IFlowAgentNode>;
                     task_id: string;
                     task_name: string;
@@ -87,6 +98,31 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
                     originFileUrl?: string;
                     url: string;
                 }[];
+                property?: {
+                    [x: string]: unknown;
+                    artifacts?: {
+                        name: string;
+                        outputId: string;
+                        size: number;
+                        type: string;
+                        previewUrl?: string;
+                        url?: string;
+                    }[];
+                    extra?: {
+                        [x: string]: unknown;
+                        cite?: string | {
+                            data: {
+                                key: string;
+                                value: string;
+                            }[];
+                            title: string;
+                            type: string;
+                        };
+                        command?: string;
+                        context?: Array<Record<string, unknown>>;
+                        resources?: Array<Record<string, unknown>>;
+                    };
+                };
                 role: MessageRole.Activity;
                 id?: string;
                 messageId?: string;
@@ -97,6 +133,14 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
                 content?: string;
                 property?: {
                     [x: string]: unknown;
+                    artifacts?: {
+                        name: string;
+                        outputId: string;
+                        size: number;
+                        type: string;
+                        previewUrl?: string;
+                        url?: string;
+                    }[];
                     extra?: {
                         [x: string]: unknown;
                         cite?: string | {
@@ -154,7 +198,7 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
                     };
                     runId: number;
                     threadId: string;
-                    type: import("../event").EventType.RunFinished;
+                    type: EventType.RunFinished;
                     outcome?: {
                         type: RunFinishedOutcomeType.Success;
                     } | {
@@ -920,6 +964,14 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
                 })[];
                 property?: {
                     [x: string]: unknown;
+                    artifacts?: {
+                        name: string;
+                        outputId: string;
+                        size: number;
+                        type: string;
+                        previewUrl?: string;
+                        url?: string;
+                    }[];
                     extra?: {
                         [x: string]: unknown;
                         cite?: string | {
@@ -1006,6 +1058,17 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
             content?: ({
                 activityType: import("../message").ActivityType;
                 content: {
+                    artifacts: {
+                        name: string;
+                        outputId: string;
+                        size: number;
+                        type: string;
+                        previewUrl?: string;
+                        url?: string;
+                    }[];
+                    runId: string;
+                    status: "complete" | "empty";
+                } | {
                     nodes: Record<string, import("../event").IFlowAgentNode>;
                     task_id: string;
                     task_name: string;
@@ -1023,6 +1086,31 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
                     originFileUrl?: string;
                     url: string;
                 }[];
+                property?: {
+                    [x: string]: unknown;
+                    artifacts?: {
+                        name: string;
+                        outputId: string;
+                        size: number;
+                        type: string;
+                        previewUrl?: string;
+                        url?: string;
+                    }[];
+                    extra?: {
+                        [x: string]: unknown;
+                        cite?: string | {
+                            data: {
+                                key: string;
+                                value: string;
+                            }[];
+                            title: string;
+                            type: string;
+                        };
+                        command?: string;
+                        context?: Array<Record<string, unknown>>;
+                        resources?: Array<Record<string, unknown>>;
+                    };
+                };
                 role: MessageRole.Activity;
                 id?: string;
                 messageId?: string;
@@ -1033,6 +1121,14 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
                 content?: string;
                 property?: {
                     [x: string]: unknown;
+                    artifacts?: {
+                        name: string;
+                        outputId: string;
+                        size: number;
+                        type: string;
+                        previewUrl?: string;
+                        url?: string;
+                    }[];
                     extra?: {
                         [x: string]: unknown;
                         cite?: string | {
@@ -1090,7 +1186,7 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
                     };
                     runId: number;
                     threadId: string;
-                    type: import("../event").EventType.RunFinished;
+                    type: EventType.RunFinished;
                     outcome?: {
                         type: RunFinishedOutcomeType.Success;
                     } | {
@@ -1856,6 +1952,14 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
                 })[];
                 property?: {
                     [x: string]: unknown;
+                    artifacts?: {
+                        name: string;
+                        outputId: string;
+                        size: number;
+                        type: string;
+                        previewUrl?: string;
+                        url?: string;
+                    }[];
                     extra?: {
                         [x: string]: unknown;
                         cite?: string | {
@@ -1885,24 +1989,80 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
     }>;
     isInfoLoading: import("vue").Ref<boolean, boolean>;
     isChatting: import("vue").Ref<boolean, boolean>;
-    chat: (userInput: IUserMessage["content"], sessionCode: string, url?: string, config?: IRequestConfig, property?: IMessageProperty) => Promise<void>;
+    models: import("vue").Ref<{
+        base_model?: string;
+        description?: string;
+        disabled?: boolean;
+        icon?: string;
+        id: number;
+        llm_code: string;
+        llm_name: string;
+        llm_type: string;
+        max_token_size: number;
+        property: {
+            agent_type?: string;
+            default?: boolean;
+            is_self_host?: boolean;
+            max_model_len?: number;
+            support_summary?: boolean;
+            support_thinking?: boolean;
+            support_thinking_quick?: boolean;
+            support_tools?: boolean;
+            support_vision?: boolean;
+            support_window?: boolean;
+        };
+        space_auth_mode: string;
+        tag_names?: string[];
+        user_auth_mode: string;
+    }[], ILlmItem[] | {
+        base_model?: string;
+        description?: string;
+        disabled?: boolean;
+        icon?: string;
+        id: number;
+        llm_code: string;
+        llm_name: string;
+        llm_type: string;
+        max_token_size: number;
+        property: {
+            agent_type?: string;
+            default?: boolean;
+            is_self_host?: boolean;
+            max_model_len?: number;
+            support_summary?: boolean;
+            support_thinking?: boolean;
+            support_thinking_quick?: boolean;
+            support_tools?: boolean;
+            support_vision?: boolean;
+            support_window?: boolean;
+        };
+        space_auth_mode: string;
+        tag_names?: string[];
+        user_auth_mode: string;
+    }[]>;
+    isModelsLoading: import("vue").Ref<boolean, boolean>;
+    chat: (userInput: IUserMessage["content"], sessionCode: string, url?: string, config?: IRequestConfig, property?: IMessageProperty, model?: string) => Promise<void>;
     handleRole: (data: IAgentInfo, sessionCode: string) => void;
-    resendMessage: (messageId: string, sessionCode: string, newContent?: IUserMessage["content"], url?: string, config?: IRequestConfig) => Promise<void>;
-    resumeStreamingChat: (sessionCode: string, url?: string, config?: IRequestConfig) => void;
+    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>;
     getAgentInfo: () => Promise<void>;
+    getLlms: (params?: ILlmListQuery, config?: IRequestConfig) => Promise<ILlmItem[]>;
     reset: (protocol: ISSEProtocol) => void;
-    pollResumeSession: (sessionCode: string) => void;
+    pollResumeSession: (sessionCode: string, model?: string) => void;
     clearLongPollTimer: () => void;
-    userOperationStreamRequest: (sessionCode: string, operation: UserOperation, payload: IUserOperationPayload, config?: IRequestConfig) => Promise<void>;
-    streamRequest: ({ sessionCode, url, config, resume, input, lastMessageId, }: {
+    userOperationStreamRequest: (sessionCode: string, operation: UserOperation, payload: IUserOperationPayload, config?: IRequestConfig, model?: string) => Promise<void>;
+    streamRequest: ({ sessionCode, model, url, config, resume, input, lastMessageId, isReconnect, }: {
         sessionCode: string;
+        model?: string;
         url?: string;
         config?: IRequestConfig;
         resume?: IResume;
         input?: string;
         lastMessageId?: string;
+        /** 内部静默重连，不重置重连计数 */
+        isReconnect?: boolean;
     }) => Promise<void>;
 };
 export type IAgentModule = ReturnType<typeof useAgent>;