agentmetrics-openclaw 0.1.0

package/hooks/agentmetrics/HOOK.md

@@ -0,0 +1,35 @@
+---
+name: agentmetrics
+description: "Send every OpenClaw session to AgentMetrics for full observability — latency, failures, cost, and model usage."
+metadata:
+  openclaw:
+    emoji: "📊"
+    events:
+      - agent:bootstrap
+      - acp:session:complete
+      - command:stop
+    requires:
+      env:
+        - AGENTMETRICS_API_KEY
+---
+
+# AgentMetrics
+
+Instruments every OpenClaw session automatically.
+
+Each session becomes one event in AgentMetrics, capturing:
+
+- Session duration
+- Success or failure status
+- Model used
+- Agent identity
+
+No code changes needed. Works with any agent, any model, any platform OpenClaw supports.
+
+## Setup
+
+1. Install: `openclaw plugins install agentmetrics-openclaw`
+2. Set env var: `AGENTMETRICS_API_KEY=am_your_key_here`
+3. Run your agent as normal.
+
+Sessions appear in your [AgentMetrics dashboard](https://app.agentmetrics.dev) within seconds.

package/hooks/agentmetrics/handler.d.ts

@@ -0,0 +1 @@
+export default function handler(event: Record<string, unknown>): Promise<void>;

package/hooks/agentmetrics/handler.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = handler;
+const crypto_1 = require("crypto");
+const sessions = new Map();
+const API_KEY = process.env.AGENTMETRICS_API_KEY;
+const BASE_URL = (process.env.AGENTMETRICS_URL ?? "https://api.agentmetrics.dev").replace(/\/$/, "");
+async function send(payload) {
+    if (!API_KEY)
+        return;
+    try {
+        await fetch(`${BASE_URL}/events`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "Authorization": `Bearer ${API_KEY}`,
+            },
+            body: JSON.stringify(payload),
+        });
+    }
+    catch {
+        // Never crash the agent on observability failure
+    }
+}
+function resolveAgentId(event) {
+    // Prefer explicit name from config, fall back to session label, then generic
+    const ctx = event["context"];
+    const cfg = ctx?.["cfg"];
+    return (cfg?.["name"] ??
+        ctx?.["label"] ??
+        event["sessionKey"] ??
+        "openclaw-agent");
+}
+async function handler(event) {
+    if (!API_KEY)
+        return;
+    const type = event["type"];
+    const action = event["action"];
+    const key = event["sessionKey"];
+    // ── Session start ────────────────────────────────────────────────────────
+    if (type === "agent" && action === "bootstrap" && key) {
+        sessions.set(key, {
+            traceId: (0, crypto_1.randomUUID)(),
+            agentId: resolveAgentId(event),
+            startedAt: Date.now(),
+        });
+        return;
+    }
+    // ── Session end (ACP) ────────────────────────────────────────────────────
+    if (type === "acp" && action === "session:complete" && key) {
+        const meta = sessions.get(key);
+        sessions.delete(key);
+        const ctx = event["context"];
+        const status = ctx?.["status"] === "success" ? "success" : "failed";
+        const error = status === "failed" ? ctx?.["lastOutput"] : undefined;
+        await send({
+            trace_id: meta?.traceId ?? (0, crypto_1.randomUUID)(),
+            agent_id: meta?.agentId ?? resolveAgentId(event),
+            status,
+            duration_ms: meta ? Date.now() - meta.startedAt : undefined,
+            error: error?.slice(0, 500),
+        });
+        return;
+    }
+    // ── Session end (manual /stop) ───────────────────────────────────────────
+    if (type === "command" && action === "stop" && key) {
+        const meta = sessions.get(key);
+        sessions.delete(key);
+        if (!meta)
+            return;
+        await send({
+            trace_id: meta.traceId,
+            agent_id: meta.agentId,
+            status: "success",
+            duration_ms: Date.now() - meta.startedAt,
+        });
+    }
+}

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "agentmetrics-openclaw",
+  "version": "0.1.0",
+  "description": "AgentMetrics observability hook for OpenClaw agents",
+  "license": "MIT",
+  "homepage": "https://agentmetrics.dev",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/andausman/agentmetrics"
+  },
+  "keywords": ["openclaw", "agentmetrics", "observability", "ai-agents", "monitoring"],
+  "openclaw": {
+    "hooks": ["hooks/agentmetrics"]
+  },
+  "files": [
+    "hooks/agentmetrics/HOOK.md",
+    "hooks/agentmetrics/handler.js",
+    "hooks/agentmetrics/handler.d.ts"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "typescript": "^5.4.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}