@analytix402/openclaw-skill 0.1.0 → 0.1.2

package/SKILL.md

@@ -16,16 +16,19 @@ Analytix402 gives your OpenClaw agent financial visibility and guardrails. Track
 
 ## Configuration
 
+Add these to your OpenClaw agent's `.env` file:
+
 ```yaml
 # Required
 ANALYTIX402_API_KEY: ax_live_your_key_here
 
 # Optional
-ANALYTIX402_AGENT_ID: my-openclaw-agent
-ANALYTIX402_BASE_URL: https://analytix402.com
-ANALYTIX402_DAILY_BUDGET: 50.00
-ANALYTIX402_PER_CALL_LIMIT: 5.00
-ANALYTIX402_TRACK_LLM: true
+ANALYTIX402_AGENT_ID: my-openclaw-agent        # Unique ID shown in dashboard
+ANALYTIX402_AGENT_NAME: My OpenClaw Agent       # Display name (defaults to agent ID)
+ANALYTIX402_BASE_URL: https://analytix402.com   # Custom endpoint
+ANALYTIX402_DAILY_BUDGET: 50.00                 # Daily spend limit in USD (0 = unlimited)
+ANALYTIX402_PER_CALL_LIMIT: 5.00                # Per-call cap in USD (0 = unlimited)
+ANALYTIX402_TRACK_LLM: true                     # LLM tracking (enabled by default)
 ```
 
 ## Tools
@@ -42,6 +45,14 @@ Check remaining budget before making an expensive API call.
 ### analytix402_flag_purchase
 Flag a potential duplicate or unnecessary purchase for review.
 
