@alfe.ai/openclaw-chat 0.0.15 → 0.0.17

package/dist/plugin2.cjs

@@ -138,28 +138,128 @@ function createAlfeChannelPlugin() {
 //#endregion
 //#region src/session-keys.ts
 /**
-* Session key helpers — handles both legacy and canonical OpenClaw formats.
+* Session key helpers — handles standardized, canonical, and legacy formats.
 *
-* Canonical format (from resolveAgentRoute):
-*   agent:{agentId}:alfe:direct:{userId}
-*   agent:{agentId}:alfe:direct:{userId}:thread:{conversationId}
+* Standardized format (Alfe-controlled):
+*   alfe:{mode}:{identity}              — single-threaded (SMS, WhatsApp)
+*   alfe:{mode}:{identity}:{convId}     — multi-threaded (web chat)
 *
-* Legacy format (from chat adapter):
+* 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}
-*
-* The plugin may receive either format depending on which
-* OpenClaw event fires and whether the new dispatch path is active.
 */
+/** 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 both canonical and legacy formats.
+* Handles standardized, canonical, and legacy formats.
 */
 function isAlfeSessionKey(key) {
+	if (key.startsWith("alfe:")) return true;
 	if (key.includes(":alfe:")) return true;
-	if (key.includes("chat-")) return true;
+	if (key.includes("chat-") || key.startsWith("sms-") || key.startsWith("wa-")) return true;
 	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.
+*/
+function extractChannelMode(conversationId, fallback = "chat") {
+	return /^alfe:(\w+):/.exec(conversationId)?.[1] ?? fallback;
+}
 //#endregion
 //#region src/session-store.ts
 /**
@@ -363,14 +463,16 @@ async function handleAgentRequest(request, log) {
 		});
 	});
 	try {
+		const channelMode = extractChannelMode(conversationId ?? "", clientType ?? "chat");
+		const channelLabel = channelMode === "sms" ? "SMS" : channelMode === "whatsapp" ? "WhatsApp" : "Alfe";
 		const shortConvId = conversationId?.slice(-8) ?? "";
 		const userLabel = displayName ?? userId ?? senderId;
-		const conversationLabel = conversationType === "group" ? shortConvId ? `[Alfe] Group (${shortConvId})` : "[Alfe] Group" : shortConvId ? `[Alfe] ${userLabel} (${shortConvId})` : `[Alfe] ${userLabel}`;
+		const conversationLabel = conversationType === "group" ? shortConvId ? `[${channelLabel}] Group (${shortConvId})` : `[${channelLabel}] Group` : shortConvId ? `[${channelLabel}] ${userLabel} (${shortConvId})` : `[${channelLabel}] ${userLabel}`;
 		resolvedOpenClawKey = (await dispatchInbound({
 			cfg,
 			runtime: { channel: runtime.channel },
 			channel: "alfe",
-			channelLabel: "Alfe",
+			channelLabel,
 			accountId: "default",
 			peer: conversationType === "group" ? {
 				kind: "group",
@@ -390,7 +492,8 @@ async function handleAgentRequest(request, log) {
 				...tenantId ? { TenantId: tenantId } : {},
 				...clientType ? { ClientType: clientType } : {},
 				...conversationId ? { ConversationId: conversationId } : {},
-				...displayName ? { SenderName: displayName } : {}
+				...displayName ? { SenderName: displayName } : {},
+				ChannelMode: channelMode
 			},
 			deliver: async (payload) => {
 				const responseText = payload.text ?? "";
@@ -559,8 +662,16 @@ const plugin = {
 			api.on("message", async (...eventArgs) => {
 				const event = eventArgs[0];
 				const key = event.sessionKey;
-				if (!key || isAlfeSessionKey(key)) return;
-				await addMessage(key, event.role, event.content);
+				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);
 			});
 			api.on("session_end", (...eventArgs) => {
 				const key = eventArgs[0].sessionKey;

package/dist/plugin2.js

@@ -138,28 +138,128 @@ function createAlfeChannelPlugin() {
 //#endregion
 //#region src/session-keys.ts
 /**
-* Session key helpers — handles both legacy and canonical OpenClaw formats.
+* Session key helpers — handles standardized, canonical, and legacy formats.
 *
-* Canonical format (from resolveAgentRoute):
-*   agent:{agentId}:alfe:direct:{userId}
-*   agent:{agentId}:alfe:direct:{userId}:thread:{conversationId}
+* Standardized format (Alfe-controlled):
+*   alfe:{mode}:{identity}              — single-threaded (SMS, WhatsApp)
+*   alfe:{mode}:{identity}:{convId}     — multi-threaded (web chat)
 *
-* Legacy format (from chat adapter):
+* 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}
-*
-* The plugin may receive either format depending on which
-* OpenClaw event fires and whether the new dispatch path is active.
 */
+/** 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 both canonical and legacy formats.
+* Handles standardized, canonical, and legacy formats.
 */
 function isAlfeSessionKey(key) {
+	if (key.startsWith("alfe:")) return true;
 	if (key.includes(":alfe:")) return true;
-	if (key.includes("chat-")) return true;
+	if (key.includes("chat-") || key.startsWith("sms-") || key.startsWith("wa-")) return true;
 	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.
+*/
+function extractChannelMode(conversationId, fallback = "chat") {
+	return /^alfe:(\w+):/.exec(conversationId)?.[1] ?? fallback;
+}
 //#endregion
 //#region src/session-store.ts
 /**
@@ -363,14 +463,16 @@ async function handleAgentRequest(request, log) {
 		});
 	});
 	try {
+		const channelMode = extractChannelMode(conversationId ?? "", clientType ?? "chat");
+		const channelLabel = channelMode === "sms" ? "SMS" : channelMode === "whatsapp" ? "WhatsApp" : "Alfe";
 		const shortConvId = conversationId?.slice(-8) ?? "";
 		const userLabel = displayName ?? userId ?? senderId;
-		const conversationLabel = conversationType === "group" ? shortConvId ? `[Alfe] Group (${shortConvId})` : "[Alfe] Group" : shortConvId ? `[Alfe] ${userLabel} (${shortConvId})` : `[Alfe] ${userLabel}`;
+		const conversationLabel = conversationType === "group" ? shortConvId ? `[${channelLabel}] Group (${shortConvId})` : `[${channelLabel}] Group` : shortConvId ? `[${channelLabel}] ${userLabel} (${shortConvId})` : `[${channelLabel}] ${userLabel}`;
 		resolvedOpenClawKey = (await dispatchInbound({
 			cfg,
 			runtime: { channel: runtime.channel },
 			channel: "alfe",
-			channelLabel: "Alfe",
+			channelLabel,
 			accountId: "default",
 			peer: conversationType === "group" ? {
 				kind: "group",
@@ -390,7 +492,8 @@ async function handleAgentRequest(request, log) {
 				...tenantId ? { TenantId: tenantId } : {},
 				...clientType ? { ClientType: clientType } : {},
 				...conversationId ? { ConversationId: conversationId } : {},
-				...displayName ? { SenderName: displayName } : {}
+				...displayName ? { SenderName: displayName } : {},
+				ChannelMode: channelMode
 			},
 			deliver: async (payload) => {
 				const responseText = payload.text ?? "";
@@ -559,8 +662,16 @@ const plugin = {
 			api.on("message", async (...eventArgs) => {
 				const event = eventArgs[0];
 				const key = event.sessionKey;
-				if (!key || isAlfeSessionKey(key)) return;
-				await addMessage(key, event.role, event.content);
+				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);
 			});
 			api.on("session_end", (...eventArgs) => {
 				const key = eventArgs[0].sessionKey;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alfe.ai/openclaw-chat",
-  "version": "0.0.15",
+  "version": "0.0.17",
   "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/chat": "^0.0.5"
+    "@alfe.ai/chat": "^0.0.6"
   },
   "peerDependencies": {
     "openclaw": ">=2026.3.0"