@coclaw/openclaw-coclaw 0.9.0 → 0.9.2

package/index.js

@@ -14,6 +14,7 @@ import { ChatHistoryManager } from './src/chat-history-manager/manager.js';
 import { generateTitle } from './src/topic-manager/title-gen.js';
 import { AutoUpgradeScheduler } from './src/auto-upgrade/updater.js';
 import { getPackageInfo } from './src/auto-upgrade/updater-check.js';
+import { createFileHandler } from './src/file-manager/handler.js';
 
 // 延迟读取 + 缓存：避免模块加载时 package.json 损坏导致插件整体无法注册
 let __pluginVersion = null;
@@ -472,6 +473,54 @@ const plugin = {
 			}
 		});
 
+		// --- 文件管理 RPC（WS fallback，RTC 路径由 webrtc-peer 本地拦截） ---
+
+		const fileHandler = createFileHandler({
+			resolveWorkspace: (agentId) => {
+				const cfg = api.runtime?.config?.loadConfig();
+				const dir = api.runtime?.agent?.resolveAgentWorkspaceDir(cfg, agentId);
+				if (!dir) {
+					const err = new Error('Cannot resolve workspace: runtime not available');
+					err.code = 'AGENT_DENIED';
+					throw err;
+				}
+				return dir;
+			},
+			logger,
+		});
+
+		api.registerGatewayMethod('coclaw.files.list', async ({ params, respond }) => {
+			try {
+				respond(true, await fileHandler.listFiles(params ?? {}));
+			} catch (err) {
+				respondError(respond, err);
+			}
+		});
+
+		api.registerGatewayMethod('coclaw.files.delete', async ({ params, respond }) => {
+			try {
+				respond(true, await fileHandler.deleteFile(params ?? {}));
+			} catch (err) {
+				respondError(respond, err);
+			}
+		});
+
+		api.registerGatewayMethod('coclaw.files.mkdir', async ({ params, respond }) => {
+			try {
+				respond(true, await fileHandler.mkdirOp(params ?? {}));
+			} catch (err) {
+				respondError(respond, err);
+			}
+		});
+
+		api.registerGatewayMethod('coclaw.files.create', async ({ params, respond }) => {
+			try {
+				respond(true, await fileHandler.createFile(params ?? {}));
+			} catch (err) {
+				respondError(respond, err);
+			}
+		});
+
 		const scheduler = new AutoUpgradeScheduler({ pluginId: api.id, logger });
 		api.registerService({
 			id: 'coclaw-auto-upgrade',

package/package.json

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

package/src/auto-upgrade/updater-spawn.js

@@ -54,6 +54,10 @@ export function spawnUpgradeWorker({ pluginDir, fromVersion, toVersion, pluginId
 		env,
 	});
 
+	// spawn 失败时 Node.js 会异步 emit 'error'；若无监听器则变为未捕获异常导致 gateway 崩溃
+	child.on('error', (err) => {
+		logger?.warn?.(`[spawner] Worker spawn error: ${err.message}`);
+	});
 	child.unref();
 
 	logger?.info?.(`[spawner] Worker spawned (pid: ${child.pid})`);

package/src/file-manager/handler.js

@@ -720,7 +720,11 @@ export function createFileHandler({ resolveWorkspace, logger, deps = {} }) {
 		handleFileChannel,
 		scheduleTmpCleanup,
 		cancelCleanup,
-		// 暴露内部方法便于测试
+		listFiles,
+		deleteFile,
+		mkdirOp,
+		createFile,
+		// 向后兼容（测试中已使用 __ 前缀）
 		__listFiles: listFiles,
 		__deleteFile: deleteFile,
 		__mkdirOp: mkdirOp,

package/src/realtime-bridge.js

@@ -98,6 +98,7 @@ export class RealtimeBridge {
 		this.__serverHbMissCount = 0;
 		this.__deviceIdentity = null;
 		this.webrtcPeer = null;
+		this.__webrtcPeerReady = null;
 		this.__fileHandler = null;
 	}
 
@@ -196,6 +197,35 @@ export class RealtimeBridge {
 		this.gatewayPendingRequests.clear();
 	}
 
+	/** 懒加载 WebRtcPeer（promise 锁防并发重复创建） */
+	async __initWebrtcPeer() {
+		const { WebRtcPeer } = await import('./webrtc-peer.js');
+		const { createFileHandler } = await import('./file-manager/handler.js');
+		/* c8 ignore start -- 仅通过 WebRTC 路径触发，集成测试覆盖 */
+		this.__fileHandler = createFileHandler({
+			resolveWorkspace: (agentId) => this.__resolveWorkspace(agentId),
+			logger: this.logger,
+		});
+		this.__fileHandler.scheduleTmpCleanup(() => this.__listAgentWorkspaces());
+		/* c8 ignore stop */
+		this.webrtcPeer = new WebRtcPeer({
+			onSend: (msg) => this.__forwardToServer(msg),
+			onRequest: (dcPayload) => {
+				void this.__handleGatewayRequestFromServer(dcPayload);
+			},
+			/* c8 ignore start -- 仅通过 WebRTC 路径触发，集成测试覆盖 */
+			onFileRpc: (payload, sendFn) => {
+				this.__fileHandler.handleRpcRequest(payload, sendFn)
+					.catch((err) => this.logger.warn?.(`[coclaw/file] rpc error: ${err.message}`));
+			},
+			onFileChannel: (dc) => {
+				this.__fileHandler.handleFileChannel(dc);
+			},
+			/* c8 ignore stop */
+			logger: this.logger,
+		});
+	}
+
 	/* c8 ignore next 7 -- 防御性检查，serverWs 通常在调用时可用 */
 	__forwardToServer(payload) {
 		if (!this.serverWs || this.serverWs.readyState !== 1) {
@@ -681,9 +711,12 @@ export class RealtimeBridge {
 		if (!this.started || this.reconnectTimer) {
 			return;
 		}
-		this.reconnectTimer = setTimeout(async () => {
+		this.reconnectTimer = setTimeout(() => {
 			this.reconnectTimer = null;
-			await this.__connectIfNeeded();
+			this.__connectIfNeeded().catch((err) => {
+				/* c8 ignore next -- 防御性兜底，__connectIfNeeded 内部已有完整错误处理 */
+				this.logger.warn?.(`[coclaw] reconnect failed: ${err?.message}`);
+			});
 		}, RECONNECT_MS);
 		this.reconnectTimer.unref?.();
 	}
@@ -754,33 +787,13 @@ export class RealtimeBridge {
 				}
 				if (payload?.type?.startsWith('rtc:')) {
 					try {
-						if (!this.webrtcPeer) {
-							const { WebRtcPeer } = await import('./webrtc-peer.js');
-							const { createFileHandler } = await import('./file-manager/handler.js');
-							/* c8 ignore start -- 仅通过 WebRTC 路径触发，集成测试覆盖 */
-							this.__fileHandler = createFileHandler({
-								resolveWorkspace: (agentId) => this.__resolveWorkspace(agentId),
-								logger: this.logger,
-							});
-							this.__fileHandler.scheduleTmpCleanup(() => this.__listAgentWorkspaces());
-							/* c8 ignore stop */
-							this.webrtcPeer = new WebRtcPeer({
-								onSend: (msg) => this.__forwardToServer(msg),
-								onRequest: (dcPayload) => {
-									void this.__handleGatewayRequestFromServer(dcPayload);
-								},
-								/* c8 ignore start -- 仅通过 WebRTC 路径触发，集成测试覆盖 */
-								onFileRpc: (payload, sendFn) => {
-									this.__fileHandler.handleRpcRequest(payload, sendFn)
-										.catch((err) => this.logger.warn?.(`[coclaw/file] rpc error: ${err.message}`));
-								},
-								onFileChannel: (dc) => {
-									this.__fileHandler.handleFileChannel(dc);
-								},
-								/* c8 ignore stop */
-								logger: this.logger,
+						if (!this.__webrtcPeerReady) {
+							this.__webrtcPeerReady = this.__initWebrtcPeer().catch((err) => {
+								this.__webrtcPeerReady = null;
+								throw err;
 							});
 						}
+						await this.__webrtcPeerReady;
 						await this.webrtcPeer.handleSignaling(payload);
 					} catch (err) {
 						this.logger.warn?.(`[coclaw/rtc] signaling error (or werift not found): ${err?.message}`);
@@ -816,6 +829,7 @@ export class RealtimeBridge {
 				/* c8 ignore next 3 -- 防御性兜底，werift close 异常时不可崩溃 gateway */
 				catch (e) { this.logger.warn?.(`[coclaw/rtc] closeAll failed: ${e?.message}`); }
 				this.webrtcPeer = null;
+				this.__webrtcPeerReady = null;
 			}
 			if (this.__fileHandler) {
 				this.__fileHandler.cancelCleanup();
@@ -882,6 +896,7 @@ export class RealtimeBridge {
 		if (this.webrtcPeer) {
 			await this.webrtcPeer.closeAll().catch(() => {});
 			this.webrtcPeer = null;
+			this.__webrtcPeerReady = null;
 		}
 		if (this.__fileHandler) {
 			this.__fileHandler.cancelCleanup();