@solazah/solazah-runtime 0.2.10 → 0.2.18

package/package.json

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

package/types/Copilot.d.ts

@@ -20,7 +20,6 @@ export interface CopilotBaseOptions {
      * - false: 显式关闭
      * - undefined: 保持模型默认
      * 优先级低于 reasoningEffort：provider 先看 reasoningEffort，缺省才回落到 enableThinking。
-     * quick-chat / popup 仍只传 enableThinking:false（不带 reasoningEffort）→ 关思考。
      */
     enableThinking?: boolean;
     /**
@@ -51,11 +50,17 @@ export interface CopilotChatOptions extends CopilotBaseOptions {
      */
     onRunFinished?: () => void;
 }
-/** 随用户一句话附上的一张图（data URL）。 */
-export interface CopilotInputImage {
+/**
+ * 随用户一句话附上的一张图：`url` 是 data URL；`path` 是执行端这台机器上的图片文件，
+ * 由执行端读出并缩到长边 1280 再交给模型。
+ */
+export type CopilotInputImage = {
     url: string;
     mime?: string;
-}
+} | {
+    path: string;
+    mime?: string;
+};
 /** 待投递给主 agent 的一条内容：notice = 后台任务完成通知，interject = 用户在生成途中插的话。 */
 export interface CopilotPendingInjection {
     kind: "notice" | "interject";
@@ -67,12 +72,23 @@ export interface CopilotPendingInjection {
     images?: CopilotInputImage[];
 }
 export interface CopilotOptions extends CopilotChatOptions {
-    mcp?: string[];
+    /**
+     * quick = 精简的一问一答(智能工具栏):不带任何工具、不思考、用精简提示词。缺省是完整的 agent 轮次。
+     */
+    mode?: "quick";
+    /**
+     * quick = 这一轮发自快捷入口(问问智能助理、快捷命令、智能工具栏):新对话记成 quick 类型,
+     * 之后在智能助理里接着聊(不带它)就转成普通对话。与 mode 各管一件事:一个管对话归到哪,一个管这一轮怎么跑。
+     */
+    kind?: "quick";
+    /**
+     * 新对话的标题:发起方手里已有现成的(如智能工具栏的「Prompt 名：选中文字」)就带上,
+     * 不再从这句话起标题 —— 同一个 Prompt 模板开头的对话,取开头起出来条条一样。对话已有标题时不改。
+     */
+    title?: string;
     projectDir?: string;
     recursionLimit?: number;
     thread_id?: string;
-    /** 经哪个桥发起（如 wechat）。这一轮新建对话时写进对话行的 bridge。 */
-    bridge?: string;
     run_id?: string;
     /**
      * 计费用的模型名(LiteLLM 的 model_name,如 deepseek-v4-pro)。
@@ -86,9 +102,11 @@ export interface CopilotOptions extends CopilotChatOptions {
      */
     viaGateway?: boolean;
     streamMode?: string[];
+    /**
+     * 本轮常驻的 AI 插件:它们的工具直接进模型的工具表,不必先 tool_search。
+     * 只给插件自己发起的轮次用(如电脑控制插件在后台跑自己的活),不写进对话,界面上没有这个选择。
+     */
     plugins?: string[];
-    tools?: any[];
-    skills?: string[];
     chatModel?: any;
     /** 本轮模型看得了图:主进程按模型标签定,决定要不要给 agent 装 view_image */
     vision?: boolean;
@@ -121,6 +139,16 @@ export interface CopilotOptions extends CopilotChatOptions {
     images?: CopilotInputImage[];
 }
 export type CopilotRunOptions = CopilotOptions;
+/**
+ * `window.copilot.run/resume` 被拒时抛出的东西：普通对象而不是 Error，经 contextBridge 交到页面时 code 才留得住。
+ * code 是主进程给的错误码（busy、stale、COPILOT_LOGIN_REQUIRED、COPILOT_MODEL_NOT_FOUND……），message 是原话。
+ * 起跑之后的失败（含额度用完 COPILOT_QUOTA_BLOCKED）不从这里抛，走 `onRunEvent` 的 error 事件，data 同样带 code 与 message
+ */
+export interface CopilotRoundRefusal {
+    name: "CopilotRoundRefusal";
+    code: string;
+    message: string;
+}
 /** 一行 = 某个模型某一天的 token 统计。model_name 是模型 id,显示名要另去模型清单里换。 */
 export interface CopilotUsageStat {
     model_name: string;
@@ -133,7 +161,6 @@ export interface CopilotUsageStat {
 }
 export default class Copilot {
     ipcRenderer: IpcRenderer;
-    private seq;
     constructor();
     /**
      * 单轮补全:按 options.model(缺省用默认补全模型)一次性生成并直接返回完整文本,
@@ -146,13 +173,9 @@ export default class Copilot {
      * @throws 模型不存在或 provider 不支持时抛错;流式错误后配额已退还再抛原错。
      */
     completion: (input: string, options: any) => Promise<any>;
-    chat: (input: string, options: CopilotRunOptions) => Promise<AsyncIterableIterator<any>>;
     /**
-     * 跑一轮。返回本轮的 requestId，**事件不在返回值里** —— 用 `onRunEvent` 订阅。
-     *
-     * 以前返回一条只有发起方拿得到的流，于是别人开的那一轮谁也看不见：
-     * 微信桥、定时任务在后台跑的轮次，本机界面只能等落库刷出结果。
-     * 订阅必须在发起**之前**建立，否则会漏掉开头那几条。
+     * 跑一轮。返回本轮的 requestId，**事件不在返回值里** —— 用 `onRunEvent` 订阅，按 requestId 认领。
+     * 订阅必须在发起**之前**建立，否则会漏掉开头那几条。被拒时抛 {@link CopilotRoundRefusal}。
      */
     run: (input: string, options: CopilotRunOptions) => Promise<string>;
     /** 轮次事件在本进程里的全部订阅者。端口只开一条，见 onRunEvent。 */
@@ -209,5 +232,9 @@ export default class Copilot {
     }) => void) => (() => void);
     /** 续一轮。与 run 同理：返回 requestId，事件用 `onRunEvent` 订阅。 */
     resume: (response: any, options: CopilotRunOptions) => Promise<string>;
-    private invokeStream;
+    /**
+     * 发起或续跑一轮。被拒时抛 {@link CopilotRoundRefusal} 这个普通对象：Error 经 contextBridge 交到页面只剩 message，
+     * code 属性到不了页面，而判忙、晚到这些拒绝要按码分支
+     */
+    private startRound;
 }

package/types/CopilotMcpServer.d.ts

@@ -1,5 +1,5 @@
 import { default as IpcRenderer } from './IpcRenderer';
-/** agent 在对话里装好一台 MCP server 后,主进程经 copilot.mcp.installed 推来的 payload。 */
+/** 装好、改好或重新启用一台 MCP server 后(设置页或对话里),主进程经 copilot.mcp.installed 推来的 payload。 */
 export interface CopilotMcpInstalledMessage {
     name: string;
     displayName: string;
@@ -10,20 +10,21 @@ export default class CopilotMcpServer {
     private transport;
     constructor(transport?: IpcRenderer);
     /**
-     * 列出当前可用的 MCP server:用户自建的(pluginName 为空)加上归属于已启用插件的;归属已禁用插件的会被排除。
+     * 列出已配置的全部 MCP server,含停用的。
      *
-     * @returns 所有可用的 MCP server 实体数组。
+     * @returns 所有 MCP server 实体数组。
      */
     getServers: () => Promise<any>;
     /**
-     * 新增一个 MCP server 配置,返回落库后的完整实体(含自动生成的 id)。
+     * 新增一个 MCP server 配置;已有同名的则更新那一台。启用着的随即连一次,列出它的工具。
      *
      * @param data MCP server 的部分字段,name/transport/command/url 等按需传入;未填字段取实体默认值。
-     * @returns 落库后的完整 CopilotMcpServer 实体(含自动生成的 id、created_at、updated_at)。
+     * @returns 落库后的完整 CopilotMcpServer 实体,附 toolNames(连接测试取到的工具名,为空表示连不通或没有工具)。
      */
     addServer: (data: any) => Promise<any>;
     /**
      * 按 id 局部更新一个 MCP server 配置:只覆盖 data 中传入的字段,id/created_at/updated_at 等只读字段不会被覆盖。
+     * 改成别的 server 已在用的名字时报错。
      *
      * @param id   目标 MCP server 的 id。
      * @param data 要合并进现有记录的字段(undefined 的字段会被置为 null)。
@@ -46,20 +47,19 @@ export default class CopilotMcpServer {
      */
     toggleServer: (id: string, enabled: boolean) => Promise<any>;
     /**
-     * 按名称测试一个已保存的 MCP server 能否成功连接。
-     * 先在库中按 name 查找;插件自带的 server(pluginName 非空)直接视为通过,不做实际连接测试。
+     * 按名称测试一个已保存的 MCP server 能否连上,连上时顺带记下它的工具定义。
      *
      * @param server MCP server 的名称(name 字段,非 id)。
-     * @returns true 表示连接成功或插件 server 跳过测试;false 表示 server 不存在或连接失败。
+     * @returns true 表示连接成功;false 表示 server 不存在或连接失败。
      */
     testConnect: (server: string) => Promise<any>;
     /**
-     * 订阅"agent 在对话里装好了一台 MCP server"通知。渲染层据此刷新列表、把新 server 并入
+     * 订阅"装好、改好或重新启用了一台 MCP server"通知(设置页或对话里)。渲染层据此刷新列表、把新 server 并入
      * 当前会话的 usedServers、弹全局 Toast。返回 unsubscribe。
      * 底层 IpcRenderer.on 对同通道 removeAllListeners 后再绑,全局只应有一个订阅者。
      */
     onMcpInstalled: (onInstalled: (msg: CopilotMcpInstalledMessage) => void) => (() => void);
-    /** 订阅"agent 在对话里删除/禁用了一台 MCP server"通知。渲染层据此刷新列表、把它移出 usedServers。 */
+    /** 订阅"删除、禁用或改名了一台 MCP server"通知(设置页或对话里)。渲染层据此刷新列表、把它移出 usedServers。 */
     onMcpRemoved: (onRemoved: (msg: {
         name: string;
         displayName?: string;

package/types/CopilotThread.d.ts

@@ -48,5 +48,4 @@ export default class CopilotThread {
      * @returns 无返回值(Promise<void>)。
      */
     removeAll: () => Promise<any>;
-    generateThreadTitle: (id: string) => Promise<any>;
 }

package/types/index.d.ts

@@ -18,7 +18,6 @@ import { default as SystemShell } from './SystemShell';
 import { default as SystemBrowser } from './SystemBrowser';
 import { default as SystemShortcut } from './SystemShortcut';
 import { default as SystemWindow } from './SystemWindow';
-import { default as CopilotWechatBridge } from './CopilotWechatBridge';
 import { default as Workspace } from './Workspace';
 import { default as File } from './File';
 import { default as Http } from './Http';
@@ -56,7 +55,6 @@ declare global {
         systemShortcut: SystemShortcut;
         systemWindow: SystemWindow;
         systemNotification: SystemNotification;
-        copilotWechatBridge: CopilotWechatBridge;
         workspace: Workspace;
         file: File;
         http: Http;

package/types/CopilotWechatBridge.d.ts

@@ -1,86 +0,0 @@
-import { default as IpcRenderer } from './IpcRenderer';
-export interface WechatAccount {
-    accountId: string;
-    baseUrl: string;
-    cdnBaseUrl: string;
-    token?: string;
-    configured: boolean;
-    userId?: string;
-    enabled: boolean;
-}
-export interface WechatLoginStartResult {
-    qrcode: string;
-    sessionKey: string;
-    message: string;
-}
-export interface WechatLoginResult {
-    connected: boolean;
-    alreadyConnected?: boolean;
-    accountId?: string;
-    sessionKey?: string;
-    baseUrl?: string;
-    userId?: string;
-    message: string;
-}
-export interface WechatChannelStatus {
-    running: boolean;
-    account: WechatAccount;
-}
-export default class CopilotWechatBridge {
-    private transport;
-    constructor(transport?: IpcRenderer);
-    /**
-     * 发起微信扫码登录流程，向微信 API 请求登录二维码并返回给渲染进程展示。
-     *
-     * @param params 可选参数对象。
-     * @param params.force 是否强制重新获取二维码；`false` 或省略时，若存在未过期的有效二维码则直接复用。
-     * @returns 包含二维码图片 URL、本次登录的 `sessionKey` 及提示文本的启动结果。
-     * @throws 微信 API 返回的二维码响应不完整（缺少 qrcode 或 qrcodeUrl 字段）时抛错。
-     */
-    startLogin: (params?: {
-        force?: boolean;
-    }) => Promise<WechatLoginStartResult>;
-    /**
-     * 轮询等待用户手机微信扫码并确认登录。以 1 秒间隔轮询二维码状态，
-     * 直到用户确认、二维码过期或超时。登录确认后自动保存账号凭证到本地数据库，
-     * 若为新连接（非此前已绑定）则自动启动微信消息桥接通道。
-     *
-     * @param params 登录等待参数。
-     * @param params.sessionKey 由 `startLogin` 返回的会话标识，用于关联本次扫码流程。
-     * @param params.timeoutMs 等待超时毫秒数，默认 480_000（8 分钟），实际取值最小为 1_000。
-     * @returns 登录结果：`connected` 表示是否连接成功；`alreadyConnected` 为 `true` 表示该设备此前已绑定，
-     *          无需重新扫码即恢复连接；失败时 `message` 携带原因描述。
-     */
-    waitForLogin: (params: {
-        sessionKey: string;
-        timeoutMs?: number;
-    }) => Promise<WechatLoginResult>;
-    /**
-     * 登出微信：先停止消息桥接通道（终止长轮询），再清除本地数据库中的账号凭证。
-     *
-     * @returns 无返回。
-     */
-    logout: () => Promise<void>;
-    /**
-     * 查询当前微信桥接的运行状态及已登录的账号信息。
-     *
-     * @returns 包含两个字段的对象：`running` 表示消息监听循环是否正在运行；
-     *          `account` 为当前账号配置详情，包含 `configured`（是否有 token）、
-     *          `enabled`（是否启用）、`accountId`、`userId` 等字段。
-     */
-    status: () => Promise<WechatChannelStatus>;
-    /**
-     * 启动微信消息桥接通道，开始长轮询监听微信消息。
-     * 仅在系统设置 `copilot.bridge.wechat.enabled` 为 `true` 且当前账号已配置并启用时才会实际启动；
-     * 任一条件不满足则主动停止已有的监听循环。
-     *
-     * @returns 无返回。
-     */
-    channelStart: () => Promise<void>;
-    /**
-     * 停止微信消息桥接通道，终止长轮询监听循环并释放相关资源。
-     *
-     * @returns 无返回。
-     */
-    channelStop: () => Promise<void>;
-}