@coclaw/openclaw-coclaw 0.3.1 → 0.3.2

package/index.js

@@ -3,7 +3,7 @@ import { registerCoclawCli } from './src/cli-registrar.js';
 import { resolveErrorMessage } from './src/common/errors.js';
 import { notBound, bindOk, unbindOk } from './src/common/messages.js';
 import { coclawChannelPlugin } from './src/channel-plugin.js';
-import { ensureAgentSession, refreshRealtimeBridge, startRealtimeBridge, stopRealtimeBridge } from './src/realtime-bridge.js';
+import { ensureAgentSession, restartRealtimeBridge, stopRealtimeBridge } from './src/realtime-bridge.js';
 import { setRuntime } from './src/runtime.js';
 import { createSessionManager } from './src/session-manager/manager.js';
 import { AutoUpgradeScheduler } from './src/auto-upgrade/updater.js';
@@ -61,7 +61,7 @@ const plugin = {
 		api.registerService({
 			id: 'coclaw-realtime-bridge',
 			async start() {
-				await startRealtimeBridge({ logger, pluginConfig: api.pluginConfig });
+				await restartRealtimeBridge({ logger, pluginConfig: api.pluginConfig });
 			},
 			async stop() {
 				await stopRealtimeBridge();
@@ -70,7 +70,7 @@ const plugin = {
 
 		api.registerGatewayMethod('coclaw.refreshBridge', async ({ respond }) => {
 			try {
-				await refreshRealtimeBridge({ logger, pluginConfig: api.pluginConfig });
+				await restartRealtimeBridge({ logger, pluginConfig: api.pluginConfig });
 				respond(true, { status: 'refreshed' });
 			}
 			catch (err) {
@@ -141,14 +141,13 @@ const plugin = {
 
 				try {
 					if (action === 'bind') {
-						// 先断开 bridge，避免 unbindWithServer 触发的 bot.unbound 竞态
-						await stopRealtimeBridge();
+						await stopRealtimeBridge(); // 先断开，避免 bindBot 内 unbind 触发 bot.unbound 竞态
 						const serverUrl = options.server ?? api.pluginConfig?.serverUrl;
 						const result = await bindBot({
 							code: positionals[0],
 							serverUrl,
 						});
-						await refreshRealtimeBridge({ logger, pluginConfig: api.pluginConfig });
+						await restartRealtimeBridge({ logger, pluginConfig: api.pluginConfig });
 						return { text: bindOk(result) };
 					}
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coclaw/openclaw-coclaw",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "type": "module",
   "license": "Apache-2.0",
   "description": "OpenClaw CoClaw channel plugin for remote chat",

package/src/realtime-bridge.js

@@ -352,7 +352,7 @@ export class RealtimeBridge {
 					platform: process.platform,
 					mode: 'backend',
 				},
-				caps: [],
+				caps: ['tool-events'],
 				role: 'operator',
 				scopes: ['operator.admin'],
 				auth: authToken ? { token: authToken } : undefined,
@@ -713,31 +713,32 @@ export class RealtimeBridge {
 }
 
 // --- 单例便捷 API（供 index.js 使用）---
+// 仅暴露 restartRealtimeBridge / stopRealtimeBridge 两个操作：
+//   restart(opts) — 无论当前状态，确保 bridge 以给定 opts 运行（幂等）
+//   stop()        — 停止并销毁 singleton
+// 调用方无需感知 singleton 是否为 null，选"要运行"或"要停止"即可。
 
 let singleton = null;
 
-export async function startRealtimeBridge(opts) {
+/**
+ * 确保 bridge 运行：已有实例则 stop 后重建，无则直接创建。opts 必传。
+ * @param {{ logger, pluginConfig }} opts
+ */
+export async function restartRealtimeBridge(opts) {
+	if (singleton) {
+		await singleton.stop();
+		singleton = null;
+	}
 	singleton = new RealtimeBridge();
 	await singleton.start(opts);
 }
 
-export async function refreshRealtimeBridge(opts) {
-	if (!singleton) {
-		// stop 后 singleton 被清除，需重新创建（如 bind 后重连）
-		if (opts) {
-			await startRealtimeBridge(opts);
-		}
-		return;
-	}
-	await singleton.refresh();
-}
-
 export async function stopRealtimeBridge() {
 	if (!singleton) {
 		return;
 	}
 	await singleton.stop();
-	singleton = null;
+	singleton = null; // 置 null 后须通过 restartRealtimeBridge 重建
 }
 
 export async function ensureAgentSession(agentId) {