@solazah/solazah-runtime 0.2.53 → 0.2.57

package/package.json

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

package/types/Copilot.d.ts

@@ -70,10 +70,16 @@ export type CopilotInputImage = {
     path: string;
     mime?: string;
 };
-/** 待投递给主 agent 的一条内容：notice = 后台任务完成通知，interject = 用户在生成途中插的话。 */
+/**
+ * 待投递给主 agent 的一条内容：
+ * notice = 后台任务完成通知，interject = 用户在生成途中插的话，
+ * agent = 本对话的参与者（子代理）发来的消息。
+ *
+ * 真源在本文件，插件侧的镜像在 `../solazah-plugin-copilot` 的 runtime 契约里，两边要一致。
+ */
 export interface CopilotPendingInjection {
-    kind: "notice" | "interject";
-    /** 通知的执行端 subAgentType；插话不带。 */
+    kind: "notice" | "interject" | "agent";
+    /** 通知的执行端 subAgentType；插话不带；参与者消息带发送方名字。 */
     source?: string;
     /** 注入时用作消息 id(落库切片按 id 去重),同时是撤回的凭据。 */
     id: string;

package/types/Plugin.d.ts

@@ -19,6 +19,7 @@ export interface PluginTool {
     description: string;
     schema: object | null;
     timeoutMs?: number;
+    resident?: boolean;
 }
 /**
  * 宿主自身的信息，随 `plugin.info()` 一起给到插件。
@@ -33,6 +34,12 @@ export interface PluginHostInfo {
 export interface PluginToolOptions {
     /** 宿主等待回执的上限(毫秒),给执行耗时长的工具(如跑一段脚本)用 */
     timeoutMs?: number;
+    /**
+     * 声明这个工具常驻:每轮都在模型的工具表里,不必经 tool_search 取用。
+     * 常驻工具进的是缓存前缀最前面的工具块,所以只给模型必须主动用、等用户提起就晚了的工具,
+     * 且在插件里**固定不变**(按需增删会让整段历史前缀失配)。
+     */
+    resident?: boolean;
 }
 export default class Plugin {
     private ipcRenderer;
@@ -45,6 +52,7 @@ export default class Plugin {
         description: string;
         schema: object | null;
         timeoutMs: number | undefined;
+        resident: boolean | undefined;
     }[];
     /**
      * 给 Otta 注册 AI 工具。