@laburen/openclaw-plugin-whatsapp-api 0.5.0 → 0.6.1

package/README.md

@@ -120,6 +120,19 @@ Responses: **`403`** if the shared secret does not match, **`400`** if the paylo
 
 Per-account fields can override phone id, token, retries, etc. under `channels["whatsapp-api"].accounts.<accountId>`.
 
+## LLM Usage Forwarding (`llm_output`) (opcional)
+
+Este plugin puede reenviar el usage de tokens cuando OpenClaw emite el hook `llm_output`. Cuando está configurado, hace un `POST` a `{LABUREN_WEB_APP_URL}/api/usage` y envía `Authorization: Bearer <laburenApiKey>`.
+
+Para activarlo, configura estas keys del entry del plugin (no del channel):
+
+```bash
+openclaw config set plugins.entries.whatsapp-api.LABUREN_WEB_APP_URL "https://tu-laburen.example"
+openclaw config set plugins.entries.whatsapp-api.userPhoneNumber "+1234567890"
+openclaw config set plugins.entries.whatsapp-api.laburenApiKey "tu-api-key"
+openclaw gateway restart
+```
+
 ## Notes
 
 - Outbound mode is **direct-to-Meta** only (no third-party relay in this plugin).

package/index.js

@@ -1126,7 +1126,7 @@ async function handleWhatsAppApiWebhook(params) {
 //#endregion
 //#region src/channel/plugin.ts
 const CHANNEL_ID = "whatsapp-api";
-const log$3 = waLogger("channel");
+const log$4 = waLogger("channel");
 const DEFAULT_ACCOUNT_ID = "default";
 /**
 * Resolves when `signal` aborts, or never if `signal` is undefined.
@@ -1195,7 +1195,7 @@ async function dispatchInboundToAgent(params) {
 	const mediaAttachment = await downloadInboundMediaAttachment({
 		account,
 		message,
-		log: { warn: (msg) => log$3.warn(msg) }
+		log: { warn: (msg) => log$4.warn(msg) }
 	});
 	const replyApi = rt.channel.reply;
 	const ctxPayload = replyApi.finalizeInboundContext({
@@ -1226,7 +1226,7 @@ async function dispatchInboundToAgent(params) {
 	sendWhatsAppApiReadMark({
 		messageId: message.messageId,
 		account
-	}).catch((err) => log$3.warn("failed to mark read", {
+	}).catch((err) => log$4.warn("failed to mark read", {
 		error: String(err),
 		messageId: message.messageId
 	}));
@@ -1248,7 +1248,7 @@ async function dispatchInboundToAgent(params) {
 					account
 				});
 			},
-			onStartError: (err) => log$3.warn("failed to start typing", { error: String(err) })
+			onStartError: (err) => log$4.warn("failed to start typing", { error: String(err) })
 		},
 		dispatcherOptions: {
 			deliver: async (payload) => {
@@ -1259,17 +1259,17 @@ async function dispatchInboundToAgent(params) {
 					account
 				});
 				if (sent.length === 0) {
-					log$3.info("skipping outbound: reply payload empty", { messageId: message.messageId });
+					log$4.info("skipping outbound: reply payload empty", { messageId: message.messageId });
 					return;
 				}
-				log$3.info(`sent ${sent.length} outbound message(s)`, {
+				log$4.info(`sent ${sent.length} outbound message(s)`, {
 					to: message.from,
 					messageId: message.messageId
 				});
 				onOutbound?.();
 			},
 			onError: (err, info) => {
-				log$3.error(`${info?.kind ?? "reply"} dispatch failed`, {
+				log$4.error(`${info?.kind ?? "reply"} dispatch failed`, {
 					accountId,
 					messageId: message.messageId,
 					error: String(err)
@@ -1419,6 +1419,117 @@ function createWhatsAppApiChannel(api) {
 	};
 }
 //#endregion
+//#region src/hooks/llm-output/handlers/forward-usage.ts
+/**
+* SPDX-License-Identifier: MIT
+*
+* Forwards LLM token usage from the `llm_output` hook to a configured HTTP endpoint.
+*/
+const log$3 = waLogger("llm-output/forward-usage");
+/** Plugin extension config keys (see `openclaw.plugin.json`). */
+const LABUREN_WEB_APP_CONFIG_KEY = "LABUREN_WEB_APP_URL";
+const USER_PHONE_CONFIG_KEY = "userPhoneNumber";
+const LABUREN_API_KEY_CONFIG_KEY = "laburenApiKey";
+const USAGE_PATH = "/api/usage";
+const USAGE_FEATURE = "openclaw_run";
+const POST_TIMEOUT_MS = 3e3;
+function resolveUsageIngestUrl() {
+	let baseRaw;
+	try {
+		baseRaw = getPluginApi().pluginConfig?.[LABUREN_WEB_APP_CONFIG_KEY];
+	} catch {
+		return null;
+	}
+	if (typeof baseRaw !== "string") return null;
+	const base = baseRaw.trim().replace(/\/+$/, "");
+	if (!base) return null;
+	try {
+		return new URL(USAGE_PATH, base).href;
+	} catch {
+		log$3.warn(`usage-forwarder: invalid ${LABUREN_WEB_APP_CONFIG_KEY} base URL`);
+		return null;
+	}
+}
+function resolveUserPhoneNumber() {
+	let raw;
+	try {
+		raw = getPluginApi().pluginConfig?.[USER_PHONE_CONFIG_KEY];
+	} catch {
+		return null;
+	}
+	if (typeof raw !== "string") return null;
+	const phone = raw.trim();
+	return phone.length > 0 ? phone : null;
+}
+function resolveLaburenApiKey() {
+	let raw;
+	try {
+		raw = getPluginApi().pluginConfig?.[LABUREN_API_KEY_CONFIG_KEY];
+	} catch {
+		return null;
+	}
+	if (typeof raw !== "string") return null;
+	const key = raw.trim();
+	return key.length > 0 ? key : null;
+}
+async function handleForwardLlmUsage(event, ctx) {
+	const usage = event.usage;
+	if (!usage) return;
+	const endpoint = resolveUsageIngestUrl();
+	if (!endpoint) return;
+	const userPhoneNumber = resolveUserPhoneNumber();
+	if (!userPhoneNumber) return;
+	const laburenApiKey = resolveLaburenApiKey();
+	if (!laburenApiKey) {
+		log$3.warn(`usage-forwarder: missing ${LABUREN_API_KEY_CONFIG_KEY} (required for authenticated /api/usage calls)`);
+		return;
+	}
+	const input = usage.input ?? 0;
+	const output = usage.output ?? 0;
+	const cacheRead = usage.cacheRead ?? 0;
+	const cacheWrite = usage.cacheWrite ?? 0;
+	const total = usage.total ?? input + output + cacheRead + cacheWrite;
+	const body = {
+		feature: USAGE_FEATURE,
+		runId: event.runId,
+		sessionId: event.sessionId,
+		userPhoneNumber,
+		sessionKey: ctx.sessionKey,
+		agentId: ctx.agentId,
+		provider: event.provider,
+		model: event.model,
+		usage: {
+			input,
+			output,
+			cacheRead,
+			cacheWrite,
+			total
+		},
+		capturedAt: (/* @__PURE__ */ new Date()).toISOString()
+	};
+	try {
+		const res = await fetch(endpoint, {
+			method: "POST",
+			headers: {
+				"Content-Type": "application/json",
+				Authorization: `Bearer ${laburenApiKey}`
+			},
+			body: JSON.stringify(body),
+			signal: AbortSignal.timeout(POST_TIMEOUT_MS)
+		});
+		if (!res.ok) log$3.warn(`usage-forwarder: HTTP ${res.status}`);
+	} catch (err) {
+		log$3.warn(`usage-forwarder: request failed (${String(err)})`);
+	}
+}
+//#endregion
+//#region src/hooks/llm-output/register.ts
+function registerLlmOutputHook(api) {
+	api.on("llm_output", async (event, ctx) => {
+		await handleForwardLlmUsage(event, ctx);
+	});
+}
+//#endregion
 //#region src/plugin/plugin-state-dir.ts
 /**
 * SPDX-License-Identifier: MIT
@@ -1510,6 +1621,7 @@ function registerMessageReceivedHook(api) {
 */
 function registerAllPluginHooks(api) {
 	registerMessageReceivedHook(api);
+	registerLlmOutputHook(api);
 }
 //#endregion
 //#region src/services/context-window-check/register.ts

package/openclaw.plugin.json

@@ -9,6 +9,18 @@
     "type": "object",
     "additionalProperties": false,
     "properties": {
+      "LABUREN_WEB_APP_URL": {
+        "type": "string",
+        "description": "Laburen web app base URL (no trailing slash). LLM usage is POSTed to {base}/api/usage."
+      },
+      "userPhoneNumber": {
+        "type": "string",
+        "description": "WhatsApp user phone (E.164 or your normalised form). Sent on each usage POST so the backend can resolve the user."
+      },
+      "laburenApiKey": {
+        "type": "string",
+        "description": "Bearer token for the Laburen usage ingest API (sent as `Authorization: Bearer <laburenApiKey>` on POST {base}/api/usage)."
+      },
       "defaults": {
         "type": "object",
         "additionalProperties": false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@laburen/openclaw-plugin-whatsapp-api",
-  "version": "0.5.0",
+  "version": "0.6.1",
   "type": "module",
   "description": "WhatsApp API channel plugin for OpenClaw",
   "main": "index.js",