@alfe.ai/openclaw-chat 0.0.33 → 0.1.0

package/dist/index.d.cts

@@ -33,6 +33,8 @@ interface SessionSummary {
   sessionId: string;
   agentId: string;
   channel: string;
+  tenantId?: string;
+  userId?: string;
   createdAt: string;
   lastMessageAt?: string;
   preview?: string;

package/dist/index.d.ts

@@ -33,6 +33,8 @@ interface SessionSummary {
   sessionId: string;
   agentId: string;
   channel: string;
+  tenantId?: string;
+  userId?: string;
   createdAt: string;
   lastMessageAt?: string;
   preview?: string;

package/dist/plugin.d.cts

@@ -9,31 +9,21 @@
 interface AlfeChannelAccountConfig {
   /** Whether this account is enabled. */
   enabled?: boolean;
-  /** Allowed sender identifiers (user IDs, email addresses). */
-  allowFrom?: string | string[];
   /** Default delivery target. */
   defaultTo?: string;
-  /** DM policy (open, allowlist, etc.). */
-  dmPolicy?: string;
 }
 interface AlfeChannelConfig {
   /** Whether the Alfe channel is enabled. */
   enabled?: boolean;
-  /** Allowed sender identifiers. */
-  allowFrom?: string | string[];
   /** Default delivery target for outbound messages. */
   defaultTo?: string;
-  /** DM policy. */
-  dmPolicy?: string;
   /** Named accounts (multi-account support). */
   accounts?: Record<string, AlfeChannelAccountConfig>;
 }
 interface AlfeResolvedAccount {
   accountId: string;
   enabled: boolean;
-  allowFrom: string[];
   defaultTo?: string;
-  dmPolicy?: string;
 }
 interface AlfePluginConfig {
   /** Agent ID this plugin is associated with. */
@@ -43,6 +33,28 @@ interface AlfePluginConfig {
   /** API key for chat service auth */
   apiKey?: string;
 }
+interface AlfeOutboundChatClient {
+  notify(event: string, payload: Record<string, unknown>): void;
+}
+interface AlfeOutboundSessionSummary {
+  sessionId: string;
+  userId?: string;
+  createdAt: string;
+  lastMessageAt?: string;
+}
+interface AlfeOutboundSession {
+  sessionId: string;
+  userId?: string;
+}
+interface AlfeChannelOutboundDeps {
+  getChatClient: () => AlfeOutboundChatClient | null;
+  listSessions: (filters?: {
+    userId?: string;
+  }) => Promise<AlfeOutboundSessionSummary[]>;
+  getSession: (sessionId: string) => Promise<AlfeOutboundSession | null>;
+  createSession: (sessionId: string, agentId: string, channel: string, tenantId?: string, userId?: string) => Promise<unknown>;
+  addMessage: (sessionId: string, role: 'user' | 'assistant', content: string, senderId?: string, senderName?: string) => Promise<void>;
+}
 //#endregion
 //#region src/alfe-channel.d.ts
 /** OpenClaw config shape — inline to avoid runtime dependency on openclaw package */
@@ -53,13 +65,23 @@ interface OpenClawConfig {
   };
   [key: string]: unknown;
 }
+interface OutboundDeliveryResult {
+  channel: 'alfe';
+  messageId: string;
+  conversationId: string;
+  timestamp: number;
+}
 /**
  * Creates the Alfe ChannelPlugin object for registration with OpenClaw.
  *
  * This follows the same pattern as built-in channels (Telegram, Discord, etc.)
  * but is registered dynamically via api.registerChannel().
+ *
+ * `deps` enables outbound delivery and peer discovery. When omitted (e.g.
+ * during CLI metadata registration), outbound calls throw and the directory
+ * is empty — but the channel is still registered for inbound use.
  */
-declare function createAlfeChannelPlugin(): {
+declare function createAlfeChannelPlugin(deps?: AlfeChannelOutboundDeps): {
   id: string;
   meta: {
     id: string;
@@ -118,15 +140,7 @@ declare function createAlfeChannelPlugin(): {
       accountId: string;
       enabled: boolean;
       configured: boolean;
-      dmPolicy: string | undefined;
     };
-    /**
-     * Resolve allow-from list for an account.
-     */
-    resolveAllowFrom(params: {
-      cfg: OpenClawConfig;
-      accountId?: string | null;
-    }): string[];
     /**
      * Resolve default outbound target.
      */
@@ -136,13 +150,47 @@ declare function createAlfeChannelPlugin(): {
     }): string | undefined;
   };
   /**
-   * Outbound delivery via gateway.
-   * The chat relay service on Fly.io handles actual delivery
-   * to connected web/mobile clients via the gateway.
+   * Outbound delivery via the plugin (`deliveryMode: 'direct'`).
+   *
+   * OpenClaw calls `resolveTarget` to validate the agent-supplied `to`,
+   * then `sendText` / `sendMedia` per chunk. We push each chunk to the
+   * chat relay service via `chatClient.notify('agent-message', …)`,
+   * which broadcasts to all connected web/mobile clients on that
+   * conversation and notifies offline participants.
    */
   outbound: {
-    deliveryMode: "gateway";
+    deliveryMode: "direct";
     textChunkLimit: number;
+    resolveTarget(params: {
+      to?: string;
+    }): {
+      ok: true;
+      to: string;
+    } | {
+      ok: false;
+      error: Error;
+    };
+    sendText(ctx: {
+      to: string;
+      text: string;
+    }): Promise<OutboundDeliveryResult>;
+    sendMedia(ctx: {
+      to: string;
+      text: string;
+      mediaUrl?: string;
+    }): Promise<OutboundDeliveryResult>;
+  };
+  /**
+   * Directory adapter — exposes users the agent has chatted with so the
+   * `message` tool can suggest valid targets. Backed by the on-disk
+   * session store; live-list is the same as static-list since sessions
+   * are the only source of truth.
+   */
+  directory: {
+    listPeers(): Promise<{
+      kind: "user";
+      id: string;
+    }[]>;
   };
   /**
    * Setup adapter — minimal for Alfe since no external tokens are needed.

package/dist/plugin.d.ts

@@ -9,31 +9,21 @@
 interface AlfeChannelAccountConfig {
   /** Whether this account is enabled. */
   enabled?: boolean;
-  /** Allowed sender identifiers (user IDs, email addresses). */
-  allowFrom?: string | string[];
   /** Default delivery target. */
   defaultTo?: string;
-  /** DM policy (open, allowlist, etc.). */
-  dmPolicy?: string;
 }
 interface AlfeChannelConfig {
   /** Whether the Alfe channel is enabled. */
   enabled?: boolean;
-  /** Allowed sender identifiers. */
-  allowFrom?: string | string[];
   /** Default delivery target for outbound messages. */
   defaultTo?: string;
-  /** DM policy. */
-  dmPolicy?: string;
   /** Named accounts (multi-account support). */
   accounts?: Record<string, AlfeChannelAccountConfig>;
 }
 interface AlfeResolvedAccount {
   accountId: string;
   enabled: boolean;
-  allowFrom: string[];
   defaultTo?: string;
-  dmPolicy?: string;
 }
 interface AlfePluginConfig {
   /** Agent ID this plugin is associated with. */
@@ -43,6 +33,28 @@ interface AlfePluginConfig {
   /** API key for chat service auth */
   apiKey?: string;
 }
+interface AlfeOutboundChatClient {
+  notify(event: string, payload: Record<string, unknown>): void;
+}
+interface AlfeOutboundSessionSummary {
+  sessionId: string;
+  userId?: string;
+  createdAt: string;
+  lastMessageAt?: string;
+}
+interface AlfeOutboundSession {
+  sessionId: string;
+  userId?: string;
+}
+interface AlfeChannelOutboundDeps {
+  getChatClient: () => AlfeOutboundChatClient | null;
+  listSessions: (filters?: {
+    userId?: string;
+  }) => Promise<AlfeOutboundSessionSummary[]>;
+  getSession: (sessionId: string) => Promise<AlfeOutboundSession | null>;
+  createSession: (sessionId: string, agentId: string, channel: string, tenantId?: string, userId?: string) => Promise<unknown>;
+  addMessage: (sessionId: string, role: 'user' | 'assistant', content: string, senderId?: string, senderName?: string) => Promise<void>;
+}
 //#endregion
 //#region src/alfe-channel.d.ts
 /** OpenClaw config shape — inline to avoid runtime dependency on openclaw package */
@@ -53,13 +65,23 @@ interface OpenClawConfig {
   };
   [key: string]: unknown;
 }
+interface OutboundDeliveryResult {
+  channel: 'alfe';
+  messageId: string;
+  conversationId: string;
+  timestamp: number;
+}
 /**
  * Creates the Alfe ChannelPlugin object for registration with OpenClaw.
  *
  * This follows the same pattern as built-in channels (Telegram, Discord, etc.)
  * but is registered dynamically via api.registerChannel().
+ *
+ * `deps` enables outbound delivery and peer discovery. When omitted (e.g.
+ * during CLI metadata registration), outbound calls throw and the directory
+ * is empty — but the channel is still registered for inbound use.
  */
-declare function createAlfeChannelPlugin(): {
+declare function createAlfeChannelPlugin(deps?: AlfeChannelOutboundDeps): {
   id: string;
   meta: {
     id: string;
@@ -118,15 +140,7 @@ declare function createAlfeChannelPlugin(): {
       accountId: string;
       enabled: boolean;
       configured: boolean;
-      dmPolicy: string | undefined;
     };
-    /**
-     * Resolve allow-from list for an account.
-     */
-    resolveAllowFrom(params: {
-      cfg: OpenClawConfig;
-      accountId?: string | null;
-    }): string[];
     /**
      * Resolve default outbound target.
      */
@@ -136,13 +150,47 @@ declare function createAlfeChannelPlugin(): {
     }): string | undefined;
   };
   /**
-   * Outbound delivery via gateway.
-   * The chat relay service on Fly.io handles actual delivery
-   * to connected web/mobile clients via the gateway.
+   * Outbound delivery via the plugin (`deliveryMode: 'direct'`).
+   *
+   * OpenClaw calls `resolveTarget` to validate the agent-supplied `to`,
+   * then `sendText` / `sendMedia` per chunk. We push each chunk to the
+   * chat relay service via `chatClient.notify('agent-message', …)`,
+   * which broadcasts to all connected web/mobile clients on that
+   * conversation and notifies offline participants.
    */
   outbound: {
-    deliveryMode: "gateway";
+    deliveryMode: "direct";
     textChunkLimit: number;
+    resolveTarget(params: {
+      to?: string;
+    }): {
+      ok: true;
+      to: string;
+    } | {
+      ok: false;
+      error: Error;
+    };
+    sendText(ctx: {
+      to: string;
+      text: string;
+    }): Promise<OutboundDeliveryResult>;
+    sendMedia(ctx: {
+      to: string;
+      text: string;
+      mediaUrl?: string;
+    }): Promise<OutboundDeliveryResult>;
+  };
+  /**
+   * Directory adapter — exposes users the agent has chatted with so the
+   * `message` tool can suggest valid targets. Backed by the on-disk
+   * session store; live-list is the same as static-list since sessions
+   * are the only source of truth.
+   */
+  directory: {
+    listPeers(): Promise<{
+      kind: "user";
+      id: string;
+    }[]>;
   };
   /**
    * Setup adapter — minimal for Alfe since no external tokens are needed.

package/dist/plugin2.cjs

@@ -3,27 +3,70 @@ 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_crypto = require("node:crypto");
 let node_fs = require("node:fs");
 //#region src/alfe-channel.ts
+/**
+* Alfe channel plugin definition — registers 'alfe' as an OpenClaw channel.
+*
+* Web and mobile clients share the same channel and conversation sessions.
+* Outbound delivery uses `deliveryMode: 'direct'` — the plugin's sendText /
+* sendMedia handlers push messages through the chat relay service.
+*
+* Target formats accepted by `resolveTarget`:
+*   user:{clerkUserId}    — most recent conversation for that user (created on demand)
+*   conv:{conversationId} — a specific existing conversation
+*
+* Config section: channels.alfe in openclaw.yaml
+*/
 const CHANNEL_ID = "alfe";
 const DEFAULT_ACCOUNT_ID = "default";
+async function sendViaChat(deps, ctx, mediaUrl) {
+	const client = deps.getChatClient();
+	if (!client) throw new Error("Chat service not connected — cannot deliver");
+	let conversationId;
+	if (ctx.to.startsWith("conv:")) {
+		conversationId = ctx.to.slice(5);
+		if (!await deps.getSession(conversationId)) throw new Error(`Conversation not found: ${conversationId}`);
+	} else {
+		const userId = ctx.to.startsWith("user:") ? ctx.to.slice(5) : ctx.to;
+		if (!userId) throw new Error("Empty userId in target");
+		const sessions = await deps.listSessions({ userId });
+		if (sessions.length > 0) conversationId = sessions[0].sessionId;
+		else {
+			conversationId = `alfe:chat:${userId}:${(0, node_crypto.randomUUID)()}`;
+			await deps.createSession(conversationId, "", "alfe", void 0, userId);
+		}
+	}
+	await deps.addMessage(conversationId, "assistant", ctx.text);
+	const messageId = (0, node_crypto.randomUUID)();
+	client.notify("agent-message", {
+		conversationId,
+		text: ctx.text,
+		sessionKey: conversationId,
+		...mediaUrl ? { mediaUrls: [mediaUrl] } : {}
+	});
+	return {
+		channel: "alfe",
+		messageId,
+		conversationId,
+		timestamp: Date.now()
+	};
+}
 function getChannelSection(cfg) {
 	return cfg.channels?.alfe ?? {};
 }
-function normalizeAllowFrom(raw) {
-	if (!raw) return [];
-	if (typeof raw === "string") return [raw];
-	return raw;
-}
 /**
 * Creates the Alfe ChannelPlugin object for registration with OpenClaw.
 *
 * This follows the same pattern as built-in channels (Telegram, Discord, etc.)
 * but is registered dynamically via api.registerChannel().
+*
+* `deps` enables outbound delivery and peer discovery. When omitted (e.g.
+* during CLI metadata registration), outbound calls throw and the directory
+* is empty — but the channel is still registered for inbound use.
 */
-function createAlfeChannelPlugin() {
+function createAlfeChannelPlugin(deps) {
 	return {
 		id: CHANNEL_ID,
 		meta: {
@@ -57,7 +100,7 @@ function createAlfeChannelPlugin() {
 			listAccountIds(cfg) {
 				const section = getChannelSection(cfg);
 				const ids = [];
-				if (section.enabled !== false && (section.allowFrom ?? section.defaultTo ?? section.dmPolicy)) ids.push(DEFAULT_ACCOUNT_ID);
+				if (section.enabled !== false && section.defaultTo) ids.push(DEFAULT_ACCOUNT_ID);
 				if (section.accounts) {
 					for (const id of Object.keys(section.accounts)) if (!ids.includes(id)) ids.push(id);
 				}
@@ -71,16 +114,12 @@ function createAlfeChannelPlugin() {
 				if (accountSection) return {
 					accountId: id,
 					enabled: accountSection.enabled !== false,
-					allowFrom: normalizeAllowFrom(accountSection.allowFrom),
-					defaultTo: accountSection.defaultTo,
-					dmPolicy: accountSection.dmPolicy
+					defaultTo: accountSection.defaultTo
 				};
 				return {
 					accountId: id,
 					enabled: section.enabled !== false,
-					allowFrom: normalizeAllowFrom(section.allowFrom),
-					defaultTo: section.defaultTo,
-					dmPolicy: section.dmPolicy
+					defaultTo: section.defaultTo
 				};
 			},
 			defaultAccountId() {
@@ -96,15 +135,9 @@ function createAlfeChannelPlugin() {
 				return {
 					accountId: account.accountId,
 					enabled: account.enabled,
-					configured: true,
-					dmPolicy: account.dmPolicy
+					configured: true
 				};
 			},
-			resolveAllowFrom(params) {
-				const section = getChannelSection(params.cfg);
-				const id = params.accountId ?? DEFAULT_ACCOUNT_ID;
-				return normalizeAllowFrom((section.accounts?.[id])?.allowFrom ?? section.allowFrom);
-			},
 			resolveDefaultTo(params) {
 				const section = getChannelSection(params.cfg);
 				const id = params.accountId ?? DEFAULT_ACCOUNT_ID;
@@ -112,9 +145,58 @@ function createAlfeChannelPlugin() {
 			}
 		},
 		outbound: {
-			deliveryMode: "gateway",
-			textChunkLimit: 4e3
+			deliveryMode: "direct",
+			textChunkLimit: 4e3,
+			resolveTarget(params) {
+				const to = params.to;
+				if (!to) return {
+					ok: false,
+					error: /* @__PURE__ */ new Error("Missing target — use user:{userId} or conv:{conversationId}")
+				};
+				if (to.startsWith("conv:")) {
+					if (!to.slice(5)) return {
+						ok: false,
+						error: /* @__PURE__ */ new Error("Empty conversation ID")
+					};
+					return {
+						ok: true,
+						to
+					};
+				}
+				const userId = to.startsWith("user:") ? to.slice(5) : to;
+				if (!userId || userId === "anon") return {
+					ok: false,
+					error: /* @__PURE__ */ new Error("Invalid target: userId is required")
+				};
+				return {
+					ok: true,
+					to: `user:${userId}`
+				};
+			},
+			async sendText(ctx) {
+				if (!deps) throw new Error("Alfe channel deps not configured — outbound disabled");
+				return await sendViaChat(deps, ctx, void 0);
+			},
+			async sendMedia(ctx) {
+				if (!deps) throw new Error("Alfe channel deps not configured — outbound disabled");
+				return await sendViaChat(deps, ctx, ctx.mediaUrl);
+			}
 		},
+		directory: { async listPeers() {
+			if (!deps) return [];
+			const sessions = await deps.listSessions();
+			const seen = /* @__PURE__ */ new Set();
+			const peers = [];
+			for (const s of sessions) {
+				if (!s.userId || seen.has(s.userId)) continue;
+				seen.add(s.userId);
+				peers.push({
+					kind: "user",
+					id: s.userId
+				});
+			}
+			return peers;
+		} },
 		setup: {
 			resolveAccountId(params) {
 				return params.accountId ?? DEFAULT_ACCOUNT_ID;
@@ -283,6 +365,8 @@ async function listSessions(filters, limit = 50) {
 			sessionId: session.sessionId,
 			agentId: session.agentId,
 			channel: session.channel,
+			...session.tenantId ? { tenantId: session.tenantId } : {},
+			...session.userId ? { userId: session.userId } : {},
 			createdAt: session.createdAt,
 			lastMessageAt: lastMsg ? new Date(lastMsg.timestamp).toISOString() : void 0,
 			preview: lastMsg?.content.slice(0, 100),
@@ -552,7 +636,6 @@ function resolveOpenClawSdk(log) {
 let pluginRuntime = null;
 let chatClient = null;
 let connectingPromise = null;
-let metricsClient = null;
 const MAX_FILE_SIZE = 50 * 1024 * 1024;
 const DOWNLOAD_TIMEOUT_MS = 3e4;
 const MAX_REDIRECTS = 5;
@@ -644,13 +727,6 @@ async function handleAgentRequest(request, log) {
 	const sessionId = conversationId ?? legacySessionKey;
 	if (!await getSession(sessionId)) await createSession(sessionId, "", "alfe", tenantId, userId);
 	await addMessage(sessionId, "user", message, userId ?? senderId, displayName ?? senderId);
-	if (metricsClient && userId) metricsClient.recordActivity({
-		userId,
-		channel: "alfe",
-		role: "user"
-	}).catch((err) => {
-		log.warn(`Metrics report failed: ${err instanceof Error ? err.message : String(err)}`);
-	});
 	let resolvedOpenClawKey = null;
 	const unsubscribe = runtime.events.onAgentEvent((evt) => {
 		if (!evt.sessionKey) return;
@@ -732,13 +808,6 @@ async function handleAgentRequest(request, log) {
 					sessionKey: resolvedOpenClawKey ?? legacySessionKey,
 					...mediaUrls.length ? { mediaUrls } : {}
 				});
-				if (metricsClient && userId) metricsClient.recordActivity({
-					userId,
-					channel: "alfe",
-					role: "assistant"
-				}).catch((err) => {
-					log.warn(`Metrics report failed: ${err instanceof Error ? err.message : String(err)}`);
-				});
 			},
 			onRecordError: (err) => {
 				log.error(`Session record error: ${err instanceof Error ? err.message : String(err)}`);
@@ -822,7 +891,13 @@ const plugin = {
 	activate(api) {
 		const log = api.logger;
 		const alreadyActivated = globalThis.__alfeChatPluginActivated === true;
-		const alfeChannel = createAlfeChannelPlugin();
+		const alfeChannel = createAlfeChannelPlugin({
+			getChatClient: () => chatClient,
+			listSessions,
+			getSession,
+			createSession,
+			addMessage
+		});
 		api.registerChannel(alfeChannel);
 		log.info(`Registered channel: ${alfeChannel.id}`);
 		const pluginConfig = (((api.config ?? {}).plugins?.entries)?.["@alfe.ai/openclaw-chat"] ?? {}).config ?? {};
@@ -835,15 +910,6 @@ 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");
-			}
 			connectingPromise = Promise.resolve().then(() => {
 				try {
 					const { apiKey, chatWsUrl } = (0, _alfe_ai_chat.resolveAlfeChat)({
@@ -923,7 +989,6 @@ const plugin = {
 			}
 			pluginRuntime = null;
 			dispatchInbound = null;
-			metricsClient = null;
 			log.info("Chat plugin deactivated");
 		};
 		if (typeof api.registerGatewayMethod === "function") {
@@ -990,7 +1055,6 @@ const plugin = {
 		}
 		pluginRuntime = null;
 		dispatchInbound = null;
-		metricsClient = null;
 		log.info("Chat plugin deactivated");
 	}
 };

package/dist/plugin2.js

@@ -3,27 +3,70 @@ import { mkdir, readFile, readdir, stat, unlink, writeFile } from "node:fs/promi
 import { dirname, join, resolve } 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 { randomUUID } from "node:crypto";
 import { existsSync } from "node:fs";
 //#region src/alfe-channel.ts
+/**
+* Alfe channel plugin definition — registers 'alfe' as an OpenClaw channel.
+*
+* Web and mobile clients share the same channel and conversation sessions.
+* Outbound delivery uses `deliveryMode: 'direct'` — the plugin's sendText /
+* sendMedia handlers push messages through the chat relay service.
+*
+* Target formats accepted by `resolveTarget`:
+*   user:{clerkUserId}    — most recent conversation for that user (created on demand)
+*   conv:{conversationId} — a specific existing conversation
+*
+* Config section: channels.alfe in openclaw.yaml
+*/
 const CHANNEL_ID = "alfe";
 const DEFAULT_ACCOUNT_ID = "default";
+async function sendViaChat(deps, ctx, mediaUrl) {
+	const client = deps.getChatClient();
+	if (!client) throw new Error("Chat service not connected — cannot deliver");
+	let conversationId;
+	if (ctx.to.startsWith("conv:")) {
+		conversationId = ctx.to.slice(5);
+		if (!await deps.getSession(conversationId)) throw new Error(`Conversation not found: ${conversationId}`);
+	} else {
+		const userId = ctx.to.startsWith("user:") ? ctx.to.slice(5) : ctx.to;
+		if (!userId) throw new Error("Empty userId in target");
+		const sessions = await deps.listSessions({ userId });
+		if (sessions.length > 0) conversationId = sessions[0].sessionId;
+		else {
+			conversationId = `alfe:chat:${userId}:${randomUUID()}`;
+			await deps.createSession(conversationId, "", "alfe", void 0, userId);
+		}
+	}
+	await deps.addMessage(conversationId, "assistant", ctx.text);
+	const messageId = randomUUID();
+	client.notify("agent-message", {
+		conversationId,
+		text: ctx.text,
+		sessionKey: conversationId,
+		...mediaUrl ? { mediaUrls: [mediaUrl] } : {}
+	});
+	return {
+		channel: "alfe",
+		messageId,
+		conversationId,
+		timestamp: Date.now()
+	};
+}
 function getChannelSection(cfg) {
 	return cfg.channels?.alfe ?? {};
 }
-function normalizeAllowFrom(raw) {
-	if (!raw) return [];
-	if (typeof raw === "string") return [raw];
-	return raw;
-}
 /**
 * Creates the Alfe ChannelPlugin object for registration with OpenClaw.
 *
 * This follows the same pattern as built-in channels (Telegram, Discord, etc.)
 * but is registered dynamically via api.registerChannel().
+*
+* `deps` enables outbound delivery and peer discovery. When omitted (e.g.
+* during CLI metadata registration), outbound calls throw and the directory
+* is empty — but the channel is still registered for inbound use.
 */
-function createAlfeChannelPlugin() {
+function createAlfeChannelPlugin(deps) {
 	return {
 		id: CHANNEL_ID,
 		meta: {
@@ -57,7 +100,7 @@ function createAlfeChannelPlugin() {
 			listAccountIds(cfg) {
 				const section = getChannelSection(cfg);
 				const ids = [];
-				if (section.enabled !== false && (section.allowFrom ?? section.defaultTo ?? section.dmPolicy)) ids.push(DEFAULT_ACCOUNT_ID);
+				if (section.enabled !== false && section.defaultTo) ids.push(DEFAULT_ACCOUNT_ID);
 				if (section.accounts) {
 					for (const id of Object.keys(section.accounts)) if (!ids.includes(id)) ids.push(id);
 				}
@@ -71,16 +114,12 @@ function createAlfeChannelPlugin() {
 				if (accountSection) return {
 					accountId: id,
 					enabled: accountSection.enabled !== false,
-					allowFrom: normalizeAllowFrom(accountSection.allowFrom),
-					defaultTo: accountSection.defaultTo,
-					dmPolicy: accountSection.dmPolicy
+					defaultTo: accountSection.defaultTo
 				};
 				return {
 					accountId: id,
 					enabled: section.enabled !== false,
-					allowFrom: normalizeAllowFrom(section.allowFrom),
-					defaultTo: section.defaultTo,
-					dmPolicy: section.dmPolicy
+					defaultTo: section.defaultTo
 				};
 			},
 			defaultAccountId() {
@@ -96,15 +135,9 @@ function createAlfeChannelPlugin() {
 				return {
 					accountId: account.accountId,
 					enabled: account.enabled,
-					configured: true,
-					dmPolicy: account.dmPolicy
+					configured: true
 				};
 			},
-			resolveAllowFrom(params) {
-				const section = getChannelSection(params.cfg);
-				const id = params.accountId ?? DEFAULT_ACCOUNT_ID;
-				return normalizeAllowFrom((section.accounts?.[id])?.allowFrom ?? section.allowFrom);
-			},
 			resolveDefaultTo(params) {
 				const section = getChannelSection(params.cfg);
 				const id = params.accountId ?? DEFAULT_ACCOUNT_ID;
@@ -112,9 +145,58 @@ function createAlfeChannelPlugin() {
 			}
 		},
 		outbound: {
-			deliveryMode: "gateway",
-			textChunkLimit: 4e3
+			deliveryMode: "direct",
+			textChunkLimit: 4e3,
+			resolveTarget(params) {
+				const to = params.to;
+				if (!to) return {
+					ok: false,
+					error: /* @__PURE__ */ new Error("Missing target — use user:{userId} or conv:{conversationId}")
+				};
+				if (to.startsWith("conv:")) {
+					if (!to.slice(5)) return {
+						ok: false,
+						error: /* @__PURE__ */ new Error("Empty conversation ID")
+					};
+					return {
+						ok: true,
+						to
+					};
+				}
+				const userId = to.startsWith("user:") ? to.slice(5) : to;
+				if (!userId || userId === "anon") return {
+					ok: false,
+					error: /* @__PURE__ */ new Error("Invalid target: userId is required")
+				};
+				return {
+					ok: true,
+					to: `user:${userId}`
+				};
+			},
+			async sendText(ctx) {
+				if (!deps) throw new Error("Alfe channel deps not configured — outbound disabled");
+				return await sendViaChat(deps, ctx, void 0);
+			},
+			async sendMedia(ctx) {
+				if (!deps) throw new Error("Alfe channel deps not configured — outbound disabled");
+				return await sendViaChat(deps, ctx, ctx.mediaUrl);
+			}
 		},
+		directory: { async listPeers() {
+			if (!deps) return [];
+			const sessions = await deps.listSessions();
+			const seen = /* @__PURE__ */ new Set();
+			const peers = [];
+			for (const s of sessions) {
+				if (!s.userId || seen.has(s.userId)) continue;
+				seen.add(s.userId);
+				peers.push({
+					kind: "user",
+					id: s.userId
+				});
+			}
+			return peers;
+		} },
 		setup: {
 			resolveAccountId(params) {
 				return params.accountId ?? DEFAULT_ACCOUNT_ID;
@@ -283,6 +365,8 @@ async function listSessions(filters, limit = 50) {
 			sessionId: session.sessionId,
 			agentId: session.agentId,
 			channel: session.channel,
+			...session.tenantId ? { tenantId: session.tenantId } : {},
+			...session.userId ? { userId: session.userId } : {},
 			createdAt: session.createdAt,
 			lastMessageAt: lastMsg ? new Date(lastMsg.timestamp).toISOString() : void 0,
 			preview: lastMsg?.content.slice(0, 100),
@@ -552,7 +636,6 @@ function resolveOpenClawSdk(log) {
 let pluginRuntime = null;
 let chatClient = null;
 let connectingPromise = null;
-let metricsClient = null;
 const MAX_FILE_SIZE = 50 * 1024 * 1024;
 const DOWNLOAD_TIMEOUT_MS = 3e4;
 const MAX_REDIRECTS = 5;
@@ -644,13 +727,6 @@ async function handleAgentRequest(request, log) {
 	const sessionId = conversationId ?? legacySessionKey;
 	if (!await getSession(sessionId)) await createSession(sessionId, "", "alfe", tenantId, userId);
 	await addMessage(sessionId, "user", message, userId ?? senderId, displayName ?? senderId);
-	if (metricsClient && userId) metricsClient.recordActivity({
-		userId,
-		channel: "alfe",
-		role: "user"
-	}).catch((err) => {
-		log.warn(`Metrics report failed: ${err instanceof Error ? err.message : String(err)}`);
-	});
 	let resolvedOpenClawKey = null;
 	const unsubscribe = runtime.events.onAgentEvent((evt) => {
 		if (!evt.sessionKey) return;
@@ -732,13 +808,6 @@ async function handleAgentRequest(request, log) {
 					sessionKey: resolvedOpenClawKey ?? legacySessionKey,
 					...mediaUrls.length ? { mediaUrls } : {}
 				});
-				if (metricsClient && userId) metricsClient.recordActivity({
-					userId,
-					channel: "alfe",
-					role: "assistant"
-				}).catch((err) => {
-					log.warn(`Metrics report failed: ${err instanceof Error ? err.message : String(err)}`);
-				});
 			},
 			onRecordError: (err) => {
 				log.error(`Session record error: ${err instanceof Error ? err.message : String(err)}`);
@@ -822,7 +891,13 @@ const plugin = {
 	activate(api) {
 		const log = api.logger;
 		const alreadyActivated = globalThis.__alfeChatPluginActivated === true;
-		const alfeChannel = createAlfeChannelPlugin();
+		const alfeChannel = createAlfeChannelPlugin({
+			getChatClient: () => chatClient,
+			listSessions,
+			getSession,
+			createSession,
+			addMessage
+		});
 		api.registerChannel(alfeChannel);
 		log.info(`Registered channel: ${alfeChannel.id}`);
 		const pluginConfig = (((api.config ?? {}).plugins?.entries)?.["@alfe.ai/openclaw-chat"] ?? {}).config ?? {};
@@ -835,15 +910,6 @@ 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");
-			}
 			connectingPromise = Promise.resolve().then(() => {
 				try {
 					const { apiKey, chatWsUrl } = resolveAlfeChat({
@@ -923,7 +989,6 @@ const plugin = {
 			}
 			pluginRuntime = null;
 			dispatchInbound = null;
-			metricsClient = null;
 			log.info("Chat plugin deactivated");
 		};
 		if (typeof api.registerGatewayMethod === "function") {
@@ -990,7 +1055,6 @@ const plugin = {
 		}
 		pluginRuntime = null;
 		dispatchInbound = null;
-		metricsClient = null;
 		log.info("Chat plugin deactivated");
 	}
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alfe.ai/openclaw-chat",
-  "version": "0.0.33",
+  "version": "0.1.0",
   "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.13",
+    "@alfe.ai/agent-api-client": "^0.1.1",
     "@alfe.ai/chat": "^0.0.8",
     "@alfe.ai/config": "^0.0.8"
   },