rol-websocket-channel 1.7.9 → 1.8.0

package/dist/index.js

@@ -747,6 +747,7 @@ export default defineChannelPluginEntry({
     },
     registerFull(api) {
         registerArtifactsTools(api);
+        registerToolEventHooks(api);
     },
 });
 let legacyIsPluginRegistered = false;
@@ -879,3 +880,60 @@ function registerAdminBridgeCli(api) {
         ],
     });
 }
+// ============================================
+// 8. Tool 事件钩子：实时通过 MQTT 推送 AI 工具调用过程
+// ============================================
+function publishToolEvent(event) {
+    const conn = ConnectionManager.getGlobalConnection();
+    if (!conn || !conn.ws || !conn.ws.connected)
+        return;
+    let targetTopic = conn.topic;
+    if (targetTopic.endsWith("#")) {
+        targetTopic = targetTopic.slice(0, -1) + "app";
+    }
+    targetTopic = targetTopic.replace("device", "app").replace("bot", "app");
+    try {
+        conn.ws.publish(targetTopic, JSON.stringify(event));
+    }
+    catch {
+        // 忽略发布错误，避免影响主流程
+    }
+}
+function registerToolEventHooks(api) {
+    // before_tool_call：AI 即将调用某个工具时触发
+    api.registerHook("before_tool_call", (event, ctx) => {
+        publishToolEvent({
+            type: "receiver",
+            source: "tools",
+            event: "before_tool_call",
+            timestamp: Date.now(),
+            data: {
+                toolName: event.toolName,
+                toolCallId: event.toolCallId,
+                runId: event.runId ?? ctx.runId,
+                sessionKey: ctx.sessionKey,
+                agentId: ctx.agentId,
+                params: event.params,
+            },
+        });
+    });
+    // after_tool_call：工具执行完毕（含结果或错误）时触发
+    api.registerHook("after_tool_call", (event, ctx) => {
+        publishToolEvent({
+            type: "tool_event",
+            source: "system",
+            event: "after_tool_call",
+            timestamp: Date.now(),
+            data: {
+                toolName: event.toolName,
+                toolCallId: event.toolCallId,
+                runId: event.runId ?? ctx.runId,
+                sessionKey: ctx.sessionKey,
+                agentId: ctx.agentId,
+                durationMs: event.durationMs,
+                error: event.error,
+                result: event.result,
+            },
+        });
+    });
+}

package/index.ts

@@ -936,6 +936,7 @@ export default defineChannelPluginEntry({
   },
   registerFull(api) {
     registerArtifactsTools(api);
+    registerToolEventHooks(api);
   },
 });
 
@@ -1129,3 +1130,63 @@ function registerAdminBridgeCli(api: OpenClawPluginApi) {
     },
   );
 }
+
+// ============================================
+// 8. Tool 事件钩子：实时通过 MQTT 推送 AI 工具调用过程
+// ============================================
+function publishToolEvent(event: object): void {
+  const conn = ConnectionManager.getGlobalConnection();
+  if (!conn || !conn.ws || !conn.ws.connected) return;
+
+  let targetTopic = conn.topic;
+  if (targetTopic.endsWith("#")) {
+    targetTopic = targetTopic.slice(0, -1) + "app";
+  }
+  targetTopic = targetTopic.replace("device", "app").replace("bot", "app");
+
+  try {
+    conn.ws.publish(targetTopic, JSON.stringify(event));
+  } catch {
+    // 忽略发布错误，避免影响主流程
+  }
+}
+
+function registerToolEventHooks(api: any): void {
+  // before_tool_call：AI 即将调用某个工具时触发
+  api.registerHook("before_tool_call", (event: any, ctx: any) => {
+    publishToolEvent({
+      type: "receiver",
+      source: "tools",
+      event: "before_tool_call",
+      timestamp: Date.now(),
+      data: {
+        toolName: event.toolName,
+        toolCallId: event.toolCallId,
+        runId: event.runId ?? ctx.runId,
+        sessionKey: ctx.sessionKey,
+        agentId: ctx.agentId,
+        params: event.params,
+      },
+    });
+  });
+
+  // after_tool_call：工具执行完毕（含结果或错误）时触发
+  api.registerHook("after_tool_call", (event: any, ctx: any) => {
+    publishToolEvent({
+      type: "tool_event",
+      source: "system",
+      event: "after_tool_call",
+      timestamp: Date.now(),
+      data: {
+        toolName: event.toolName,
+        toolCallId: event.toolCallId,
+        runId: event.runId ?? ctx.runId,
+        sessionKey: ctx.sessionKey,
+        agentId: ctx.agentId,
+        durationMs: event.durationMs,
+        error: event.error,
+        result: event.result,
+      },
+    });
+  });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rol-websocket-channel",
-  "version": "1.7.9",
+  "version": "1.8.0",
   "description": "Unified OpenClaw plugin: MQTT Channel + Admin Bridge for remote management",
   "license": "MIT",
   "author": "nixgnehc",