@alfe.ai/openclaw-metrics 0.0.2

package/dist/plugin.d.ts

@@ -0,0 +1,29 @@
+//#region src/plugin.d.ts
+/**
+ * @alfe.ai/openclaw-metrics — OpenClaw metrics plugin for Alfe.
+ *
+ * Hooks into the global `message` event to track per-user activity
+ * across all channels (Alfe chat, Discord, Slack, etc.).
+ *
+ * On each message, fires a fire-and-forget POST to the Alfe API
+ * via the AgentApiClient. The backend resolves agentId + tenantId
+ * from the agent's API key — the plugin never needs to know or send
+ * the Alfe agentId.
+ */
+interface PluginLogger {
+  info(msg: string, ...args: unknown[]): void;
+  warn(msg: string, ...args: unknown[]): void;
+  error(msg: string, ...args: unknown[]): void;
+  debug(msg: string, ...args: unknown[]): void;
+}
+interface PluginApi {
+  logger: PluginLogger;
+  on(event: string, handler: (...args: unknown[]) => void | Promise<void>): void;
+}
+declare const plugin: {
+  id: string;
+  activate(api: PluginApi): void;
+  deactivate(api: PluginApi): void;
+};
+//#endregion
+export { plugin as default };

package/dist/plugin.js

@@ -0,0 +1,92 @@
+import { resolveConfig } from "@alfe.ai/config";
+import { AgentApiClient } from "@alfe.ai/agent-api-client";
+//#region src/session-keys.ts
+/** Known channel segments in canonical session keys. */
+const KNOWN_CHANNELS = new Set([
+	"alfe",
+	"discord",
+	"slack",
+	"telegram",
+	"whatsapp",
+	"signal",
+	"irc",
+	"googlechat",
+	"msteams",
+	"imessage",
+	"feishu"
+]);
+/**
+* Parse a session key for userId and channel.
+*
+* Returns empty strings for fields that cannot be determined.
+*/
+function parseSessionKey(key) {
+	const canonicalMatch = /^agent:[^:]+:([^:]+):(?:default:)?direct:([^:]+)/.exec(key);
+	if (canonicalMatch) {
+		const [, channel, userId] = canonicalMatch;
+		return {
+			userId,
+			channel: KNOWN_CHANNELS.has(channel) ? channel : "unknown"
+		};
+	}
+	if (key.includes("chat-")) return {
+		userId: "",
+		channel: "alfe"
+	};
+	return {
+		userId: "",
+		channel: "unknown"
+	};
+}
+//#endregion
+//#region src/plugin.ts
+/**
+* @alfe.ai/openclaw-metrics — OpenClaw metrics plugin for Alfe.
+*
+* Hooks into the global `message` event to track per-user activity
+* across all channels (Alfe chat, Discord, Slack, etc.).
+*
+* On each message, fires a fire-and-forget POST to the Alfe API
+* via the AgentApiClient. The backend resolves agentId + tenantId
+* from the agent's API key — the plugin never needs to know or send
+* the Alfe agentId.
+*/
+let client = null;
+const plugin = {
+	id: "@alfe.ai/openclaw-metrics",
+	activate(api) {
+		const log = api.logger;
+		log.info("Alfe Metrics plugin activating...");
+		resolveConfig().then((cfg) => {
+			client = new AgentApiClient({
+				apiKey: cfg.apiKey,
+				apiUrl: cfg.apiUrl
+			});
+			log.info("Alfe Metrics plugin ready — API client initialized");
+		}).catch((err) => {
+			log.warn(`Failed to resolve Alfe config — metrics will not be reported: ${err instanceof Error ? err.message : String(err)}`);
+		});
+		api.on("message", (...eventArgs) => {
+			if (!client) return;
+			const { sessionKey, role } = eventArgs[0];
+			if (!sessionKey) return;
+			const parsed = parseSessionKey(sessionKey);
+			if (!parsed.userId) return;
+			client.recordActivity({
+				userId: parsed.userId,
+				channel: parsed.channel,
+				role
+			}).catch((err) => {
+				log.debug(`Metrics report failed: ${err instanceof Error ? err.message : String(err)}`);
+			});
+		});
+		log.info("Alfe Metrics plugin registered");
+	},
+	deactivate(api) {
+		const log = api.logger;
+		client = null;
+		log.info("Alfe Metrics plugin deactivated");
+	}
+};
+//#endregion
+export { plugin as default };

package/openclaw.plugin.json

@@ -0,0 +1,8 @@
+{
+  "id": "@alfe.ai/openclaw-metrics",
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {}
+  }
+}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@alfe.ai/openclaw-metrics",
+  "version": "0.0.2",
+  "description": "OpenClaw metrics plugin for Alfe — per-user activity tracking",
+  "type": "module",
+  "main": "./dist/plugin.js",
+  "types": "./dist/plugin.d.ts",
+  "exports": {
+    "./plugin": {
+      "import": "./dist/plugin.js",
+      "types": "./dist/plugin.d.ts"
+    }
+  },
+  "openclaw": {
+    "extensions": [
+      "./dist/plugin.js"
+    ]
+  },
+  "files": [
+    "dist",
+    "openclaw.plugin.json"
+  ],
+  "dependencies": {
+    "@alfe.ai/config": "^0.0.5",
+    "@alfe.ai/agent-api-client": "^0.0.3"
+  },
+  "peerDependencies": {
+    "openclaw": ">=2026.3.0"
+  },
+  "peerDependenciesMeta": {
+    "openclaw": {
+      "optional": true
+    }
+  },
+  "license": "UNLICENSED",
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint ."
+  }
+}