@alfe.ai/openclaw-chat 0.0.28 → 0.0.30

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

@@ -517,6 +517,8 @@ function validateAttachmentUrl(input, opts = {}) {
 *     ← onAgentEvent streaming ← (real-time deltas)
 *     ← deliver() callback ← (final response)
 */
+const require$1 = (0, node_module.createRequire)(require("url").pathToFileURL(__filename).href);
+const pkg = require$1("../package.json");
 let dispatchInbound = null;
 /**
 * Resolve OpenClaw SDK functions from the running process.
@@ -527,7 +529,7 @@ let dispatchInbound = null;
 * the global modules path from process.execPath.
 */
 function resolveOpenClawSdk(log) {
-	const anchors = [require.main?.filename, process.argv[1]].filter(Boolean);
+	const anchors = [require$1.main?.filename, process.argv[1]].filter(Boolean);
 	for (const anchor of anchors) try {
 		const channelInbound = (0, node_module.createRequire)(anchor)("openclaw/plugin-sdk/channel-inbound");
 		if (channelInbound.dispatchInboundDirectDmWithRuntime) {
@@ -807,16 +809,20 @@ const plugin = {
 	id: "@alfe.ai/openclaw-chat",
 	name: "Alfe Chat Plugin",
 	description: "Chat conversation channel — web widget and mobile app share unified chat sessions",
-	version: "0.0.8",
+	version: pkg.version,
 	activate(api) {
 		const log = api.logger;
 		const alreadyActivated = globalThis.__alfeChatPluginActivated === true;
 		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 +835,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 +952,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

@@ -6,9 +6,6 @@ import { ChatServiceClient, resolveAlfeChat } from "@alfe.ai/chat";
 import { resolveConfig } from "@alfe.ai/config";
 import { AgentApiClient } from "@alfe.ai/agent-api-client";
 import { existsSync } from "node:fs";
-//#region \0rolldown/runtime.js
-var __require = /* @__PURE__ */ createRequire(import.meta.url);
-//#endregion
 //#region src/alfe-channel.ts
 const CHANNEL_ID = "alfe";
 const DEFAULT_ACCOUNT_ID = "default";
@@ -520,6 +517,8 @@ function validateAttachmentUrl(input, opts = {}) {
 *     ← onAgentEvent streaming ← (real-time deltas)
 *     ← deliver() callback ← (final response)
 */
+const require = createRequire(import.meta.url);
+const pkg = require("../package.json");
 let dispatchInbound = null;
 /**
 * Resolve OpenClaw SDK functions from the running process.
@@ -530,7 +529,7 @@ let dispatchInbound = null;
 * the global modules path from process.execPath.
 */
 function resolveOpenClawSdk(log) {
-	const anchors = [__require.main?.filename, process.argv[1]].filter(Boolean);
+	const anchors = [require.main?.filename, process.argv[1]].filter(Boolean);
 	for (const anchor of anchors) try {
 		const channelInbound = createRequire(anchor)("openclaw/plugin-sdk/channel-inbound");
 		if (channelInbound.dispatchInboundDirectDmWithRuntime) {
@@ -810,16 +809,20 @@ const plugin = {
 	id: "@alfe.ai/openclaw-chat",
 	name: "Alfe Chat Plugin",
 	description: "Chat conversation channel — web widget and mobile app share unified chat sessions",
-	version: "0.0.8",
+	version: pkg.version,
 	activate(api) {
 		const log = api.logger;
 		const alreadyActivated = globalThis.__alfeChatPluginActivated === true;
 		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 +835,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 +952,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/openclaw.plugin.json

@@ -1,7 +1,6 @@
 {
   "id": "@alfe.ai/openclaw-chat",
   "name": "Alfe Chat Plugin",
-  "version": "0.0.21",
   "description": "Chat conversation channel — web widget and mobile app share unified chat sessions",
   "entry": "./dist/plugin.js",
   "configSchema": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alfe.ai/openclaw-chat",
-  "version": "0.0.28",
+  "version": "0.0.30",
   "description": "OpenClaw chat plugin for Alfe — web widget and mobile app channels",
   "type": "module",
   "main": "./dist/plugin.js",