@alfe.ai/openclaw-chat 0.0.27 → 0.0.29

package/dist/plugin.d.cts

@@ -220,6 +220,12 @@ interface AgentEventPayload {
   data: Record<string, unknown>;
   sessionKey?: string;
 }
+interface PluginServiceContext {
+  config: Record<string, unknown>;
+  workspaceDir?: string;
+  stateDir: string;
+  logger: PluginLogger;
+}
 interface PluginApi {
   logger: PluginLogger;
   registrationMode?: 'full' | 'setup-only' | 'setup-runtime' | 'cli-metadata';
@@ -234,6 +240,11 @@ interface PluginApi {
     execute: (toolCallId: string, params: Record<string, unknown>) => Promise<unknown>;
   }): void;
   registerGatewayMethod?(name: string, handler: (...args: unknown[]) => Promise<unknown>): void;
+  registerService?(service: {
+    id: string;
+    start: (ctx: PluginServiceContext) => void | Promise<void>;
+    stop?: (ctx: PluginServiceContext) => void | Promise<void>;
+  }): void;
   on(event: string, handler: (...args: unknown[]) => void | Promise<void>, options?: {
     priority?: number;
   }): void;

package/dist/plugin.d.ts

@@ -220,6 +220,12 @@ interface AgentEventPayload {
   data: Record<string, unknown>;
   sessionKey?: string;
 }
+interface PluginServiceContext {
+  config: Record<string, unknown>;
+  workspaceDir?: string;
+  stateDir: string;
+  logger: PluginLogger;
+}
 interface PluginApi {
   logger: PluginLogger;
   registrationMode?: 'full' | 'setup-only' | 'setup-runtime' | 'cli-metadata';
@@ -234,6 +240,11 @@ interface PluginApi {
     execute: (toolCallId: string, params: Record<string, unknown>) => Promise<unknown>;
   }): void;
   registerGatewayMethod?(name: string, handler: (...args: unknown[]) => Promise<unknown>): void;
+  registerService?(service: {
+    id: string;
+    start: (ctx: PluginServiceContext) => void | Promise<void>;
+    stop?: (ctx: PluginServiceContext) => void | Promise<void>;
+  }): void;
   on(event: string, handler: (...args: unknown[]) => void | Promise<void>, options?: {
     priority?: number;
   }): void;

package/dist/plugin2.cjs

