@solazah/solazah-runtime 0.1.147 → 0.1.149

package/package.json

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

package/types/Copilot.d.ts

@@ -99,6 +99,16 @@ export interface CopilotOptions extends CopilotChatOptions {
     }[];
 }
 export type CopilotRunOptions = CopilotOptions;
+/** 一行 = 某个模型某一天的 token 统计。model_name 是模型 id,显示名要另去模型清单里换。 */
+export interface CopilotUsageStat {
+    model_name: string;
+    stat_date: string;
+    requests: number;
+    prompt_tokens: number;
+    cached_tokens: number;
+    completion_tokens: number;
+    history_rewrites: number;
+}
 export default class Copilot {
     ipcRenderer: IpcRenderer;
     private seq;
@@ -124,6 +134,8 @@ export default class Copilot {
      * @returns 无返回;requestId 无对应在跑运行时静默无操作。
      */
     abort: (requestId: string) => Promise<any>;
+    /** 最近 days 天的 token 用量,按 (模型, 日期) 聚合,新到旧。用量看板用。 */
+    usage(days?: number): Promise<CopilotUsageStat[]>;
     /**
      * 生成途中插一句话:排进待注入队列,模型下一个决策点领走,不中止当前回合。
      *

package/types/Plugin.d.ts

@@ -1,11 +1,30 @@
 import { default as IpcRenderer } from './IpcRenderer';
+/**
+ * 工具回执。只回文字就直接返回字符串;要让模型**看画面**才返回这个:
+ * images 是本机绝对路径,宿主读盘后附成一条带图的消息,插件不必再让模型调一次 view_image。
+ */
+export interface PluginToolReply {
+    text: string;
+    /** 本机绝对路径,png / jpg / webp / gif,最多 4 张 */
+    images?: string[];
+}
 export interface PluginTool {
     name: string;
-    cb: (args: any) => Promise<string> | string;
+    cb: (args: any) => Promise<string | PluginToolReply> | string | PluginToolReply;
     description: string;
     schema: object | null;
     timeoutMs?: number;
 }
+/**
+ * 宿主自身的信息，随 `plugin.info()` 一起给到插件。
+ *
+ * 有了它，插件就能对**单个能力**降级，而不必在 manifest 里声明 minHostVersion 把整个插件挡在门外：
+ * 老宿主上少一个特性、其余照常可用，好过装不上。声明下界只留给「核心功能就依赖新宿主」的情形。
+ */
+export interface PluginHostInfo {
+    /** 桌面端版本，如 "0.1.148"。 */
+    version: string;
+}
 export interface PluginToolOptions {
     /** 宿主等待回执的上限(毫秒),给执行耗时长的工具(如跑一段脚本)用 */
     timeoutMs?: number;
@@ -132,7 +151,9 @@ export default class Plugin {
      *
      * @returns 包含插件字段、commands 数组和 settings 键值对的对象;无法定位发起方插件时返回 undefined。
      */
-    info: () => Promise<any>;
+    info: () => Promise<(Record<string, any> & {
+        host: PluginHostInfo;
+    }) | undefined>;
     /**
      * 按命令名批量注销发起方插件的运行时命令,从启动器移除。
      * 按命令名(name)和插件名(pluginName)联合匹配删除;仅删运行时命令,manifest 命令不受影响。