+## Verify it works
+
+1. Start your OpenClaw agent — the skill connects automatically on load
+2. Open the [Agents dashboard](https://analytix402.com/agents.html) — your agent should appear within seconds
+3. The agent stays visible with a heartbeat every 60 seconds
+
+No need to call any tools first. The skill registers itself immediately on startup.
+
 ## Tags
 
 monitoring, analytics, budget, x402, payments, observability, cost-tracking

package/dist/index.js

@@ -1,3 +1,4 @@
+"use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
@@ -29,242 +30,7 @@ __export(index_exports, {
   trackLLMCall: () => trackLLMCall
 });
 module.exports = __toCommonJS(index_exports);
-
-// ../sdk/src/client.ts
-var SDK_NAME = "@analytix402/sdk";
-var SDK_VERSION = "0.1.1";
-var DEFAULT_CONFIG = {
-  baseUrl: "https://analytix402.com",
-  debug: false,
-  batchSize: 100,
-  flushInterval: 5e3,
-  maxRetries: 3,
-  maxQueueSize: 1e3,
-  timeout: 1e4,
-  excludePaths: ["/health", "/healthz", "/ready", "/metrics", "/favicon.ico"]
-};
-function createClient(config) {
-  if (!config.apiKey) {
-    throw new Error("Analytix402: apiKey is required");
-  }
-  if (!config.apiKey.startsWith("ax_live_") && !config.apiKey.startsWith("ax_test_")) {
-    console.warn("Analytix402: API key should start with ax_live_ or ax_test_");
-  }
-  const cfg = {
-    ...DEFAULT_CONFIG,
-    ...config
-  };
-  const agentId = cfg.agentId;
-  const queue = [];
-  let flushTimer = null;
-  let isFlushing = false;
-  let isShutdown = false;
-  const log = (...args) => {
-    if (cfg.debug) {
-      console.log("[Analytix402]", ...args);
-    }
-  };
-  const warn = (...args) => {
-    console.warn("[Analytix402]", ...args);
-  };
-  function enqueue(event) {
-    if (isShutdown) {
-      warn("Client is shutdown, event dropped");
-      return;
-    }
-    if (queue.length >= cfg.maxQueueSize) {
-      warn(`Queue full (${cfg.maxQueueSize}), dropping oldest event`);
-      queue.shift();
-    }
-    queue.push({
-      event,
-      attempts: 0,
-      addedAt: Date.now()
-    });
-    log(`Event queued (${queue.length} in queue)`);
-    if (queue.length >= cfg.batchSize) {
-      log("Batch size reached, flushing");
-      flush();
-    } else if (!flushTimer) {
-      flushTimer = setTimeout(() => {
-        flushTimer = null;
-        flush();
-      }, cfg.flushInterval);
-    }
-  }
-  function track(event) {
-    if (agentId && !event.agentId) {
-      event.agentId = agentId;
-    }
-    enqueue(event);
-  }
-  function heartbeat(status = "healthy", metadata) {
-    if (!agentId) {
-      warn("heartbeat() requires agentId in config");
-      return;
-    }
-    const event = {
-      type: "heartbeat",
-      agentId,
-      status,
-      metadata,
-      timestamp: (/* @__PURE__ */ new Date()).toISOString()
-    };
-    enqueue(event);
-  }
-  function reportOutcome(taskId, success, options) {
-    const event = {
-      type: "task_outcome",
-      agentId,
-      taskId,
-      success,
-      durationMs: options == null ? void 0 : options.durationMs,
-      cost: options == null ? void 0 : options.cost,
-      metadata: options == null ? void 0 : options.metadata,
-      timestamp: (/* @__PURE__ */ new Date()).toISOString()
-    };
-    enqueue(event);
-  }
-  function startTask(taskId) {
-    const id = taskId || `task_${Date.now()}_${Math.random().toString(36).slice(2, 10)}`;
-    const startTime = Date.now();
-    return {
-      taskId: id,
-      end(success, metadata) {
-        const durationMs = Date.now() - startTime;
-        reportOutcome(id, success, { durationMs, metadata });
-      }
-    };
-  }
-  function trackLLM(usage) {
-    const event = {
-      type: "llm_usage",
-      agentId,
-      taskId: usage.taskId,
-      model: usage.model,
-      provider: usage.provider,
-      inputTokens: usage.inputTokens,
-      outputTokens: usage.outputTokens,
-      totalTokens: usage.inputTokens + usage.outputTokens,
-      costUsd: usage.costUsd,
-      durationMs: usage.durationMs,
-      metadata: usage.metadata,
-      timestamp: (/* @__PURE__ */ new Date()).toISOString()
-    };
-    enqueue(event);
-  }
-  async function sendBatch(events) {
-    if (events.length === 0) return true;
-    const payload = {
-      events,
-      sdk: {
-        name: SDK_NAME,
-        version: SDK_VERSION
-      },
-      sentAt: (/* @__PURE__ */ new Date()).toISOString()
-    };
-    try {
-      const controller = new AbortController();
-      const timeoutId = setTimeout(() => controller.abort(), cfg.timeout);
-      const response = await fetch(`${cfg.baseUrl}/api/ingest/batch`, {
-        method: "POST",
-        headers: {
-          "Content-Type": "application/json",
-          "X-API-Key": cfg.apiKey,
-          "User-Agent": `${SDK_NAME}/${SDK_VERSION}`
-        },
-        body: JSON.stringify(payload),
-        signal: controller.signal
-      });
-      clearTimeout(timeoutId);
-      if (!response.ok) {
-        const text = await response.text().catch(() => "Unknown error");
-        throw new Error(`HTTP ${response.status}: ${text}`);
-      }
-      log(`Sent ${events.length} events successfully`);
-      return true;
-    } catch (error) {
-      if (error instanceof Error && error.name === "AbortError") {
-        warn("Request timed out");
-      } else {
-        warn("Failed to send events:", error);
-      }
-      return false;
-    }
-  }
-  async function flush() {
-    if (isFlushing || queue.length === 0) {
-      return;
-    }
-    isFlushing = true;
-    if (flushTimer) {
-      clearTimeout(flushTimer);
-      flushTimer = null;
-    }
-    const batch = queue.splice(0, cfg.batchSize);
-    const events = batch.map((q) => q.event);
-    log(`Flushing ${events.length} events`);
-    const success = await sendBatch(events);
-    if (!success) {
-      const retriable = batch.filter((q) => q.attempts < cfg.maxRetries);
-      if (retriable.length > 0) {
-        log(`Re-queuing ${retriable.length} events for retry`);
-        for (const item of retriable.reverse()) {
-          item.attempts++;
-          queue.unshift(item);
-        }
-        const backoff = Math.min(1e3 * Math.pow(2, retriable[0].attempts), 3e4);
-        log(`Retry scheduled in ${backoff}ms`);
-        flushTimer = setTimeout(() => {
-          flushTimer = null;
-          flush();
-        }, backoff);
-      } else {
-        warn(`Dropped ${batch.length} events after ${cfg.maxRetries} retries`);
-      }
-    }
-    isFlushing = false;
-    if (queue.length > 0 && !flushTimer) {
-      flushTimer = setTimeout(() => {
-        flushTimer = null;
-        flush();
-      }, cfg.flushInterval);
-    }
-  }
-  async function shutdown2() {
-    log("Shutting down...");
-    isShutdown = true;
-    if (flushTimer) {
-      clearTimeout(flushTimer);
-      flushTimer = null;
-    }
-    if (queue.length > 0) {
-      log(`Flushing ${queue.length} remaining events`);
-      isFlushing = false;
-      await flush();
-    }
-    log("Shutdown complete");
-  }
-  if (typeof process !== "undefined") {
-    const handleExit = () => {
-      shutdown2().catch(console.error);
-    };
-    process.on("beforeExit", handleExit);
-    process.on("SIGINT", handleExit);
-    process.on("SIGTERM", handleExit);
-  }
-  return {
-    track,
-    flush,
-    shutdown: shutdown2,
-    heartbeat,
-    reportOutcome,
-    startTask,
-    trackLLM
-  };
-}
-
-// src/index.ts
+var import_sdk = require("@analytix402/sdk");
 var API_KEY = process.env.ANALYTIX402_API_KEY || "";
 var BASE_URL = (process.env.ANALYTIX402_BASE_URL || "https://analytix402.com").replace(/\/$/, "");
 var AGENT_ID = process.env.ANALYTIX402_AGENT_ID || `openclaw-${Date.now()}`;
@@ -284,15 +50,24 @@ function getClient() {
         "ANALYTIX402_API_KEY is not set. Add it to your OpenClaw skill config."
       );
     }
