@solazah/solazah-runtime 0.1.140 → 0.1.144

package/package.json

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

package/types/Copilot.d.ts

@@ -124,6 +124,29 @@ export default class Copilot {
      * @returns 无返回;requestId 无对应在跑运行时静默无操作。
      */
     abort: (requestId: string) => Promise<any>;
+    /**
+     * 生成途中插一句话:排进待注入队列,模型下一个决策点领走,不中止当前回合。
+     *
+     * @param threadId 会话 ID
+     * @param id       消息 id,由渲染层生成;撤回与去重都按它
+     * @param text     插话正文
+     */
+    interjectPush: (threadId: string, id: string, text: string) => Promise<any>;
+    /**
+     * 撤回一条还没被领走的插话。
+     *
+     * @returns 撤下来了返回 true;已经被模型读过则 false
+     */
+    interjectRevoke: (threadId: string, id: string) => Promise<boolean>;
+    /**
+     * 订阅「插话已被模型领走」。渲染层据此把气泡从未读改成已读。
+     *
+     * @returns 退订函数
+     */
+    onInterjectTaken: (onTaken: (msg: {
+        threadId: string;
+        ids: string[];
+    }) => void) => (() => void);
     resume: (response: any, options: CopilotRunOptions) => Promise<AsyncIterableIterator<any>>;
     private invokeStream;
 }

package/types/CopilotSubAgent.d.ts

@@ -146,15 +146,15 @@ export default class CopilotSubAgent {
      * @param onPending 回调,参数为 `{ threadId }`
      * @returns 退订函数
      */
-    onBackgroundNoticePending: (onPending: (msg: {
+    onPendingInjection: (onPending: (msg: {
         threadId: string;
     }) => void) => (() => void);
     /**
-     * 取走某会话待投递的后台通知文案(取走即清空)。
+     * 取走某会话待注入的文案(取走即清空):后台通知与用户插话共用同一个队列。
      * 与主进程「轮中注入」共用同一个队列,同一条通知只会被其中一方领到。
      *
      * @param threadId 会话 ID
      * @returns 待投递文案数组;没有则空数组
      */
-    takeBackgroundNotices: (threadId: string) => Promise<string[]>;
+    takePendingInjections: (threadId: string) => Promise<string[]>;
 }

package/types/SystemScreen.d.ts

@@ -82,9 +82,13 @@ export default class SystemScreen {
      * 截图尺寸按物理像素(display.size × scaleFactor),保证 retina/高分屏清晰度。
      *
      * @param displayId 目标显示器 id;省略则截取光标当前所在的显示器。
+     * @param options excludeSelf 为真时截那一刻把 Solazah 自己的全部窗口排除出画面:采集目标应用的画面时用,
+     *   免得助理窗口、插件窗口盖在上面。
      * @returns 截图的 PNG Data URL;未找到显示器或截图源时返回 null。
      */
-    captureDisplay: (displayId?: number) => Promise<any>;
+    captureDisplay: (displayId?: number, options?: {
+        excludeSelf?: boolean;
+    }) => Promise<any>;
     /**
      * 列出当前所有显示器信息,包含 id、逻辑像素边界、缩放因子、是否主屏。
      *
@@ -204,6 +208,7 @@ export default class SystemScreen {
      *
      * @param frame   被分析图片的 Base64(整个显示器的截图)。
      * @param request `{templates?: [{id, image, region?, scale?, minScore?, maxResults?}], texts?: [{id, region?, detRatio?, zoom?}]}`,region 相对图片左上角。
+     *   frame 与 templates[].image 都可以给 Data URL 或本机绝对路径;反复分析同一批图时给路径,同一张只解码一次。
      * @returns `{templates: {id: [{x, y, width, height, score, scale}]}, texts: {id: [{text, score, x, y, width, height}]}}`,坐标相对图片左上角。
      */
     analyzeFrame: (frame: string, request?: {