@solazah/solazah-runtime 0.2.21 → 0.2.27

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solazah/solazah-runtime",
-  "version": "0.2.21",
+  "version": "0.2.27",
   "main": "index.cjs",
   "module": "index.js",
   "types": "types/index.d.ts",

package/types/Copilot.d.ts

@@ -29,7 +29,15 @@ export interface CopilotBaseOptions {
      */
     reasoningEffort?: EffortLevel;
 }
+/** 三类默认模型，各存在一个设置项里：对话、补全、GUI（看屏幕、决定下一步动作的视觉模型） */
+export type CopilotDefaultModel = "chat" | "completion" | "gui";
 export interface CopilotCompletionOptions extends CopilotBaseOptions {
+    /** 没给 model 时用哪一类默认模型，缺省是补全模型 */
+    defaultModel?: CopilotDefaultModel;
+    /** 随提示词附上的图片。视觉模型拼成 image_url 内容块，纯文本模型丢弃（见 CopilotHumanContent） */
+    images?: CopilotInputImage[];
+    /** 调用归属的会话。同一会话的调用在网关里归到一起，并共用上游的缓存亲和；缺省每次调用各算一个会话 */
+    session?: string;
 }
 export interface CopilotChatOptions extends CopilotBaseOptions {
     requestId: string;
@@ -134,7 +142,6 @@ export interface CopilotOptions extends CopilotChatOptions {
     persistFromToolCallId?: string;
     /**
      * 本轮用户消息附上的图片。视觉模型拼成 image_url 内容块，纯文本模型丢弃（见 CopilotHumanContent）。
-     * 仅 run() 这条路径用得到;completion/chat 不接。
      */
     images?: CopilotInputImage[];
 }
@@ -163,16 +170,17 @@ export default class Copilot {
     ipcRenderer: IpcRenderer;
     constructor();
     /**
-     * 单轮补全:按 options.model(缺省用默认补全模型)一次性生成并直接返回完整文本,
+     * 单轮补全:按 options.model(缺省用 defaultModel 那一类默认模型,再缺省是默认补全模型)一次性生成并直接返回完整文本,
      * 不流式、不落对话历史。
      *
      * @param input   补全的提示词文本。
-     * @param options 补全选项。model 缺省时使用系统设置的默认补全模型;
+     * @param options 补全选项，见 {@link CopilotCompletionOptions}。model 缺省时按 defaultModel 取系统设置的默认模型
+     *                （gui 即设置页的默认 GUI 模型）；images 随提示词附图;
      *                也支持 temperature / timeout / messages / enableThinking / reasoningEffort。
      * @returns 生成的完整文本内容。
-     * @throws 模型不存在或 provider 不支持时抛错;流式错误后配额已退还再抛原错。
+     * @throws 模型不存在、对应的默认模型没设或已不存在、provider 不支持时抛错;流式错误后配额已退还再抛原错。
      */
-    completion: (input: string, options: any) => Promise<any>;
+    completion: (input: string, options?: CopilotCompletionOptions) => Promise<any>;
     /**
      * 跑一轮。返回本轮的 requestId，**事件不在返回值里** —— 用 `onRunEvent` 订阅，按 requestId 认领。
      * 订阅必须在发起**之前**建立，否则会漏掉开头那几条。被拒时抛 {@link CopilotRoundRefusal}。

package/types/CopilotModel.d.ts

@@ -28,7 +28,8 @@ export default class CopilotModel {
      */
     remove: (modelId: string) => Promise<any>;
     /**
-     * 返回全部模型,并给每条附加计算属性:isEmbedded(是否内置、前端据此标记「不可移除」)。
+     * 返回全部模型,并给每条附加计算属性:isEmbedded(是否内置、前端据此标记「不可移除」)、
+     * acceptedEfforts(模型接受的思考档位 none/low/medium/high,界面据此只放出这些档)。
      *
      * @returns 模型列表数组,每项包含 isEmbedded 等计算属性
      */