agentmetrics-openclaw 0.1.0 → 0.2.1

package/README.md

@@ -0,0 +1,76 @@
+# agentmetrics-openclaw
+
+Full observability for every OpenClaw agent. Tokens, tools, latency, cost, and reliability — automatically.
+
+## What it captures
+
+Every agent run produces one event in AgentMetrics with:
+
+| Field | Source |
+|---|---|
+| Status (success / failed) | `agent_end.success` |
+| Duration | `agent_end.durationMs` |
+| Model & provider | `llm_output` |
+| Input tokens | `llm_output.usage.input` |
+| Output tokens | `llm_output.usage.output` |
+| Cache read tokens | `llm_output.usage.cacheRead` |
+| Cache write tokens | `llm_output.usage.cacheWrite` |
+| Tool call count | `after_tool_call` (counted) |
+| Tool error count | `after_tool_call.error` (counted) |
+| Step count | `agent_end.messages.length` |
+| Error message | `agent_end.error` |
+
+All token buckets are accumulated across the full run — multi-turn, multi-LLM-call runs are handled correctly.
+
+## Setup
+
+### 1. Install
+
+```sh
+openclaw plugins install agentmetrics-openclaw
+```
+
+### 2. Set your API key
+
+```sh
+export AGENTMETRICS_API_KEY=am_your_key_here
+```
+
+Add this to your shell profile (`.bashrc`, `.zshrc`, etc.) to persist it.
+
+### 3. Restart the gateway
+
+```sh
+openclaw gateway restart
+```
+
+That's it. Sessions appear in your [AgentMetrics dashboard](https://agentmetrics.dev) within seconds.
+
+## Configuration (optional)
+
+You can also set credentials in `openclaw.yml` instead of environment variables:
+
+```yaml
+plugins:
+  agentmetrics:
+    apiKey: am_your_key_here
+    endpoint: https://api.agentmetrics.dev  # optional
+```
+
+## Auto-enable
+
+If `AGENTMETRICS_API_KEY` is present in your environment, the plugin enables itself automatically — no manual `openclaw plugins enable agentmetrics` needed.
+
+## CLI
+
+```sh
+openclaw agentmetrics status
+```
+
+Shows the active API key, endpoint, and current session/run counts.
+
+## Links
+
+- Dashboard: [agentmetrics.dev](https://agentmetrics.dev)
+- Docs: [agentmetrics.dev/docs](https://agentmetrics.dev/docs)
+- GitHub: [github.com/andausman/agentmetrics](https://github.com/andausman/agentmetrics)

package/index.ts

@@ -0,0 +1,586 @@
+import { randomUUID } from "crypto";
+
+// Resolved once in register() — pluginConfig overrides env vars
+let API_KEY: string | undefined;
+let BASE_URL: string;
+
+// ─── Types (sourced from openclaw/src/plugins/hook-types.ts) ──────────────────
+
+type AgentContext = {
+  runId?:           string;
+  agentId?:         string;
+  sessionKey?:      string;
+  sessionId?:       string;
+  modelId?:         string;
+  modelProviderId?: string;
+};
+
+type SessionContext = {
+  sessionId:   string;
+  sessionKey?: string;
+  agentId?:    string;
+};
+
+type SessionStartEvent = {
+  sessionId:    string;
+  sessionKey?:  string;
+  resumedFrom?: string;
+};
+
+type SessionEndEvent = {
+  sessionId:           string;
+  sessionKey?:         string;
+  durationMs?:         number;
+  messageCount:        number;
+  reason?:             string;
+  transcriptArchived?: boolean;
+};
+
+type LlmInputEvent = {
+  runId:           string;
+  sessionId:       string;
+  provider:        string;
+  model:           string;
+  systemPrompt?:   string;
+  prompt:          string;
+  historyMessages: unknown[];
+  imagesCount:     number;
+};
+
+type LlmOutputEvent = {
+  runId:          string;
+  sessionId:      string;
+  provider:       string;
+  model:          string;
+  assistantTexts: string[];
+  usage?: {
+    input?:      number;
+    output?:     number;
+    cacheRead?:  number;
+    cacheWrite?: number;
+    total?:      number;
+  };
+};
+
+type BeforeToolCallEvent = {
+  toolName:    string;
+  params:      Record<string, unknown>;
+  runId?:      string;
+  toolCallId?: string;
+};
+
+type AfterToolCallEvent = {
+  toolName:    string;
+  params:      Record<string, unknown>;
+  runId?:      string;
+  toolCallId?: string;
+  result?:     unknown;
+  error?:      string;
+  durationMs?: number;
+};
+
+type ToolContext = {
+  agentId?:    string;
+  sessionKey?: string;
+  sessionId?:  string;
+  runId?:      string;
+  toolName:    string;
+  toolCallId?: string;
+};
+
+type AgentEndEvent = {
+  messages:    unknown[];
+  success:     boolean;
+  error?:      string;
+  durationMs?: number;
+};
+
+type BeforeAgentStartEvent = {
+  agentId?:    string;
+  sessionKey?: string;
+  sessionId?:  string;
+};
+
+type SubagentSpawningEvent = {
+  childSessionKey: string;
+  agentId:         string;
+  label?:          string;
+  mode:            "run" | "session";
+  threadRequested: boolean;
+};
+
+type SubagentEndedEvent = {
+  targetSessionKey: string;
+  reason:           string;
+  runId?:           string;
+  outcome?:         "ok" | "error" | "timeout" | "killed" | "reset" | "deleted";
+  error?:           string;
+};
+
+type SubagentContext = {
+  runId?:               string;
+  childSessionKey?:     string;
+  requesterSessionKey?: string;
+};
+
+type CompactionEvent = {
+  messageCount:     number;
+  compactingCount?: number;
+  tokenCount?:      number;
+  sessionFile?:     string;
+};
+
+type ResetEvent = {
+  sessionFile?: string;
+  reason?:      string;
+};
+
+type GatewayStartEvent = { port: number };
+type GatewayStopEvent  = { reason?: string };
+type GatewayContext    = { port?: number };
+
+// ─── Per-session and per-run state ────────────────────────────────────────────
+
+interface SessionMeta {
+  traceId:     string;
+  agentId:     string;
+  startedAt:   number;
+  compactions: number;
+  resets:      number;
+}
+
+interface RunMeta {
+  inputTokens:      number;
+  outputTokens:     number;
+  cacheReadTokens:  number;
+  cacheWriteTokens: number;
+  llmCalls:         number;
+  imagesCount:      number;
+  toolCalls:        number;
+  toolErrors:       number;
+  toolNames:        Set<string>;
+  subagentsSpawned: number;
+  subagentErrors:   number;
+  model?:           string;
+  provider?:        string;
+  sessionKey?:      string;
+}
+
+const sessions = new Map<string, SessionMeta>();
+const runs     = new Map<string, RunMeta>();
+
+// ─── HTTP helpers ─────────────────────────────────────────────────────────────
+
+/** Send a completed run summary to /v1/events (persisted to DB). */
+async function send(payload: Record<string, unknown>): Promise<void> {
+  if (!API_KEY) return;
+  try {
+    await fetch(`${BASE_URL}/v1/events`, {
+      method: "POST",
+      headers: {
+        "Content-Type":  "application/json",
+        "Authorization": `Bearer ${API_KEY}`,
+      },
+      body: JSON.stringify(payload),
+    });
+  } catch {
+    // Never crash the agent on observability failure
+  }
+}
+
+/**
+ * Send a real-time intermediate event to /v1/activity (in-memory, streamed
+ * to dashboard via SSE). Fire-and-forget — no retry, no crash on failure.
+ */
+function sendActivity(
+  type:        string,
+  agentId:     string,
+  sessionKey:  string | undefined,
+  runId:       string | undefined,
+  data?:       Record<string, unknown>,
+): void {
+  if (!API_KEY) return;
+  const payload = JSON.stringify({
+    type,
+    agent_id:    agentId,
+    session_key: sessionKey,
+    run_id:      runId,
+    ts:          Date.now(),
+    data:        data ?? null,
+  });
+  fetch(`${BASE_URL}/v1/activity`, {
+    method: "POST",
+    headers: {
+      "Content-Type":  "application/json",
+      "Authorization": `Bearer ${API_KEY}`,
+    },
+    body: payload,
+  }).catch(() => {});
+}
+
+function emptyRun(sessionKey?: string): RunMeta {
+  return {
+    inputTokens: 0, outputTokens: 0,
+    cacheReadTokens: 0, cacheWriteTokens: 0,
+    llmCalls: 0, imagesCount: 0,
+    toolCalls: 0, toolErrors: 0, toolNames: new Set(),
+    subagentsSpawned: 0, subagentErrors: 0,
+    sessionKey,
+  };
+}
+
+// ─── Plugin ───────────────────────────────────────────────────────────────────
+
+const plugin = {
+  id:          "agentmetrics",
+  name:        "AgentMetrics",
+  description: "360-degree observability for every OpenClaw agent — real-time streaming, tokens, tools, latency, cost, subagents, and reliability.",
+  configSchema: {
+    type: "object",
+    properties: {
+      apiKey: {
+        type:        "string",
+        description: "AgentMetrics API key (overrides AGENTMETRICS_API_KEY env var)",
+      },
+      endpoint: {
+        type:        "string",
+        description: "Custom API endpoint (default: https://api.agentmetrics.dev)",
+      },
+    },
+    additionalProperties: false,
+  } as const,
+
+  register(api: any) {
+    // Config: pluginConfig > env vars
+    API_KEY  = api.config?.apiKey  ?? process.env.AGENTMETRICS_API_KEY;
+    BASE_URL = (
+      api.config?.endpoint ??
+      process.env.AGENTMETRICS_URL ??
+      "https://api.agentmetrics.dev"
+    ).replace(/\/$/, "");
+
+    // Auto-enable when a key is available (env var or plugin config)
+    if (typeof api.registerAutoEnableProbe === "function") {
+      api.registerAutoEnableProbe(() => !!API_KEY);
+    }
+
+    if (!API_KEY) return;
+
+    // CLI: openclaw agentmetrics status
+    if (typeof api.registerCli === "function") {
+      api.registerCli({
+        name:        "agentmetrics",
+        description: "AgentMetrics observability commands",
+        commands: [
+          {
+            name:        "status",
+            description: "Show current AgentMetrics plugin status",
+            handler() {
+              const keyPreview = API_KEY
+                ? `${API_KEY.slice(0, 8)}...${API_KEY.slice(-4)}`
+                : "(not set)";
+              console.log("AgentMetrics — active");
+              console.log(`  API key  : ${keyPreview}`);
+              console.log(`  Endpoint : ${BASE_URL}`);
+              console.log(`  Sessions : ${sessions.size} tracked`);
+              console.log(`  Runs     : ${runs.size} in flight`);
+            },
+          },
+        ],
+      });
+    }
+
+    // ── gateway_start ─────────────────────────────────────────────────────
+    api.on("gateway_start", (event: GatewayStartEvent, _ctx: GatewayContext) => {
+      sendActivity("gateway_start", "openclaw-gateway", undefined, undefined, {
+        port: event.port,
+      });
+      send({
+        trace_id: randomUUID(),
+        agent_id: "openclaw-gateway",
+        status:   "success",
+        metadata: { event_type: "gateway_start", port: event.port },
+      });
+    });
+
+    // ── gateway_stop ──────────────────────────────────────────────────────
+    api.on("gateway_stop", (event: GatewayStopEvent, _ctx: GatewayContext) => {
+      sendActivity("gateway_stop", "openclaw-gateway", undefined, undefined, {
+        reason: event.reason,
+      });
+      send({
+        trace_id: randomUUID(),
+        agent_id: "openclaw-gateway",
+        status:   "success",
+        metadata: { event_type: "gateway_stop", reason: event.reason },
+      });
+    });
+
+    // ── session_start ─────────────────────────────────────────────────────
+    api.on("session_start", (event: SessionStartEvent, ctx: SessionContext) => {
+      const key = event.sessionKey ?? event.sessionId;
+      if (!key || sessions.has(key)) return;
+
+      sessions.set(key, {
+        traceId:     randomUUID(),
+        agentId:     ctx.agentId ?? "openclaw-agent",
+        startedAt:   Date.now(),
+        compactions: 0,
+        resets:      0,
+      });
+    });
+
+    // ── before_agent_start ────────────────────────────────────────────────
+    // Fires at the start of each run. Sends run_start for real-time UI.
+    api.on("before_agent_start", (event: BeforeAgentStartEvent, ctx: AgentContext) => {
+      const sessionKey = ctx.sessionKey ?? ctx.sessionId;
+      const agentId    = ctx.agentId ?? "openclaw-agent";
+      const runId      = ctx.runId;
+
+      if (!runId && !sessionKey) return;
+
+      sendActivity("run_start", agentId, sessionKey, runId, {
+        model:    ctx.modelId,
+        provider: ctx.modelProviderId,
+      });
+    });
+
+    // ── llm_input ─────────────────────────────────────────────────────────
+    // Fires before each LLM call. Sends llm_start for real-time "thinking"
+    // indicator. Also accumulates LLM call count and image count.
+    api.on("llm_input", (event: LlmInputEvent, ctx: AgentContext) => {
+      const { runId } = event;
+      if (!runId) return;
+
+      const sessionKey = ctx.sessionKey ?? ctx.sessionId ?? event.sessionId;
+      const agentId    = ctx.agentId ?? sessions.get(sessionKey ?? "")?.agentId ?? "openclaw-agent";
+      const run = runs.get(runId) ?? emptyRun(sessionKey);
+
+      run.llmCalls    += 1;
+      run.imagesCount += event.imagesCount ?? 0;
+      if (!run.model    && event.model)    run.model    = event.model;
+      if (!run.provider && event.provider) run.provider = event.provider;
+      if (!run.sessionKey) run.sessionKey = sessionKey;
+      runs.set(runId, run);
+
+      sendActivity("llm_start", agentId, sessionKey, runId, {
+        model:    event.model,
+        provider: event.provider,
+        images:   event.imagesCount,
+        history:  event.historyMessages?.length ?? 0,
+      });
+    });
+
+    // ── llm_output ────────────────────────────────────────────────────────
+    // Fires after each LLM response. Accumulates tokens and sends llm_end
+    // so the dashboard can show token counts updating in real time.
+    api.on("llm_output", (event: LlmOutputEvent, ctx: AgentContext) => {
+      const { runId } = event;
+      if (!runId) return;
+
+      const sessionKey = ctx.sessionKey ?? ctx.sessionId ?? event.sessionId;
+      const agentId    = ctx.agentId ?? sessions.get(sessionKey ?? "")?.agentId ?? "openclaw-agent";
+      const run = runs.get(runId) ?? emptyRun(sessionKey);
+
+      if (event.usage) {
+        run.inputTokens      += event.usage.input      ?? 0;
+        run.outputTokens     += event.usage.output     ?? 0;
+        run.cacheReadTokens  += event.usage.cacheRead  ?? 0;
+        run.cacheWriteTokens += event.usage.cacheWrite ?? 0;
+      }
+      if (event.model)    run.model    = event.model;
+      if (event.provider) run.provider = event.provider;
+      if (!run.sessionKey) run.sessionKey = sessionKey;
+      runs.set(runId, run);
+
+      sendActivity("llm_end", agentId, sessionKey, runId, {
+        model:         event.model,
+        provider:      event.provider,
+        input_tokens:  event.usage?.input,
+        output_tokens: event.usage?.output,
+        cache_read:    event.usage?.cacheRead,
+        cache_write:   event.usage?.cacheWrite,
+        // Running totals for the dashboard
+        total_input:   run.inputTokens,
+        total_output:  run.outputTokens,
+      });
+    });
+
+    // ── before_tool_call ──────────────────────────────────────────────────
+    // Fires before each tool execution. Sends tool_start immediately so
+    // the live visualizer shows tool activity in real time.
+    api.on("before_tool_call", (event: BeforeToolCallEvent, ctx: ToolContext) => {
+      const runId      = event.runId ?? ctx.runId;
+      const sessionKey = ctx.sessionKey ?? ctx.sessionId;
+      const agentId    = ctx.agentId ?? sessions.get(sessionKey ?? "")?.agentId ?? "openclaw-agent";
+
+      sendActivity("tool_start", agentId, sessionKey, runId, {
+        tool_name: event.toolName,
+      });
+    });
+
+    // ── after_tool_call ───────────────────────────────────────────────────
+    // Fires after every tool execution. Counts calls/errors and sends
+    // tool_end with outcome and duration.
+    api.on("after_tool_call", (event: AfterToolCallEvent, ctx: ToolContext) => {
+      const runId      = event.runId ?? ctx.runId;
+      const sessionKey = ctx.sessionKey ?? ctx.sessionId;
+      const agentId    = ctx.agentId ?? sessions.get(sessionKey ?? "")?.agentId ?? "openclaw-agent";
+
+      if (runId) {
+        const run = runs.get(runId) ?? emptyRun(sessionKey);
+        run.toolCalls += 1;
+        if (event.error) run.toolErrors += 1;
+        run.toolNames.add(event.toolName);
+        if (!run.sessionKey) run.sessionKey = sessionKey;
+        runs.set(runId, run);
+      }
+
+      sendActivity("tool_end", agentId, sessionKey, runId, {
+        tool_name:   event.toolName,
+        duration_ms: event.durationMs,
+        error:       event.error?.slice(0, 200),
+      });
+    });
+
+    // ── subagent_spawning ─────────────────────────────────────────────────
+    api.on("subagent_spawning", (event: SubagentSpawningEvent, ctx: SubagentContext) => {
+      const runId      = ctx.runId;
+      const sessionKey = ctx.requesterSessionKey;
+      const agentId    = sessions.get(sessionKey ?? "")?.agentId ?? "openclaw-agent";
+
+      if (runId) {
+        const run = runs.get(runId);
+        if (run) {
+          run.subagentsSpawned += 1;
+          runs.set(runId, run);
+        }
+      }
+
+      sendActivity("subagent_start", agentId, sessionKey, runId, {
+        child_agent_id:    event.agentId,
+        child_session_key: event.childSessionKey,
+        mode:              event.mode,
+        label:             event.label,
+      });
+    });
+
+    // ── subagent_ended ────────────────────────────────────────────────────
+    api.on("subagent_ended", (event: SubagentEndedEvent, ctx: SubagentContext) => {
+      const runId      = event.runId ?? ctx.runId;
+      const sessionKey = ctx.requesterSessionKey;
+      const agentId    = sessions.get(sessionKey ?? "")?.agentId ?? "openclaw-agent";
+
+      if (runId) {
+        const run = runs.get(runId);
+        if (run && event.outcome && event.outcome !== "ok") {
+          run.subagentErrors += 1;
+          runs.set(runId, run);
+        }
+      }
+
+      sendActivity("subagent_end", agentId, sessionKey, runId, {
+        child_session_key: event.targetSessionKey,
+        outcome:           event.outcome,
+        error:             event.error?.slice(0, 200),
+      });
+    });
+
+    // ── before_compaction ─────────────────────────────────────────────────
+    api.on("before_compaction", (_event: CompactionEvent, ctx: AgentContext) => {
+      const key     = ctx.sessionKey ?? ctx.sessionId;
+      const agentId = ctx.agentId ?? sessions.get(key ?? "")?.agentId ?? "openclaw-agent";
+      if (!key) return;
+
+      const session = sessions.get(key);
+      if (session) {
+        session.compactions += 1;
+        sessions.set(key, session);
+      }
+
+      sendActivity("compaction", agentId, key, ctx.runId);
+    });
+
+    // ── before_reset ──────────────────────────────────────────────────────
+    api.on("before_reset", (event: ResetEvent, ctx: AgentContext) => {
+      const key     = ctx.sessionKey ?? ctx.sessionId;
+      const agentId = ctx.agentId ?? sessions.get(key ?? "")?.agentId ?? "openclaw-agent";
+      if (!key) return;
+
+      const session = sessions.get(key);
+      if (session) {
+        session.resets += 1;
+        sessions.set(key, session);
+      }
+
+      sendActivity("reset", agentId, key, ctx.runId, { reason: event.reason });
+    });
+
+    // ── agent_end ─────────────────────────────────────────────────────────
+    // Fires when the agent finishes a run. Sends run_end for real-time UI,
+    // then the full persisted event to /v1/events with all accumulated data.
+    api.on("agent_end", (event: AgentEndEvent, ctx: AgentContext) => {
+      const sessionKey = ctx.sessionKey ?? ctx.sessionId;
+      if (!sessionKey) return;
+
+      const session = sessions.get(sessionKey);
+      const run     = ctx.runId ? runs.get(ctx.runId) : undefined;
+      const agentId = ctx.agentId ?? session?.agentId ?? "openclaw-agent";
+
+      if (session) session.agentId = agentId;
+
+      const totalTokens =
+        (run?.inputTokens      ?? 0) +
+        (run?.outputTokens     ?? 0) +
+        (run?.cacheReadTokens  ?? 0) +
+        (run?.cacheWriteTokens ?? 0);
+
+      // Real-time: notify dashboard the run finished
+      sendActivity("run_end", agentId, sessionKey, ctx.runId, {
+        status:       event.success ? "success" : "failed",
+        duration_ms:  event.durationMs ?? (session ? Date.now() - session.startedAt : undefined),
+        total_tokens: totalTokens || undefined,
+        tool_calls:   run?.toolCalls,
+        error:        event.error?.slice(0, 200),
+      });
+
+      // Persistent: full summary stored in DB
+      send({
+        trace_id:            session?.traceId ?? randomUUID(),
+        agent_id:            agentId,
+        status:              event.success ? "success" : "failed",
+        duration_ms:         event.durationMs ?? (session ? Date.now() - session.startedAt : undefined),
+        model:               run?.model,
+        model_provider:      run?.provider,
+        input_tokens:        run?.inputTokens      ?? 0,
+        output_tokens:       run?.outputTokens     ?? 0,
+        cache_read_tokens:   run?.cacheReadTokens  ?? 0,
+        cache_write_tokens:  run?.cacheWriteTokens ?? 0,
+        total_tokens:        totalTokens || undefined,
+        tool_calls:          run?.toolCalls  ?? 0,
+        tool_errors:         run?.toolErrors ?? 0,
+        step_count:          event.messages?.length,
+        ...(event.error ? { error: event.error.slice(0, 500) } : {}),
+        metadata: {
+          llm_calls:         run?.llmCalls         ?? 0,
+          images_count:      run?.imagesCount       ?? 0,
+          subagents_spawned: run?.subagentsSpawned  ?? 0,
+          subagent_errors:   run?.subagentErrors    ?? 0,
+          compactions:       session?.compactions   ?? 0,
+          resets:            session?.resets        ?? 0,
+          tool_names:        run ? [...run.toolNames] : [],
+        },
+      });
+
+      if (ctx.runId) runs.delete(ctx.runId);
+    });
+
+    // ── session_end ───────────────────────────────────────────────────────
+    api.on("session_end", (event: SessionEndEvent, _ctx: SessionContext) => {
+      const key = event.sessionKey ?? event.sessionId;
+      sessions.delete(key);
+    });
+  },
+};
+
+export default plugin;

package/openclaw.plugin.json

@@ -0,0 +1,19 @@
+{
+  "id": "agentmetrics",
+  "name": "AgentMetrics",
+  "description": "360-degree observability for every OpenClaw agent — tokens, tools, latency, cost, subagents, context health, and reliability.",
+  "configSchema": {
+    "type": "object",
+    "properties": {
+      "apiKey": {
+        "type": "string",
+        "description": "AgentMetrics API key (overrides AGENTMETRICS_API_KEY env var)"
+      },
+      "endpoint": {
+        "type": "string",
+        "description": "Custom API endpoint (default: https://api.agentmetrics.dev)"
+      }
+    },
+    "additionalProperties": false
+  }
+}

package/package.json

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

package/hooks/agentmetrics/HOOK.md

@@ -1,35 +0,0 @@
----
-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

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

package/hooks/agentmetrics/handler.js

@@ -1,78 +0,0 @@
-"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,
-        });
-    }
-}