-    client = createClient({
+    client = (0, import_sdk.createClient)({
       apiKey: API_KEY,
       baseUrl: BASE_URL,
       agentId: AGENT_ID,
-      agentName: AGENT_NAME
+      agentName: AGENT_NAME,
+      autoConnect: true,
+      heartbeatIntervalMs: 6e4
     });
   }
   return client;
 }
+if (API_KEY) {
+  try {
+    getClient();
+  } catch (err) {
+    console.warn("[Analytix402] Failed to connect on startup:", err instanceof Error ? err.message : err);
+  }
+}
 async function apiRequest(method, path, body) {
   const url = `${BASE_URL}/api${path}`;
   const headers = {

package/dist/index.mjs

@@ -1,238 +1,5 @@
-// ../sdk/src/client.ts
-var SDK_NAME = "@analytix402/sdk";
-var SDK_VERSION = "0.1.1";
-var DEFAULT_CONFIG = {
-  baseUrl: "https://analytix402.com",
-  debug: false,
-  batchSize: 100,
-  flushInterval: 5e3,
-  maxRetries: 3,
-  maxQueueSize: 1e3,
-  timeout: 1e4,
-  excludePaths: ["/health", "/healthz", "/ready", "/metrics", "/favicon.ico"]
-};
-function createClient(config) {
-  if (!config.apiKey) {
-    throw new Error("Analytix402: apiKey is required");
-  }
-  if (!config.apiKey.startsWith("ax_live_") && !config.apiKey.startsWith("ax_test_")) {
-    console.warn("Analytix402: API key should start with ax_live_ or ax_test_");
-  }
-  const cfg = {
-    ...DEFAULT_CONFIG,
-    ...config
-  };
-  const agentId = cfg.agentId;
-  const queue = [];
-  let flushTimer = null;
-  let isFlushing = false;
-  let isShutdown = false;
-  const log = (...args) => {
-    if (cfg.debug) {
-      console.log("[Analytix402]", ...args);
-    }
-  };
-  const warn = (...args) => {
-    console.warn("[Analytix402]", ...args);
-  };
-  function enqueue(event) {
-    if (isShutdown) {
-      warn("Client is shutdown, event dropped");
-      return;
-    }
-    if (queue.length >= cfg.maxQueueSize) {
-      warn(`Queue full (${cfg.maxQueueSize}), dropping oldest event`);
-      queue.shift();
-    }
-    queue.push({
-      event,
-      attempts: 0,
-      addedAt: Date.now()
-    });
-    log(`Event queued (${queue.length} in queue)`);
-    if (queue.length >= cfg.batchSize) {
-      log("Batch size reached, flushing");
-      flush();
-    } else if (!flushTimer) {
-      flushTimer = setTimeout(() => {
-        flushTimer = null;
-        flush();
-      }, cfg.flushInterval);
-    }
-  }
-  function track(event) {
-    if (agentId && !event.agentId) {
-      event.agentId = agentId;
-    }
-    enqueue(event);
-  }
-  function heartbeat(status = "healthy", metadata) {
-    if (!agentId) {
-      warn("heartbeat() requires agentId in config");
-      return;
-    }
-    const event = {
-      type: "heartbeat",
-      agentId,
-      status,
-      metadata,
-      timestamp: (/* @__PURE__ */ new Date()).toISOString()
-    };
-    enqueue(event);
-  }
-  function reportOutcome(taskId, success, options) {
-    const event = {
-      type: "task_outcome",
-      agentId,
-      taskId,
-      success,
-      durationMs: options == null ? void 0 : options.durationMs,
-      cost: options == null ? void 0 : options.cost,
-      metadata: options == null ? void 0 : options.metadata,
-      timestamp: (/* @__PURE__ */ new Date()).toISOString()
-    };
-    enqueue(event);
-  }
-  function startTask(taskId) {
-    const id = taskId || `task_${Date.now()}_${Math.random().toString(36).slice(2, 10)}`;
-    const startTime = Date.now();
-    return {
-      taskId: id,
-      end(success, metadata) {
-        const durationMs = Date.now() - startTime;
-        reportOutcome(id, success, { durationMs, metadata });
-      }
-    };
-  }
-  function trackLLM(usage) {
-    const event = {
-      type: "llm_usage",
-      agentId,
-      taskId: usage.taskId,
-      model: usage.model,
-      provider: usage.provider,
-      inputTokens: usage.inputTokens,
-      outputTokens: usage.outputTokens,
-      totalTokens: usage.inputTokens + usage.outputTokens,
-      costUsd: usage.costUsd,
-      durationMs: usage.durationMs,
-      metadata: usage.metadata,
-      timestamp: (/* @__PURE__ */ new Date()).toISOString()
-    };
-    enqueue(event);
-  }
-  async function sendBatch(events) {
-    if (events.length === 0) return true;
-    const payload = {
-      events,
-      sdk: {
-        name: SDK_NAME,
-        version: SDK_VERSION
-      },
-      sentAt: (/* @__PURE__ */ new Date()).toISOString()
-    };
-    try {
-      const controller = new AbortController();
-      const timeoutId = setTimeout(() => controller.abort(), cfg.timeout);
-      const response = await fetch(`${cfg.baseUrl}/api/ingest/batch`, {
-        method: "POST",
-        headers: {
-          "Content-Type": "application/json",
-          "X-API-Key": cfg.apiKey,
-          "User-Agent": `${SDK_NAME}/${SDK_VERSION}`
-        },
-        body: JSON.stringify(payload),
-        signal: controller.signal
-      });
-      clearTimeout(timeoutId);
-      if (!response.ok) {
-        const text = await response.text().catch(() => "Unknown error");
-        throw new Error(`HTTP ${response.status}: ${text}`);
-      }
-      log(`Sent ${events.length} events successfully`);
-      return true;
-    } catch (error) {
-      if (error instanceof Error && error.name === "AbortError") {
-        warn("Request timed out");
-      } else {
-        warn("Failed to send events:", error);
-      }
-      return false;
-    }
-  }
-  async function flush() {
-    if (isFlushing || queue.length === 0) {
-      return;
-    }
-    isFlushing = true;
-    if (flushTimer) {
-      clearTimeout(flushTimer);
-      flushTimer = null;
-    }
-    const batch = queue.splice(0, cfg.batchSize);
-    const events = batch.map((q) => q.event);
-    log(`Flushing ${events.length} events`);
-    const success = await sendBatch(events);
-    if (!success) {
-      const retriable = batch.filter((q) => q.attempts < cfg.maxRetries);
-      if (retriable.length > 0) {
-        log(`Re-queuing ${retriable.length} events for retry`);
-        for (const item of retriable.reverse()) {
-          item.attempts++;
-          queue.unshift(item);
-        }
-        const backoff = Math.min(1e3 * Math.pow(2, retriable[0].attempts), 3e4);
-        log(`Retry scheduled in ${backoff}ms`);
-        flushTimer = setTimeout(() => {
-          flushTimer = null;
-          flush();
-        }, backoff);
-      } else {
-        warn(`Dropped ${batch.length} events after ${cfg.maxRetries} retries`);
-      }
-    }
-    isFlushing = false;
-    if (queue.length > 0 && !flushTimer) {
-      flushTimer = setTimeout(() => {
-        flushTimer = null;
-        flush();
-      }, cfg.flushInterval);
-    }
-  }
-  async function shutdown2() {
-    log("Shutting down...");
-    isShutdown = true;
-    if (flushTimer) {
-      clearTimeout(flushTimer);
-      flushTimer = null;
-    }
-    if (queue.length > 0) {
-      log(`Flushing ${queue.length} remaining events`);
-      isFlushing = false;
-      await flush();
-    }
-    log("Shutdown complete");
-  }
-  if (typeof process !== "undefined") {
-    const handleExit = () => {
-      shutdown2().catch(console.error);
-    };
-    process.on("beforeExit", handleExit);
-    process.on("SIGINT", handleExit);
-    process.on("SIGTERM", handleExit);
-  }
-  return {
-    track,
-    flush,
-    shutdown: shutdown2,
-    heartbeat,
-    reportOutcome,
-    startTask,
-    trackLLM
-  };
-}
-
 // src/index.ts
+import { createClient } from "@analytix402/sdk";
 var API_KEY = process.env.ANALYTIX402_API_KEY || "";
 var BASE_URL = (process.env.ANALYTIX402_BASE_URL || "https://analytix402.com").replace(/\/$/, "");
 var AGENT_ID = process.env.ANALYTIX402_AGENT_ID || `openclaw-${Date.now()}`;
@@ -256,11 +23,20 @@ function getClient() {
       apiKey: API_KEY,
       baseUrl: BASE_URL,
       agentId: AGENT_ID,
-      agentName: AGENT_NAME
+      agentName: AGENT_NAME,
+      autoConnect: true,
+      heartbeatIntervalMs: 6e4
     });
   }
   return client;
 }