@@ -814,9 +814,13 @@ const plugin = {
 		const alfeChannel = createAlfeChannelPlugin();
 		api.registerChannel(alfeChannel);
 		log.info(`Registered channel: ${alfeChannel.id}`);
-		if (api.registrationMode && api.registrationMode !== "full") return;
-		globalThis.__alfeChatPluginActivated = true;
-		if (!alreadyActivated) {
+		const pluginConfig = (((api.config ?? {}).plugins?.entries)?.["@alfe.ai/openclaw-chat"] ?? {}).config ?? {};
+		const startChatService = () => {
+			if (globalThis.__alfeChatPluginActivated === true) {
+				log.debug("Chat plugin already activated — skipping duplicate");
+				return;
+			}
+			globalThis.__alfeChatPluginActivated = true;
 			log.info("Chat plugin registering...");
 			resolveOpenClawSdk(log);
 			pluginRuntime = api.runtime ?? null;
@@ -829,44 +833,88 @@ const plugin = {
 			} catch {
 				log.debug("Metrics client not initialized — activity tracking disabled");
 			}
-		}
-		const pluginConfig = (((api.config ?? {}).plugins?.entries)?.["@alfe.ai/openclaw-chat"] ?? {}).config ?? {};
-		if (!alreadyActivated) connectingPromise = Promise.resolve().then(() => {
-			try {
-				const { apiKey, chatWsUrl } = (0, _alfe_ai_chat.resolveAlfeChat)({
-					apiKey: pluginConfig.apiKey,
-					chatWsUrl: pluginConfig.chatWsUrl
-				});
-				if (chatWsUrl && apiKey) {
-					log.info(`Connecting to chat service: ${chatWsUrl}`);
-					chatClient = new _alfe_ai_chat.ChatServiceClient({
-						wsUrl: chatWsUrl,
-						apiKey,
-						onRequest: (request) => {
-							const handle = async () => {
-								if (request.method === "agent") await handleAgentRequest(request, log);
-								else if (request.method === "sessions.list") await handleSessionsList(request, log);
-								else if (request.method === "sessions.get") await handleSessionsGet(request, log);
-								else chatClient?.sendResponse(request.id, false, { message: `Unknown method: ${request.method}` });
-							};
-							handle().catch((err) => {
-								const errMsg = err instanceof Error ? err.message : String(err);
-								log.error(`Request handler crashed: ${errMsg}`);
-								chatClient?.sendResponse(request.id, false, { message: "Internal error" });
-							});
-						},
-						onConnectionChange: (connected) => {
-							log.info(`Chat service connection: ${connected ? "connected" : "disconnected"}`);
-						},
-						logger: log
+			connectingPromise = Promise.resolve().then(() => {
+				try {
+					const { apiKey, chatWsUrl } = (0, _alfe_ai_chat.resolveAlfeChat)({
+						apiKey: pluginConfig.apiKey,
+						chatWsUrl: pluginConfig.chatWsUrl
 					});
-					chatClient.start();
-					log.info("Chat service relay started");
-				} else log.info("Chat service URL not configured — running without chat service relay");
-			} catch (err) {
-				log.error(`Failed to initialize chat service: ${err instanceof Error ? err.message : String(err)}`);
+					if (chatWsUrl && apiKey) {
+						log.info(`Connecting to chat service: ${chatWsUrl}`);
+						chatClient = new _alfe_ai_chat.ChatServiceClient({
+							wsUrl: chatWsUrl,
+							apiKey,
+							onRequest: (request) => {
+								const handle = async () => {
+									if (request.method === "agent") await handleAgentRequest(request, log);
+									else if (request.method === "sessions.list") await handleSessionsList(request, log);
+									else if (request.method === "sessions.get") await handleSessionsGet(request, log);
+									else chatClient?.sendResponse(request.id, false, { message: `Unknown method: ${request.method}` });
+								};
+								handle().catch((err) => {
+									const errMsg = err instanceof Error ? err.message : String(err);
+									log.error(`Request handler crashed: ${errMsg}`);
+									chatClient?.sendResponse(request.id, false, { message: "Internal error" });
+								});
+							},
+							onConnectionChange: (connected) => {
+								log.info(`Chat service connection: ${connected ? "connected" : "disconnected"}`);
+							},
+							logger: log
+						});
+						chatClient.start();
+						log.info("Chat service relay started");
+					} else log.info("Chat service URL not configured — running without chat service relay");
+				} catch (err) {
+					log.error(`Failed to initialize chat service: ${err instanceof Error ? err.message : String(err)}`);
+				}
+			});
+			if (typeof api.registerTool === "function") connectingPromise.then(() => {
+				if (chatClient && typeof api.registerTool === "function") {
+					const a2aTools = buildA2ATools(chatClient, log);
+					for (const tool of a2aTools) api.registerTool(tool);
+					log.info(`Registered ${String(a2aTools.length)} agent-to-agent tools`);
+				}
+			}).catch(() => {});
+			api.on("session_start", async (...eventArgs) => {
+				if (!pluginRuntime) return;
+				const key = eventArgs[0].sessionKey;
+				if (!key || isAlfeSessionKey(key)) return;
+				log.info(`Chat session starting: ${key}`);
+				await createSession(key, "", "alfe");
+			}, { priority: 50 });
+			api.on("message_received", async (...eventArgs) => {
+				if (!pluginRuntime) return;
+				const event = eventArgs[0];
+				const ctx = eventArgs[1];
+				if (!ctx.conversationId || ctx.channelId === "alfe") return;
+				await addMessage(ctx.conversationId, "user", event.content, event.from);
+			});
+			api.on("session_end", (...eventArgs) => {
+				if (!pluginRuntime) return;
+				const key = eventArgs[0].sessionKey;
+				if (!key || !isAlfeSessionKey(key)) return;
+				log.info(`Chat session ending: ${key}`);
+			});
+		};
+		const stopChatService = async () => {
+			globalThis.__alfeChatPluginActivated = false;
+			if (connectingPromise) {
+				await connectingPromise.catch((err) => {
+					log.debug(`Connection attempt failed: ${err instanceof Error ? err.message : String(err)}`);
+				});
+				connectingPromise = null;
 			}
-		});
+			if (chatClient) {
+				chatClient.stop();
+				chatClient = null;
+				log.info("Chat service client stopped");
+			}
+			pluginRuntime = null;
+			dispatchInbound = null;
+			metricsClient = null;
+			log.info("Chat plugin deactivated");
+		};
 		if (typeof api.registerGatewayMethod === "function") {
 			api.registerGatewayMethod("sessions.list", async (...args) => {
 				const params = args[0];
@@ -902,35 +950,16 @@ const plugin = {
 			});
 			log.info("Registered gateway RPC methods: sessions.list, sessions.get");
 		}
-		if (!alreadyActivated && typeof api.registerTool === "function") connectingPromise?.then(() => {
-			if (chatClient && typeof api.registerTool === "function") {
-				const a2aTools = buildA2ATools(chatClient, log);
-				for (const tool of a2aTools) api.registerTool(tool);
-				log.info(`Registered ${String(a2aTools.length)} agent-to-agent tools`);
+		if (api.registerService) api.registerService({
+			id: "alfe-chat-relay",
+			start: () => {
+				startChatService();
+			},
+			stop: async () => {
+				await stopChatService();
 			}
-		}).catch(() => {});
-		if (!alreadyActivated) {
-			api.on("session_start", async (...eventArgs) => {
-				if (!pluginRuntime) return;
-				const key = eventArgs[0].sessionKey;
-				if (!key || isAlfeSessionKey(key)) return;
-				log.info(`Chat session starting: ${key}`);
-				await createSession(key, "", "alfe");
-			}, { priority: 50 });
-			api.on("message_received", async (...eventArgs) => {
-				if (!pluginRuntime) return;
-				const event = eventArgs[0];
-				const ctx = eventArgs[1];
-				if (!ctx.conversationId || ctx.channelId === "alfe") return;
-				await addMessage(ctx.conversationId, "user", event.content, event.from);
-			});
-			api.on("session_end", (...eventArgs) => {
-				if (!pluginRuntime) return;
-				const key = eventArgs[0].sessionKey;
-				if (!key || !isAlfeSessionKey(key)) return;
-				log.info(`Chat session ending: ${key}`);
-			});
-		}
+		});
+		else if (!alreadyActivated) startChatService();
 		log.info("Chat plugin registered");
 	},
 	async deactivate(api) {

package/dist/plugin2.js

@@ -817,9 +817,13 @@ const plugin = {
 		const alfeChannel = createAlfeChannelPlugin();
 		api.registerChannel(alfeChannel);
 		log.info(`Registered channel: ${alfeChannel.id}`);
-		if (api.registrationMode && api.registrationMode !== "full") return;
-		globalThis.__alfeChatPluginActivated = true;
-		if (!alreadyActivated) {
+		const pluginConfig = (((api.config ?? {}).plugins?.entries)?.["@alfe.ai/openclaw-chat"] ?? {}).config ?? {};
+		const startChatService = () => {
+			if (globalThis.__alfeChatPluginActivated === true) {
+				log.debug("Chat plugin already activated — skipping duplicate");
+				return;
+			}
+			globalThis.__alfeChatPluginActivated = true;
 			log.info("Chat plugin registering...");
 			resolveOpenClawSdk(log);
 			pluginRuntime = api.runtime ?? null;
@@ -832,44 +836,88 @@ const plugin = {
 			} catch {
 				log.debug("Metrics client not initialized — activity tracking disabled");
 			}
-		}
-		const pluginConfig = (((api.config ?? {}).plugins?.entries)?.["@alfe.ai/openclaw-chat"] ?? {}).config ?? {};
-		if (!alreadyActivated) connectingPromise = Promise.resolve().then(() => {
-			try {
-				const { apiKey, chatWsUrl } = resolveAlfeChat({
-					apiKey: pluginConfig.apiKey,
-					chatWsUrl: pluginConfig.chatWsUrl
-				});
-				if (chatWsUrl && apiKey) {
-					log.info(`Connecting to chat service: ${chatWsUrl}`);
-					chatClient = new ChatServiceClient({
-						wsUrl: chatWsUrl,
-						apiKey,
-						onRequest: (request) => {
-							const handle = async () => {
-								if (request.method === "agent") await handleAgentRequest(request, log);
-								else if (request.method === "sessions.list") await handleSessionsList(request, log);
-								else if (request.method === "sessions.get") await handleSessionsGet(request, log);
-								else chatClient?.sendResponse(request.id, false, { message: `Unknown method: ${request.method}` });
-							};
-							handle().catch((err) => {
-								const errMsg = err instanceof Error ? err.message : String(err);
-								log.error(`Request handler crashed: ${errMsg}`);
-								chatClient?.sendResponse(request.id, false, { message: "Internal error" });
-							});
-						},
-						onConnectionChange: (connected) => {
-							log.info(`Chat service connection: ${connected ? "connected" : "disconnected"}`);
-						},
-						logger: log
+			connectingPromise = Promise.resolve().then(() => {
+				try {
+					const { apiKey, chatWsUrl } = resolveAlfeChat({
+						apiKey: pluginConfig.apiKey,
+						chatWsUrl: pluginConfig.chatWsUrl
 					});
-					chatClient.start();
-					log.info("Chat service relay started");
-				} else log.info("Chat service URL not configured — running without chat service relay");
-			} catch (err) {
-				log.error(`Failed to initialize chat service: ${err instanceof Error ? err.message : String(err)}`);
+					if (chatWsUrl && apiKey) {
+						log.info(`Connecting to chat service: ${chatWsUrl}`);
+						chatClient = new ChatServiceClient({
+							wsUrl: chatWsUrl,
+							apiKey,
+							onRequest: (request) => {
+								const handle = async () => {
+									if (request.method === "agent") await handleAgentRequest(request, log);
+									else if (request.method === "sessions.list") await handleSessionsList(request, log);
+									else if (request.method === "sessions.get") await handleSessionsGet(request, log);
+									else chatClient?.sendResponse(request.id, false, { message: `Unknown method: ${request.method}` });
+								};
+								handle().catch((err) => {
+									const errMsg = err instanceof Error ? err.message : String(err);
+									log.error(`Request handler crashed: ${errMsg}`);
+									chatClient?.sendResponse(request.id, false, { message: "Internal error" });
+								});
+							},
+							onConnectionChange: (connected) => {
+								log.info(`Chat service connection: ${connected ? "connected" : "disconnected"}`);
+							},
+							logger: log
+						});
+						chatClient.start();
+						log.info("Chat service relay started");
+					} else log.info("Chat service URL not configured — running without chat service relay");
+				} catch (err) {
+					log.error(`Failed to initialize chat service: ${err instanceof Error ? err.message : String(err)}`);
+				}
+			});
+			if (typeof api.registerTool === "function") connectingPromise.then(() => {
+				if (chatClient && typeof api.registerTool === "function") {
+					const a2aTools = buildA2ATools(chatClient, log);
+					for (const tool of a2aTools) api.registerTool(tool);
+					log.info(`Registered ${String(a2aTools.length)} agent-to-agent tools`);
+				}
+			}).catch(() => {});
+			api.on("session_start", async (...eventArgs) => {
+				if (!pluginRuntime) return;
+				const key = eventArgs[0].sessionKey;
+				if (!key || isAlfeSessionKey(key)) return;
+				log.info(`Chat session starting: ${key}`);
+				await createSession(key, "", "alfe");
+			}, { priority: 50 });
+			api.on("message_received", async (...eventArgs) => {
+				if (!pluginRuntime) return;
+				const event = eventArgs[0];
+				const ctx = eventArgs[1];
+				if (!ctx.conversationId || ctx.channelId === "alfe") return;
+				await addMessage(ctx.conversationId, "user", event.content, event.from);
+			});
+			api.on("session_end", (...eventArgs) => {
+				if (!pluginRuntime) return;
+				const key = eventArgs[0].sessionKey;
+				if (!key || !isAlfeSessionKey(key)) return;
+				log.info(`Chat session ending: ${key}`);
+			});
+		};
+		const stopChatService = async () => {
+			globalThis.__alfeChatPluginActivated = false;
+			if (connectingPromise) {
+				await connectingPromise.catch((err) => {
+					log.debug(`Connection attempt failed: ${err instanceof Error ? err.message : String(err)}`);
+				});
+				connectingPromise = null;
 			}
-		});
+			if (chatClient) {
+				chatClient.stop();
+				chatClient = null;
+				log.info("Chat service client stopped");
+			}
+			pluginRuntime = null;
+			dispatchInbound = null;
+			metricsClient = null;
+			log.info("Chat plugin deactivated");
+		};
 		if (typeof api.registerGatewayMethod === "function") {
 			api.registerGatewayMethod("sessions.list", async (...args) => {
 				const params = args[0];
@@ -905,35 +953,16 @@ const plugin = {
 			});
 			log.info("Registered gateway RPC methods: sessions.list, sessions.get");
 		}
-		if (!alreadyActivated && typeof api.registerTool === "function") connectingPromise?.then(() => {
-			if (chatClient && typeof api.registerTool === "function") {
-				const a2aTools = buildA2ATools(chatClient, log);
-				for (const tool of a2aTools) api.registerTool(tool);
-				log.info(`Registered ${String(a2aTools.length)} agent-to-agent tools`);
+		if (api.registerService) api.registerService({
+			id: "alfe-chat-relay",
+			start: () => {
+				startChatService();
+			},
+			stop: async () => {
+				await stopChatService();
 			}
-		}).catch(() => {});
-		if (!alreadyActivated) {
-			api.on("session_start", async (...eventArgs) => {
-				if (!pluginRuntime) return;
-				const key = eventArgs[0].sessionKey;
-				if (!key || isAlfeSessionKey(key)) return;
-				log.info(`Chat session starting: ${key}`);
-				await createSession(key, "", "alfe");
-			}, { priority: 50 });
-			api.on("message_received", async (...eventArgs) => {
-				if (!pluginRuntime) return;
-				const event = eventArgs[0];
-				const ctx = eventArgs[1];
-				if (!ctx.conversationId || ctx.channelId === "alfe") return;
-				await addMessage(ctx.conversationId, "user", event.content, event.from);
-			});
-			api.on("session_end", (...eventArgs) => {
-				if (!pluginRuntime) return;
-				const key = eventArgs[0].sessionKey;
-				if (!key || !isAlfeSessionKey(key)) return;
-				log.info(`Chat session ending: ${key}`);
-			});
-		}
+		});
+		else if (!alreadyActivated) startChatService();
 		log.info("Chat plugin registered");
 	},
 	async deactivate(api) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alfe.ai/openclaw-chat",
-  "version": "0.0.27",
+  "version": "0.0.29",
   "description": "OpenClaw chat plugin for Alfe — web widget and mobile app channels",
   "type": "module",
   "main": "./dist/plugin.js",
@@ -27,7 +27,7 @@
     "openclaw.plugin.json"
   ],
   "dependencies": {
-    "@alfe.ai/agent-api-client": "^0.0.9",
+    "@alfe.ai/agent-api-client": "^0.0.10",
     "@alfe.ai/chat": "^0.0.8",
     "@alfe.ai/config": "^0.0.8"
   },