@alfe.ai/openclaw-chat 0.0.17 → 0.0.19

package/dist/plugin2.cjs

@@ -1,8 +1,10 @@
 let node_module = require("node:module");
-let _alfe_ai_chat = require("@alfe.ai/chat");
 let node_fs_promises = require("node:fs/promises");
 let node_path = require("node:path");
 let node_os = require("node:os");
+let _alfe_ai_chat = require("@alfe.ai/chat");
+let _alfe_ai_config = require("@alfe.ai/config");
+let _alfe_ai_agent_api_client = require("@alfe.ai/agent-api-client");
 let node_fs = require("node:fs");
 //#region src/alfe-channel.ts
 const CHANNEL_ID = "alfe";
@@ -138,31 +140,6 @@ function createAlfeChannelPlugin() {
 //#endregion
 //#region src/session-keys.ts
 /**
-* Session key helpers — handles standardized, canonical, and legacy formats.
-*
-* Standardized format (Alfe-controlled):
-*   alfe:{mode}:{identity}              — single-threaded (SMS, WhatsApp)
-*   alfe:{mode}:{identity}:{convId}     — multi-threaded (web chat)
-*
-* Wrapped standardized format (from chat inject via callAgent):
-*   agent:{ocAgentId}:alfe:{mode}:{identity}
-*
-* OpenClaw canonical format (from resolveAgentRoute):
-*   agent:{ocAgentId}:alfe:[default:]direct:{senderId}[:thread:{conversationId}]
-*
-* Legacy formats (deprecated):
-*   sms-{agentId}-{phone}
-*   wa-{agentId}-{phone}
-*   chat-{tenantId}-{agentId}-{suffix}
-*   agent:{agentId}:chat-{tenantId}-{agentId}-{suffix}
-*/
-/** Single-threaded channel modes — identity IS the conversation. */
-const SINGLE_THREADED_MODES = new Set([
-	"sms",
-	"whatsapp",
-	"mobile"
-]);
-/**
 * Check if a session key belongs to the Alfe chat channel.
 * Handles standardized, canonical, and legacy formats.
 */
@@ -173,87 +150,6 @@ function isAlfeSessionKey(key) {
 	return false;
 }
 /**
-* Parse session key metadata. Returns available fields from any format.
-*
-* For the callback flow, `conversationId` is the critical field — it maps
-* to the channel registry key used by getChannelCallback().
-*/
-function parseAlfeSessionKey(key) {
-	const standardMatch = /^alfe:(\w+):(.+)$/.exec(key);
-	if (standardMatch) {
-		const [, mode, rest] = standardMatch;
-		if (SINGLE_THREADED_MODES.has(mode)) return {
-			agentId: "",
-			userId: rest,
-			conversationId: key,
-			tenantId: "",
-			mode
-		};
-		const lastColon = rest.lastIndexOf(":");
-		if (lastColon > 0) return {
-			agentId: "",
-			userId: rest.slice(0, lastColon),
-			conversationId: key,
-			tenantId: "",
-			mode
-		};
-		return {
-			agentId: "",
-			userId: rest,
-			conversationId: key,
-			tenantId: "",
-			mode
-		};
-	}
-	const wrappedStandardMatch = /^agent:([^:]+):alfe:(?!default:|direct:)(\w+):(.+)$/.exec(key);
-	if (wrappedStandardMatch) {
-		const [, matchAgentId, wrappedMode, rest] = wrappedStandardMatch;
-		const standardKey = `alfe:${wrappedMode}:${rest}`;
-		if (SINGLE_THREADED_MODES.has(wrappedMode)) return {
-			agentId: matchAgentId,
-			userId: rest,
-			conversationId: standardKey,
-			tenantId: "",
-			mode: wrappedMode
-		};
-		const lastColon = rest.lastIndexOf(":");
-		if (lastColon > 0) return {
-			agentId: matchAgentId,
-			userId: rest.slice(0, lastColon),
-			conversationId: standardKey,
-			tenantId: "",
-			mode: wrappedMode
-		};
-		return {
-			agentId: matchAgentId,
-			userId: rest,
-			conversationId: standardKey,
-			tenantId: "",
-			mode: wrappedMode
-		};
-	}
-	const canonicalMatch = /^agent:([^:]+):alfe:(?:default:)?direct:(.+?)(?::thread:(.+))?$/.exec(key);
-	if (canonicalMatch) {
-		const [, matchAgentId, matchUserId, matchConvId] = canonicalMatch;
-		return {
-			agentId: matchAgentId,
-			userId: matchUserId,
-			conversationId: matchConvId || "",
-			tenantId: "",
-			mode: ""
-		};
-	}
-	const rawKey = key.includes(":") ? key.slice(key.lastIndexOf(":") + 1) : key;
-	const legacyMatch = /^chat-([^-]+)-([^-]+)/.exec(rawKey);
-	return {
-		agentId: legacyMatch?.[2] ?? "",
-		userId: "",
-		conversationId: "",
-		tenantId: legacyMatch?.[1] ?? "",
-		mode: "chat"
-	};
-}
-/**
 * Extract the channel mode from a standardized session key or conversationId.
 * Returns the mode segment (e.g. 'sms', 'whatsapp', 'chat') or fallback.
 */
@@ -428,6 +324,34 @@ function resolveOpenClawSdk(log) {
 let pluginRuntime = null;
 let chatClient = null;
 let connectingPromise = null;
+let metricsClient = null;
+async function downloadAttachments(attachments, log) {
+	const attachDir = (0, node_path.join)((0, node_os.homedir)(), ".alfe", "attachments");
+	await (0, node_fs_promises.mkdir)(attachDir, { recursive: true });
+	const results = [];
+	for (const att of attachments) {
+		const filename = att.filename ?? att.id;
+		const localPath = (0, node_path.join)(attachDir, `${att.id}_${filename}`);
+		try {
+			const res = await fetch(att.url);
+			if (!res.ok) {
+				log.warn(`Failed to download attachment ${att.id}: ${String(res.status)}`);
+				continue;
+			}
+			const buffer = Buffer.from(await res.arrayBuffer());
+			await (0, node_fs_promises.writeFile)(localPath, buffer);
+			results.push({
+				localPath,
+				filename,
+				mimeType: att.mimeType
+			});
+			log.info(`Downloaded attachment: ${localPath} (${String(buffer.length)} bytes)`);
+		} catch (err) {
+			log.error(`Failed to download attachment ${att.id}: ${err instanceof Error ? err.message : String(err)}`);
+		}
+	}
+	return results;
+}
 async function handleAgentRequest(request, log) {
 	const runtime = pluginRuntime;
 	if (!runtime) {
@@ -438,8 +362,8 @@ async function handleAgentRequest(request, log) {
 		chatClient?.sendResponse(request.id, false, { message: "OpenClaw SDK not available — cannot dispatch" });
 		return;
 	}
-	const { message, sessionKey: legacySessionKey, userId, conversationId, conversationType, tenantId, clientType, displayName } = request.params;
-	if (!message) {
+	const { message, sessionKey: legacySessionKey, userId, conversationId, conversationType, tenantId, clientType, displayName, attachments: rawAttachments } = request.params;
+	if (!message && !rawAttachments?.length) {
 		chatClient?.sendResponse(request.id, false, { message: "Missing message" });
 		return;
 	}
@@ -463,6 +387,8 @@ async function handleAgentRequest(request, log) {
 		});
 	});
 	try {
+		const downloadedFiles = rawAttachments?.length ? await downloadAttachments(rawAttachments, log) : [];
+		const bodyForAgent = downloadedFiles.length ? `${message || ""}\n\n[Attached files:\n${downloadedFiles.map((f) => `- ${f.filename}: ${f.localPath}`).join("\n")}]` : void 0;
 		const channelMode = extractChannelMode(conversationId ?? "", clientType ?? "chat");
 		const channelLabel = channelMode === "sms" ? "SMS" : channelMode === "whatsapp" ? "WhatsApp" : "Alfe";
 		const shortConvId = conversationId?.slice(-8) ?? "";
@@ -485,7 +411,8 @@ async function handleAgentRequest(request, log) {
 			senderAddress: `user:${senderId}`,
 			recipientAddress: "agent",
 			conversationLabel,
-			rawBody: message,
+			rawBody: message || "",
+			bodyForAgent,
 			messageId: request.id,
 			timestamp: Date.now(),
 			extraContext: {
@@ -497,10 +424,20 @@ async function handleAgentRequest(request, log) {
 			},
 			deliver: async (payload) => {
 				const responseText = payload.text ?? "";
+				const mediaUrls = [...payload.mediaUrl ? [payload.mediaUrl] : [], ...payload.mediaUrls ?? []];
 				await addMessage(sessionId, "assistant", responseText);
-				chatClient?.sendResponse(request.id, true, {
+				chatClient?.notify("agent-message", {
+					conversationId: conversationId ?? legacySessionKey,
 					text: responseText,
-					sessionKey: resolvedOpenClawKey ?? legacySessionKey
+					sessionKey: resolvedOpenClawKey ?? legacySessionKey,
+					...mediaUrls.length ? { mediaUrls } : {}
+				});
+				if (metricsClient && userId) metricsClient.recordActivity({
+					userId,
+					channel: "alfe",
+					role: "assistant"
+				}).catch((err) => {
+					log.debug(`Metrics report failed: ${err instanceof Error ? err.message : String(err)}`);
 				});
 			},
 			onRecordError: (err) => {
@@ -510,6 +447,7 @@ async function handleAgentRequest(request, log) {
 				log.error(`Dispatch error (${info.kind}): ${err instanceof Error ? err.message : String(err)}`);
 			}
 		})).route.sessionKey;
+		chatClient?.sendResponse(request.id, true, { sessionKey: resolvedOpenClawKey });
 		log.info(`Agent dispatch complete: sessionKey=${resolvedOpenClawKey}`);
 	} catch (err) {
 		const errMsg = err instanceof Error ? err.message : String(err);
@@ -586,6 +524,15 @@ const plugin = {
 			log.info("Chat plugin registering...");
 			resolveOpenClawSdk(log);
 			pluginRuntime = api.runtime ?? null;
+			try {
+				const cfg = (0, _alfe_ai_config.resolveConfig)();
+				metricsClient = new _alfe_ai_agent_api_client.AgentApiClient({
+					apiKey: cfg.apiKey,
+					apiUrl: cfg.apiUrl
+				});
+			} 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(() => {
@@ -659,19 +606,11 @@ const plugin = {
 				log.info(`Chat session starting: ${key}`);
 				await createSession(key, "", "alfe");
 			}, { priority: 50 });
-			api.on("message", async (...eventArgs) => {
+			api.on("message_received", async (...eventArgs) => {
 				const event = eventArgs[0];
-				const key = event.sessionKey;
-				if (!key) return;
-				if (isAlfeSessionKey(key)) {
-					if (event.role === "assistant" && chatClient) {
-						const parsed = parseAlfeSessionKey(key);
-						if (parsed.conversationId) chatClient.notify("agent-message", {
-							conversationId: parsed.conversationId,
-							text: event.content
-						});
-					}
-				} else await addMessage(key, event.role, event.content);
+				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) => {
 				const key = eventArgs[0].sessionKey;
@@ -698,6 +637,7 @@ const plugin = {
 		}
 		pluginRuntime = null;
 		dispatchInbound = null;
+		metricsClient = null;
 		log.info("Chat plugin deactivated");
 	}
 };

package/dist/plugin2.js

@@ -1,8 +1,10 @@
 import { createRequire } from "node:module";
-import { ChatServiceClient, resolveAlfeChat } from "@alfe.ai/chat";
 import { mkdir, readFile, readdir, stat, unlink, writeFile } from "node:fs/promises";
 import { join } from "node:path";
 import { homedir } from "node:os";
+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 src/alfe-channel.ts
 const CHANNEL_ID = "alfe";
@@ -138,31 +140,6 @@ function createAlfeChannelPlugin() {
 //#endregion
 //#region src/session-keys.ts
 /**
-* Session key helpers — handles standardized, canonical, and legacy formats.
-*
-* Standardized format (Alfe-controlled):
-*   alfe:{mode}:{identity}              — single-threaded (SMS, WhatsApp)
-*   alfe:{mode}:{identity}:{convId}     — multi-threaded (web chat)
-*
-* Wrapped standardized format (from chat inject via callAgent):
-*   agent:{ocAgentId}:alfe:{mode}:{identity}
-*
-* OpenClaw canonical format (from resolveAgentRoute):
-*   agent:{ocAgentId}:alfe:[default:]direct:{senderId}[:thread:{conversationId}]
-*
-* Legacy formats (deprecated):
-*   sms-{agentId}-{phone}
-*   wa-{agentId}-{phone}
-*   chat-{tenantId}-{agentId}-{suffix}
-*   agent:{agentId}:chat-{tenantId}-{agentId}-{suffix}
-*/
-/** Single-threaded channel modes — identity IS the conversation. */
-const SINGLE_THREADED_MODES = new Set([
-	"sms",
-	"whatsapp",
-	"mobile"
-]);
-/**
 * Check if a session key belongs to the Alfe chat channel.
 * Handles standardized, canonical, and legacy formats.
 */
@@ -173,87 +150,6 @@ function isAlfeSessionKey(key) {
 	return false;
 }
 /**
-* Parse session key metadata. Returns available fields from any format.
-*
-* For the callback flow, `conversationId` is the critical field — it maps
-* to the channel registry key used by getChannelCallback().
-*/
-function parseAlfeSessionKey(key) {
-	const standardMatch = /^alfe:(\w+):(.+)$/.exec(key);
-	if (standardMatch) {
-		const [, mode, rest] = standardMatch;
-		if (SINGLE_THREADED_MODES.has(mode)) return {
-			agentId: "",
-			userId: rest,
-			conversationId: key,
-			tenantId: "",
-			mode
-		};
-		const lastColon = rest.lastIndexOf(":");
-		if (lastColon > 0) return {
-			agentId: "",
-			userId: rest.slice(0, lastColon),
-			conversationId: key,
-			tenantId: "",
-			mode
-		};
-		return {
-			agentId: "",
-			userId: rest,
-			conversationId: key,
-			tenantId: "",
-			mode
-		};
-	}
-	const wrappedStandardMatch = /^agent:([^:]+):alfe:(?!default:|direct:)(\w+):(.+)$/.exec(key);
-	if (wrappedStandardMatch) {
-		const [, matchAgentId, wrappedMode, rest] = wrappedStandardMatch;
-		const standardKey = `alfe:${wrappedMode}:${rest}`;
-		if (SINGLE_THREADED_MODES.has(wrappedMode)) return {
-			agentId: matchAgentId,
-			userId: rest,
-			conversationId: standardKey,
-			tenantId: "",
-			mode: wrappedMode
-		};
-		const lastColon = rest.lastIndexOf(":");
-		if (lastColon > 0) return {
-			agentId: matchAgentId,
-			userId: rest.slice(0, lastColon),
-			conversationId: standardKey,
-			tenantId: "",
-			mode: wrappedMode
-		};
-		return {
-			agentId: matchAgentId,
-			userId: rest,
-			conversationId: standardKey,
-			tenantId: "",
-			mode: wrappedMode
-		};
-	}
-	const canonicalMatch = /^agent:([^:]+):alfe:(?:default:)?direct:(.+?)(?::thread:(.+))?$/.exec(key);
-	if (canonicalMatch) {
-		const [, matchAgentId, matchUserId, matchConvId] = canonicalMatch;
-		return {
-			agentId: matchAgentId,
-			userId: matchUserId,
-			conversationId: matchConvId || "",
-			tenantId: "",
-			mode: ""
-		};
-	}
-	const rawKey = key.includes(":") ? key.slice(key.lastIndexOf(":") + 1) : key;
-	const legacyMatch = /^chat-([^-]+)-([^-]+)/.exec(rawKey);
-	return {
-		agentId: legacyMatch?.[2] ?? "",
-		userId: "",
-		conversationId: "",
-		tenantId: legacyMatch?.[1] ?? "",
-		mode: "chat"
-	};
-}
-/**
 * Extract the channel mode from a standardized session key or conversationId.
 * Returns the mode segment (e.g. 'sms', 'whatsapp', 'chat') or fallback.
 */
@@ -428,6 +324,34 @@ function resolveOpenClawSdk(log) {
 let pluginRuntime = null;
 let chatClient = null;
 let connectingPromise = null;
+let metricsClient = null;
+async function downloadAttachments(attachments, log) {
+	const attachDir = join(homedir(), ".alfe", "attachments");
+	await mkdir(attachDir, { recursive: true });
+	const results = [];
+	for (const att of attachments) {
+		const filename = att.filename ?? att.id;
+		const localPath = join(attachDir, `${att.id}_${filename}`);
+		try {
+			const res = await fetch(att.url);
+			if (!res.ok) {
+				log.warn(`Failed to download attachment ${att.id}: ${String(res.status)}`);
+				continue;
+			}
+			const buffer = Buffer.from(await res.arrayBuffer());
+			await writeFile(localPath, buffer);
+			results.push({
+				localPath,
+				filename,
+				mimeType: att.mimeType
+			});
+			log.info(`Downloaded attachment: ${localPath} (${String(buffer.length)} bytes)`);
+		} catch (err) {
+			log.error(`Failed to download attachment ${att.id}: ${err instanceof Error ? err.message : String(err)}`);
+		}
+	}
+	return results;
+}
 async function handleAgentRequest(request, log) {
 	const runtime = pluginRuntime;
 	if (!runtime) {
@@ -438,8 +362,8 @@ async function handleAgentRequest(request, log) {
 		chatClient?.sendResponse(request.id, false, { message: "OpenClaw SDK not available — cannot dispatch" });
 		return;
 	}
-	const { message, sessionKey: legacySessionKey, userId, conversationId, conversationType, tenantId, clientType, displayName } = request.params;
-	if (!message) {
+	const { message, sessionKey: legacySessionKey, userId, conversationId, conversationType, tenantId, clientType, displayName, attachments: rawAttachments } = request.params;
+	if (!message && !rawAttachments?.length) {
 		chatClient?.sendResponse(request.id, false, { message: "Missing message" });
 		return;
 	}
@@ -463,6 +387,8 @@ async function handleAgentRequest(request, log) {
 		});
 	});
 	try {
+		const downloadedFiles = rawAttachments?.length ? await downloadAttachments(rawAttachments, log) : [];
+		const bodyForAgent = downloadedFiles.length ? `${message || ""}\n\n[Attached files:\n${downloadedFiles.map((f) => `- ${f.filename}: ${f.localPath}`).join("\n")}]` : void 0;
 		const channelMode = extractChannelMode(conversationId ?? "", clientType ?? "chat");
 		const channelLabel = channelMode === "sms" ? "SMS" : channelMode === "whatsapp" ? "WhatsApp" : "Alfe";
 		const shortConvId = conversationId?.slice(-8) ?? "";
@@ -485,7 +411,8 @@ async function handleAgentRequest(request, log) {
 			senderAddress: `user:${senderId}`,
 			recipientAddress: "agent",
 			conversationLabel,
-			rawBody: message,
+			rawBody: message || "",
+			bodyForAgent,
 			messageId: request.id,
 			timestamp: Date.now(),
 			extraContext: {
@@ -497,10 +424,20 @@ async function handleAgentRequest(request, log) {
 			},
 			deliver: async (payload) => {
 				const responseText = payload.text ?? "";
+				const mediaUrls = [...payload.mediaUrl ? [payload.mediaUrl] : [], ...payload.mediaUrls ?? []];
 				await addMessage(sessionId, "assistant", responseText);
-				chatClient?.sendResponse(request.id, true, {
+				chatClient?.notify("agent-message", {
+					conversationId: conversationId ?? legacySessionKey,
 					text: responseText,
-					sessionKey: resolvedOpenClawKey ?? legacySessionKey
+					sessionKey: resolvedOpenClawKey ?? legacySessionKey,
+					...mediaUrls.length ? { mediaUrls } : {}
+				});
+				if (metricsClient && userId) metricsClient.recordActivity({
+					userId,
+					channel: "alfe",
+					role: "assistant"
+				}).catch((err) => {
+					log.debug(`Metrics report failed: ${err instanceof Error ? err.message : String(err)}`);
 				});
 			},
 			onRecordError: (err) => {
@@ -510,6 +447,7 @@ async function handleAgentRequest(request, log) {
 				log.error(`Dispatch error (${info.kind}): ${err instanceof Error ? err.message : String(err)}`);
 			}
 		})).route.sessionKey;
+		chatClient?.sendResponse(request.id, true, { sessionKey: resolvedOpenClawKey });
 		log.info(`Agent dispatch complete: sessionKey=${resolvedOpenClawKey}`);
 	} catch (err) {
 		const errMsg = err instanceof Error ? err.message : String(err);
@@ -586,6 +524,15 @@ const plugin = {
 			log.info("Chat plugin registering...");
 			resolveOpenClawSdk(log);
 			pluginRuntime = api.runtime ?? null;
+			try {
+				const cfg = resolveConfig();
+				metricsClient = new AgentApiClient({
+					apiKey: cfg.apiKey,
+					apiUrl: cfg.apiUrl
+				});
+			} 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(() => {
@@ -659,19 +606,11 @@ const plugin = {
 				log.info(`Chat session starting: ${key}`);
 				await createSession(key, "", "alfe");
 			}, { priority: 50 });
-			api.on("message", async (...eventArgs) => {
+			api.on("message_received", async (...eventArgs) => {
 				const event = eventArgs[0];
-				const key = event.sessionKey;
-				if (!key) return;
-				if (isAlfeSessionKey(key)) {
-					if (event.role === "assistant" && chatClient) {
-						const parsed = parseAlfeSessionKey(key);
-						if (parsed.conversationId) chatClient.notify("agent-message", {
-							conversationId: parsed.conversationId,
-							text: event.content
-						});
-					}
-				} else await addMessage(key, event.role, event.content);
+				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) => {
 				const key = eventArgs[0].sessionKey;
@@ -698,6 +637,7 @@ const plugin = {
 		}
 		pluginRuntime = null;
 		dispatchInbound = null;
+		metricsClient = null;
 		log.info("Chat plugin deactivated");
 	}
 };

package/openclaw.plugin.json

@@ -1,6 +1,5 @@
 {
   "id": "@alfe.ai/openclaw-chat",
-  "channels": ["alfe"],
   "configSchema": {
     "type": "object",
     "additionalProperties": false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alfe.ai/openclaw-chat",
-  "version": "0.0.17",
+  "version": "0.0.19",
   "description": "OpenClaw chat plugin for Alfe — web widget and mobile app channels",
   "type": "module",
   "main": "./dist/plugin.js",
@@ -27,7 +27,9 @@
     "openclaw.plugin.json"
   ],
   "dependencies": {
-    "@alfe.ai/chat": "^0.0.6"
+    "@alfe.ai/agent-api-client": "^0.0.7",
+    "@alfe.ai/chat": "^0.0.6",
+    "@alfe.ai/config": "^0.0.7"
   },
   "peerDependencies": {
     "openclaw": ">=2026.3.0"