+if (API_KEY) {
+  try {
+    getClient();
+  } catch (err) {
+    console.warn("[Analytix402] Failed to connect on startup:", err instanceof Error ? err.message : err);
+  }
+}
 async function apiRequest(method, path, body) {
   const url = `${BASE_URL}/api${path}`;
   const headers = {

package/package.json

@@ -1,16 +1,85 @@
 {
   "name": "@analytix402/openclaw-skill",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Analytix402 skill for OpenClaw — monitor, control, and optimize your AI agent's spend",
   "main": "dist/index.js",
+  "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "import": "./dist/index.mjs"
+    }
+  },
   "scripts": {
     "build": "tsup src/index.ts --format cjs,esm --dts",
     "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "openclaw": {
+    "tools": {
+      "analytix402_spend_report": {
+        "description": "Get a summary of your agent's spend — total cost, breakdown by API and LLM provider, and efficiency score.",
+        "parameters": {}
+      },
+      "analytix402_set_budget": {
+        "description": "Set or update the daily budget limit for this agent session.",
+        "parameters": {
+          "daily_limit": {
+            "type": "number",
+            "description": "Maximum daily spend in USD (0 = unlimited)"
+          },
+          "per_call_limit": {
+            "type": "number",
+            "description": "Maximum spend per single API call in USD (0 = unlimited)"
+          }
+        }
+      },
+      "analytix402_check_budget": {
+        "description": "Check remaining budget before making an expensive API call.",
+        "parameters": {
+          "estimated_cost": {
+            "type": "number",
+            "description": "The estimated cost in USD for the upcoming API call"
+          }
+        }
+      },
+      "analytix402_flag_purchase": {
+        "description": "Flag a potential duplicate or unnecessary purchase for review.",
+        "parameters": {
+          "url": {
+            "type": "string",
+            "description": "The URL of the API call to flag",
+            "required": true
+          },
+          "reason": {
+            "type": "string",
+            "description": "Why this purchase is being flagged"
+          },
+          "estimated_cost": {
+            "type": "number",
+            "description": "Estimated cost of the flagged purchase in USD"
+          }
+        }
+      }
+    },
+    "hooks": [
+      "trackLLMCall",
+      "trackAPICall",
+      "sendHeartbeat",
+      "shutdown"
+    ]
   },
+  "files": [
+    "dist",
+    "SKILL.md",
+    "README.md"
+  ],
   "keywords": [
     "openclaw",
+    "openclaw-skill",
     "analytix402",
     "x402",
     "ai-agent",
@@ -22,7 +91,7 @@
   "author": "Analytix402",
   "license": "MIT",
   "dependencies": {
-    "@analytix402/sdk": "^0.1.1"
+    "@analytix402/sdk": "^0.1.2"
   },
   "devDependencies": {
     "@types/node": "^20.10.0",

package/src/index.ts

@@ -1,335 +0,0 @@
-/**
- * Analytix402 OpenClaw Skill
- *
- * Provides AI agent spend tracking, budget enforcement,
- * and observability for OpenClaw agents.
- *
- * Integrates with the Analytix402 platform to give operators
- * real-time visibility into what their agents are spending.
- */
-
-import { createClient } from '../../sdk/src/client';
-import type { Analytix402Client } from '../../sdk/src/types';
-
-// ============================================================
-// Configuration
-// ============================================================
-
-const API_KEY = process.env.ANALYTIX402_API_KEY || '';
-const BASE_URL = (process.env.ANALYTIX402_BASE_URL || 'https://analytix402.com').replace(/\/$/, '');
-const AGENT_ID = process.env.ANALYTIX402_AGENT_ID || `openclaw-${Date.now()}`;
-const AGENT_NAME = process.env.ANALYTIX402_AGENT_NAME || 'OpenClaw Agent';
-const DAILY_BUDGET = parseFloat(process.env.ANALYTIX402_DAILY_BUDGET || '0') || 0;
-const PER_CALL_LIMIT = parseFloat(process.env.ANALYTIX402_PER_CALL_LIMIT || '0') || 0;
-const TRACK_LLM = process.env.ANALYTIX402_TRACK_LLM !== 'false';
-
-// ============================================================
-// State
-// ============================================================
-
-let client: Analytix402Client | null = null;
-let sessionSpend = 0;
-let sessionCalls = 0;
-let dailySpend = 0;
-const dailySpendDate = new Date().toISOString().slice(0, 10);
-
-function getClient(): Analytix402Client {
-  if (!client) {
-    if (!API_KEY) {
-      throw new Error(
-        'ANALYTIX402_API_KEY is not set. Add it to your OpenClaw skill config.'
-      );
-    }
-    client = createClient({
-      apiKey: API_KEY,
-      baseUrl: BASE_URL,
-      agentId: AGENT_ID,
-      agentName: AGENT_NAME,
-    });
-  }
-  return client;
-}
-
-// ============================================================
-// API helper (for dashboard queries)
-// ============================================================
-
-async function apiRequest(method: string, path: string, body?: unknown): Promise<unknown> {
-  const url = `${BASE_URL}/api${path}`;
-  const headers: Record<string, string> = {
-    'Content-Type': 'application/json',
-    'Authorization': `Bearer ${API_KEY}`,
-    'X-API-Key': API_KEY,
-  };
-
-  const opts: RequestInit = { method, headers };
-  if (body && method !== 'GET') {
-    opts.body = JSON.stringify(body);
-  }
-
-  const res = await fetch(url, opts);
-  const text = await res.text();
-
-  let data;
-  try {
-    data = JSON.parse(text);
-  } catch {
-    data = { raw: text };
-  }
-
-  if (!res.ok) {
-    throw new Error(`Analytix402 API ${res.status}: ${(data as Record<string, string>).error || text}`);
-  }
-
-  return data;
-}
-
-// ============================================================
-// Tool: analytix402_spend_report
-// ============================================================
-
-export async function analytix402_spend_report(): Promise<string> {
-  const c = getClient();
-
-  // Send a heartbeat while we're at it
-  c.heartbeat('healthy', { sessionCalls, sessionSpend });
-
-  try {
-    const overview = await apiRequest('GET', '/agents/overview');
-    const insights = await apiRequest('GET', '/agents/insights');
-
-    return JSON.stringify({
-      session: {
-        totalCalls: sessionCalls,
-        totalSpend: `$${sessionSpend.toFixed(4)}`,
-        dailySpend: `$${dailySpend.toFixed(4)}`,
-        dailyBudget: DAILY_BUDGET > 0 ? `$${DAILY_BUDGET.toFixed(2)}` : 'unlimited',
-        budgetRemaining: DAILY_BUDGET > 0
-          ? `$${(DAILY_BUDGET - dailySpend).toFixed(4)}`
-          : 'unlimited',
-      },
-      platform: overview,
-      insights,
-    }, null, 2);
-  } catch (error) {
-    return JSON.stringify({
-      session: {
-        totalCalls: sessionCalls,
-        totalSpend: `$${sessionSpend.toFixed(4)}`,
-        dailySpend: `$${dailySpend.toFixed(4)}`,
-        dailyBudget: DAILY_BUDGET > 0 ? `$${DAILY_BUDGET.toFixed(2)}` : 'unlimited',
-      },
-      error: error instanceof Error ? error.message : String(error),
-    }, null, 2);
-  }
-}
-
-// ============================================================
-// Tool: analytix402_set_budget
-// ============================================================
-
-export interface SetBudgetParams {
-  daily_limit?: number;
-  per_call_limit?: number;
-}
-
-export function analytix402_set_budget(params: SetBudgetParams): string {
-  const updates: string[] = [];
-
-  if (params.daily_limit !== undefined && params.daily_limit >= 0) {
-    // Update the runtime budget (persists for this session)
-    Object.defineProperty(globalThis, '__ax402_daily_budget', {
-      value: params.daily_limit,
-      writable: true,
-      configurable: true,
-    });
-    updates.push(`Daily budget set to $${params.daily_limit.toFixed(2)}`);
-  }
-
-  if (params.per_call_limit !== undefined && params.per_call_limit >= 0) {
-    Object.defineProperty(globalThis, '__ax402_per_call_limit', {
-      value: params.per_call_limit,
-      writable: true,
-      configurable: true,
-    });
-    updates.push(`Per-call limit set to $${params.per_call_limit.toFixed(2)}`);
-  }
-
-  if (updates.length === 0) {
-    return 'No budget parameters provided. Use daily_limit and/or per_call_limit.';
-  }
-
-  return updates.join('. ') + '.';
-}
-
-// ============================================================
-// Tool: analytix402_check_budget
-// ============================================================
-
-export interface CheckBudgetParams {
-  estimated_cost?: number;
-}
-
-export function analytix402_check_budget(params: CheckBudgetParams): string {
-  const budget = DAILY_BUDGET ||
-    ((globalThis as Record<string, unknown>).__ax402_daily_budget as number) || 0;
-  const callLimit = PER_CALL_LIMIT ||
-    ((globalThis as Record<string, unknown>).__ax402_per_call_limit as number) || 0;
-  const estimated = params.estimated_cost || 0;
-
-  const remaining = budget > 0 ? budget - dailySpend : Infinity;
-  const allowed = (budget === 0 || remaining >= estimated) &&
-                  (callLimit === 0 || estimated <= callLimit);
-
-  return JSON.stringify({
-    allowed,
-    dailyBudget: budget > 0 ? `$${budget.toFixed(2)}` : 'unlimited',
-    dailySpent: `$${dailySpend.toFixed(4)}`,
-    remaining: budget > 0 ? `$${remaining.toFixed(4)}` : 'unlimited',
-    estimatedCost: `$${estimated.toFixed(4)}`,
-    perCallLimit: callLimit > 0 ? `$${callLimit.toFixed(2)}` : 'unlimited',
-    withinPerCallLimit: callLimit === 0 || estimated <= callLimit,
-    withinDailyBudget: budget === 0 || remaining >= estimated,
-  }, null, 2);
-}
-
-// ============================================================
-// Tool: analytix402_flag_purchase
-// ============================================================
-
-export interface FlagPurchaseParams {
-  url: string;
-  reason?: string;
-  estimated_cost?: number;
-}
-
-export function analytix402_flag_purchase(params: FlagPurchaseParams): string {
-  const c = getClient();
-
-  c.track({
-    type: 'request',
-    method: 'FLAG',
-    path: params.url,
-    endpoint: params.url,
-    statusCode: 0,
-    responseTimeMs: 0,
-    timestamp: new Date().toISOString(),
-    agentId: AGENT_ID,
-    metadata: {
-      flagged: true,
-      reason: params.reason || 'Potential duplicate or unnecessary purchase',
-      estimatedCost: params.estimated_cost,
-    },
-  });
-
-  return `Flagged: ${params.url} — ${params.reason || 'potential duplicate purchase'}. This will appear in your Analytix402 dashboard for review.`;
-}
-
-// ============================================================
-// Hooks: auto-track LLM and API calls
-// ============================================================
-
-/**
- * Call this after any LLM invocation to track usage.
- * OpenClaw skills can hook into the agent lifecycle.
- */
-export function trackLLMCall(params: {
-  model: string;
-  provider: string;
-  inputTokens: number;
-  outputTokens: number;
-  costUsd?: number;
-  durationMs?: number;
-  taskId?: string;
-}): void {
-  if (!TRACK_LLM) return;
-
-  const c = getClient();
-  const cost = params.costUsd || 0;
-
-  c.trackLLM({
-    model: params.model,
-    provider: params.provider,
-    inputTokens: params.inputTokens,
-    outputTokens: params.outputTokens,
-    costUsd: params.costUsd,
-    durationMs: params.durationMs,
-    taskId: params.taskId,
-  });
-
-  sessionSpend += cost;
-  sessionCalls += 1;
-
-  // Reset daily spend if date changed
-  const today = new Date().toISOString().slice(0, 10);
-  if (today !== dailySpendDate) {
-    dailySpend = 0;
-  }
-  dailySpend += cost;
-}
-
-/**
- * Call this after any API call to track spend.
- */
-export function trackAPICall(params: {
-  method: string;
-  url: string;
-  statusCode: number;
-  responseTimeMs: number;
-  paymentAmount?: number;
-  paymentCurrency?: string;
-  txHash?: string;
-}): void {
-  const c = getClient();
-
-  const payment = params.paymentAmount
-    ? {
-        amount: String(params.paymentAmount),
-        currency: params.paymentCurrency || 'USDC',
-        wallet: '',
-        status: 'success' as const,
-        txHash: params.txHash,
-      }
-    : undefined;
-
-  c.track({
-    type: 'request',
-    method: params.method,
-    path: params.url,
-    endpoint: params.url,
-    statusCode: params.statusCode,
-    responseTimeMs: params.responseTimeMs,
-    timestamp: new Date().toISOString(),
-    agentId: AGENT_ID,
-    payment,
-  });
-
-  if (params.paymentAmount) {
-    sessionSpend += params.paymentAmount;
-    dailySpend += params.paymentAmount;
-  }
-  sessionCalls += 1;
-}
-
-/**
- * Send a heartbeat — call periodically to show agent is alive.
- */
-export function sendHeartbeat(status: 'healthy' | 'degraded' | 'error' = 'healthy'): void {
-  const c = getClient();
-  c.heartbeat(status, {
-    sessionCalls,
-    sessionSpend,
-    dailySpend,
-    uptime: process.uptime(),
-  });
-}
-
-/**
- * Gracefully shutdown — flush all pending events.
- */
-export async function shutdown(): Promise<void> {
-  if (client) {
-    await client.shutdown();
-    client = null;
-  }
-}