@solazah/solazah-runtime 0.0.163 → 0.0.164

package/package.json

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

package/types/Plugin.d.ts

@@ -1,10 +1,9 @@
 import { default as IpcRenderer } from './IpcRenderer';
-import { ToolCall } from 'langchain';
 export interface PluginTool {
     name: string;
-    cb: (call: ToolCall) => Promise<string>;
+    cb: (args: any) => Promise<string> | string;
     description: string;
-    schema: string;
+    schema: object | null;
 }
 export default class Plugin {
     private ipcRenderer;
@@ -15,9 +14,15 @@ export default class Plugin {
     getTools: () => {
         name: string;
         description: string;
-        schema: string;
+        schema: object | null;
     }[];
-    tool: (name: string, description: string, schema: string, cb: any) => any;
+    /**
+     * 给 Otta 注册 AI 工具。
+     * schema 传 JSON Schema 对象(如 z.toJSONSchema(...) 的返回值),无参工具传 null;
+     * cb 收到已按 schema 拆包的参数对象(无参工具收到 {}),返回字符串给 LLM(返回对象会被 JSON.stringify)。
+     * 同名重复注册为覆盖(HMR 安全)。
+     */
+    tool: (name: string, description: string, schema: object | null, cb: (args: any) => Promise<string> | string) => (args: any) => Promise<string> | string;
     onSearch: (commandName: string, handler: any) => Promise<void>;
     onAction: (commandName: string, action: string, handler: any) => Promise<void>;
     /**

package/types/SystemOCR.d.ts

@@ -1,4 +1,11 @@
 import { default as IpcRenderer } from './IpcRenderer';
+export interface OCRTextBlock {
+    text: string;
+    score: number;
+    chars: any;
+    /** 四个角点坐标,顺时针或逆时针,不是 x/y/width/height 矩形 */
+    box: [number, number][];
+}
 export default class SystemOCR {
     private transport;
     constructor(transport?: IpcRenderer);
@@ -6,8 +13,8 @@ export default class SystemOCR {
      * 调用本地 OCR 引擎识别图片并返回文本块数组。
      *
      * @param base64String Base64 编码的图片数据。
-     * @returns 文本块数组。
+     * @returns 文本块数组,每块含 text(识别文字)/score(置信度)/chars/box(四角点坐标)。
      * @throws 图片解码失败或 OCR 引擎未就绪时抛错。
      */
-    recognize: (base64String: string) => Promise<any>;
+    recognize: (base64String: string) => Promise<OCRTextBlock[]>;
 }