@analytix402/openclaw-skill 0.1.6 → 0.2.1

package/SKILL.md

@@ -1,57 +1,54 @@
-# Analytix402
+---
+name: analytix402
+description: "Monitor and control your AI agent's API spend and LLM costs via the Analytix402 dashboard. Use when: user asks about spending, costs, budget, or wants a spending report."
+homepage: https://analytix402.com
+metadata: { "openclaw": { "emoji": "📊" } }
+---
+
+# Analytix402 Spend Tracking
 
 Monitor, control, and optimize your AI agent's API spend and LLM costs in real-time.
 
-## Description
+## When to Use
 
-Analytix402 gives your OpenClaw agent financial visibility and guardrails. Track every API call, LLM invocation, and x402 payment your agent makes. Set budget limits, detect duplicate purchases, and get alerts before costs spiral.
+- "What's my spending?" / "Show my spend report"
+- "How much have I spent today?"
+- "What's my budget?"
+- "Show agent overview"
+- "Show spending insights"
 
-**What it does:**
-- Tracks all outbound API calls and x402 payments automatically
-- Monitors LLM token usage and costs across OpenAI, Anthropic, and other providers
-- Enforces daily budget limits and per-call spend caps
-- Detects duplicate API purchases to prevent waste
-- Sends heartbeats so you know your agent is alive and healthy
-- Provides a real-time dashboard at analytix402.com
+## When NOT to Use
 
-## Configuration
+- General questions unrelated to spending or budgets
+- Setting up the API key (direct user to dashboard)
 
-Add these to your OpenClaw agent's `.env` file:
+## How to Run Commands
 
-```yaml
-# Required
-ANALYTIX402_API_KEY: ax_live_your_key_here
+CRITICAL: Do NOT create new scripts. Do NOT suggest the user create scripts. Do NOT use node -e. Pre-built scripts already exist. Just run them using the exec tool.
 
-# Optional
-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)
+### Full Spend Report (use this when user asks about spending)
+```
+cd C:\Users\samue\.openclaw\workspace && node spend-report.js
 ```
 
-## Tools
-
-### analytix402_spend_report
-Get a summary of your agent's spend — total cost, breakdown by API and LLM provider, and efficiency score.
-
-### analytix402_set_budget
-Set or update the daily budget limit for this agent session.
-
-### analytix402_check_budget
-Check remaining budget before making an expensive API call.
-
-### analytix402_flag_purchase
-Flag a potential duplicate or unnecessary purchase for review.
+### Check Budget
+```
+cd C:\Users\samue\.openclaw\workspace && node check-budget.js
+```
 
-## Verify it works
+### Set Daily Budget (replace 10 and 1 with desired values)
+```
+cd C:\Users\samue\.openclaw\workspace && node set-budget.js 10 1
+```
 
-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
+## IMPORTANT RULES
 
-No need to call any tools first. The skill registers itself immediately on startup.
+1. ALWAYS use the `exec` tool — do NOT ask the user to run commands manually
+2. ALWAYS use the EXACT commands above — do NOT modify them
+3. Do NOT create new script files — the scripts already exist
+4. Do NOT suggest workarounds — just run the command
+5. The output is JSON — present it in a clean, readable format to the user
+6. For spend reports: highlight total spend, daily spend, budget status, fleet health, and number of requests
 
 ## Tags
 

package/dist/index.d.mts

@@ -56,5 +56,7 @@ declare function sendHeartbeat(status?: 'healthy' | 'degraded' | 'error'): void;
  * Gracefully shutdown — flush all pending events.
  */
 declare function shutdown(): Promise<void>;
+declare function register(ctx?: Record<string, unknown>): void;
+declare function activate(ctx?: Record<string, unknown>): void;
 
-export { type CheckBudgetParams, type FlagPurchaseParams, type SetBudgetParams, analytix402_check_budget, analytix402_flag_purchase, analytix402_set_budget, analytix402_spend_report, sendHeartbeat, shutdown, trackAPICall, trackLLMCall };
+export { type CheckBudgetParams, type FlagPurchaseParams, type SetBudgetParams, activate, analytix402_check_budget, analytix402_flag_purchase, analytix402_set_budget, analytix402_spend_report, register, sendHeartbeat, shutdown, trackAPICall, trackLLMCall };

package/dist/index.d.ts

@@ -56,5 +56,7 @@ declare function sendHeartbeat(status?: 'healthy' | 'degraded' | 'error'): void;
  * Gracefully shutdown — flush all pending events.
  */
 declare function shutdown(): Promise<void>;
+declare function register(ctx?: Record<string, unknown>): void;
+declare function activate(ctx?: Record<string, unknown>): void;
 
-export { type CheckBudgetParams, type FlagPurchaseParams, type SetBudgetParams, analytix402_check_budget, analytix402_flag_purchase, analytix402_set_budget, analytix402_spend_report, sendHeartbeat, shutdown, trackAPICall, trackLLMCall };
+export { type CheckBudgetParams, type FlagPurchaseParams, type SetBudgetParams, activate, analytix402_check_budget, analytix402_flag_purchase, analytix402_set_budget, analytix402_spend_report, register, sendHeartbeat, shutdown, trackAPICall, trackLLMCall };

package/dist/index.js

@@ -1,7 +1,9 @@
 "use strict";
+var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -15,15 +17,25 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  activate: () => activate,
   analytix402_check_budget: () => analytix402_check_budget,
   analytix402_flag_purchase: () => analytix402_flag_purchase,
   analytix402_set_budget: () => analytix402_set_budget,
   analytix402_spend_report: () => analytix402_spend_report,
+  register: () => register,
   sendHeartbeat: () => sendHeartbeat,
   shutdown: () => shutdown,
   trackAPICall: () => trackAPICall,
@@ -31,6 +43,45 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 var import_sdk = require("@analytix402/sdk");
+var fs = __toESM(require("fs"));
+var path = __toESM(require("path"));
+function loadEnvFile() {
+  const thisDir = path.dirname(
+    typeof __filename !== "undefined" ? __filename : ""
+  );
+  const candidates = [
+    ...thisDir ? [
+      path.resolve(thisDir, "..", ".env"),
+      // plugin root (extensions/openclaw-skill/.env)
+      path.resolve(thisDir, ".env")
+      // dist/.env
+    ] : [],
+    path.join(process.cwd(), ".env"),
+    // cwd
+    path.resolve(process.env.HOME || process.env.USERPROFILE || "", ".openclaw", "workspace", ".env"),
+    path.resolve(process.env.HOME || process.env.USERPROFILE || "", ".openclaw", ".env")
+  ];
+  for (const envPath of candidates) {
+    try {
+      if (!fs.existsSync(envPath)) continue;
+      const content = fs.readFileSync(envPath, "utf-8");
+      for (const line of content.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith("#")) continue;
+        const eqIdx = trimmed.indexOf("=");
+        if (eqIdx < 0) continue;
+        const key = trimmed.slice(0, eqIdx).trim();
+        const val = trimmed.slice(eqIdx + 1).trim();
+        if (key.startsWith("ANALYTIX402_") && !process.env[key]) {
+          process.env[key] = val;
+        }
+      }
+      break;
+    } catch {
+    }
+  }
+}
+loadEnvFile();
 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()}`;
@@ -47,7 +98,7 @@ function getClient() {
   if (!client) {
     if (!API_KEY) {
       throw new Error(
-        "ANALYTIX402_API_KEY is not set. Add it to your OpenClaw skill config."
+        'ANALYTIX402_API_KEY is not set. Run "npx @analytix402/openclaw-skill init" to configure.'
       );
     }
     client = (0, import_sdk.createClient)({
@@ -61,44 +112,224 @@ function getClient() {
   }
   return client;
 }
+var MODEL_PRICING = {
+  // Anthropic
+  "claude-opus-4-6": { input: 15, output: 75 },
+  "claude-sonnet-4-5-20250929": { input: 3, output: 15 },
+  "claude-haiku-4-5-20251001": { input: 0.25, output: 1.25 },
+  "claude-3-5-sonnet-20241022": { input: 3, output: 15 },
+  "claude-3-5-haiku-20241022": { input: 0.25, output: 1.25 },
+  "claude-3-opus-20240229": { input: 15, output: 75 },
+  // OpenAI
+  "gpt-4o": { input: 2.5, output: 10 },
+  "gpt-4o-2024-11-20": { input: 2.5, output: 10 },
+  "gpt-4o-mini": { input: 0.15, output: 0.6 },
+  "gpt-4-turbo": { input: 10, output: 30 },
+  "o1": { input: 15, output: 60 },
+  "o1-mini": { input: 1.1, output: 4.4 },
+  "o3-mini": { input: 1.1, output: 4.4 }
+};
+function calculateCost(model, inputTokens, outputTokens) {
+  const pricing = MODEL_PRICING[model] || Object.entries(MODEL_PRICING).find(([key]) => model.startsWith(key))?.[1];
+  if (!pricing) return 0;
+  return (inputTokens * pricing.input + outputTokens * pricing.output) / 1e6;
+}
+var LLM_API_HOSTS = ["api.anthropic.com", "api.openai.com"];
+var originalFetch = globalThis.fetch;
+function createStreamingProxy(response, host, startTime) {
+  const reader = response.body.getReader();
+  const decoder = new TextDecoder();
+  let inputTokens = 0;
+  let outputTokens = 0;
+  let model = "unknown";
+  let sseBuffer = "";
+  function processSSEEvent(eventData) {
+    try {
+      const parsed = JSON.parse(eventData);
+      if (host === "api.anthropic.com") {
+        if (parsed.type === "message_start" && parsed.message) {
+          model = parsed.message.model || model;
+          inputTokens = parsed.message.usage?.input_tokens || 0;
+        }
+        if (parsed.type === "message_delta" && parsed.usage) {
+          outputTokens = parsed.usage.output_tokens || 0;
+        }
+      } else if (host === "api.openai.com") {
+        if (parsed.model) {
+          model = parsed.model;
+        }
+        if (parsed.usage) {
+          inputTokens = parsed.usage.prompt_tokens || 0;
+          outputTokens = parsed.usage.completion_tokens || 0;
+        }
+      }
+    } catch {
+    }
+  }
+  function processSSEChunk(text) {
+    sseBuffer += text;
+    const lines = sseBuffer.split("\n");
+    sseBuffer = lines.pop() || "";
+    for (const line of lines) {
+      if (line.startsWith("data: ")) {
+        const data = line.slice(6).trim();
+        if (data && data !== "[DONE]") {
+          processSSEEvent(data);
+        }
+      }
+    }
+  }
+  const stream = new ReadableStream({
+    async pull(controller) {
+      try {
+        const { done, value } = await reader.read();
+        if (done) {
+          if (sseBuffer.trim()) {
+            processSSEChunk("\n");
+          }
+          if (inputTokens > 0 || outputTokens > 0) {
+            const durationMs = Date.now() - startTime;
+            const cost = calculateCost(model, inputTokens, outputTokens);
+            trackLLMCall({
+              model,
+              provider: host === "api.anthropic.com" ? "anthropic" : "openai",
+              inputTokens,
+              outputTokens,
+              costUsd: cost,
+              durationMs
+            });
+          }
+          controller.close();
+          return;
+        }
+        processSSEChunk(decoder.decode(value, { stream: true }));
+        controller.enqueue(value);
+      } catch (err) {
+        controller.error(err);
+      }
+    },
+    cancel() {
+      reader.cancel();
+    }
+  });
+  return new Response(stream, {
+    status: response.status,
+    statusText: response.statusText,
+    headers: response.headers
+  });
+}
+function installFetchInterceptor() {
+  if (!TRACK_LLM || !originalFetch) return;
+  globalThis.fetch = async function interceptedFetch(input, init) {
+    const url = typeof input === "string" ? input : input instanceof URL ? input.href : input.url;
+    let host;
+    try {
+      host = new URL(url).host;
+    } catch {
+      host = "";
+    }
+    if (!LLM_API_HOSTS.some((h) => host === h)) {
+      return originalFetch(input, init);
+    }
+    const start = Date.now();
+    const response = await originalFetch(input, init);
+    const contentType = response.headers.get("content-type") || "";
+    if (contentType.includes("text/event-stream") && response.body) {
+      return createStreamingProxy(response, host, start);
+    }
+    if (contentType.includes("application/json")) {
+      const clone = response.clone();
+      clone.text().then((text) => {
+        try {
+          const body = JSON.parse(text);
+          const durationMs = Date.now() - start;
+          if (host === "api.anthropic.com" && body.usage) {
+            const inputTokens = body.usage.input_tokens || 0;
+            const outputTokens = body.usage.output_tokens || 0;
+            const model = body.model || "unknown";
+            const cost = calculateCost(model, inputTokens, outputTokens);
+            trackLLMCall({
+              model,
+              provider: "anthropic",
+              inputTokens,
+              outputTokens,
+              costUsd: cost,
+              durationMs
+            });
+          } else if (host === "api.openai.com" && body.usage) {
+            const inputTokens = body.usage.prompt_tokens || 0;
+            const outputTokens = body.usage.completion_tokens || 0;
+            const model = body.model || "unknown";
+            const cost = calculateCost(model, inputTokens, outputTokens);
+            trackLLMCall({
+              model,
+              provider: "openai",
+              inputTokens,
+              outputTokens,
+              costUsd: cost,
+              durationMs
+            });
+          }
+        } catch {
+        }
+      }).catch(() => {
+      });
+    }
+    return response;
+  };
+}
 if (API_KEY) {
   try {
     getClient();
   } catch (err) {
     console.warn("[Analytix402] Failed to connect on startup:", err instanceof Error ? err.message : err);
   }
+} else {
+  console.warn('[Analytix402] No API key found. Run "npx @analytix402/openclaw-skill init" to set up.');
 }
-async function apiRequest(method, path, body) {
-  const url = `${BASE_URL}/api${path}`;
+installFetchInterceptor();
+async function apiRequest(method, path2, body) {
+  const url = `${BASE_URL}/api${path2}`;
   const headers = {
     "Content-Type": "application/json",
-    "Authorization": `Bearer ${API_KEY}`,
     "X-API-Key": API_KEY
   };
-  const opts = { method, headers };
+  const controller = new AbortController();
+  const timeout = setTimeout(() => controller.abort(), 5e3);
+  const opts = { method, headers, signal: controller.signal };
   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.error || text}`);
+    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.error || text}`);
+    }
+    return data;
+  } finally {
+    clearTimeout(timeout);
   }
-  return data;
 }
 async function analytix402_spend_report() {
   const c = getClient();
-  c.heartbeat("healthy", { sessionCalls, sessionSpend });
   try {
-    const overview = await apiRequest("GET", "/agents/overview");
-    const insights = await apiRequest("GET", "/agents/insights");
-    return JSON.stringify({
+    c.heartbeat("healthy", { sessionCalls, sessionSpend });
+  } catch {
+  }
+  let result;
+  try {
+    const [overview, insights] = await Promise.all([
+      apiRequest("GET", "/agents/overview").catch(() => null),
+      apiRequest("GET", "/agents/insights").catch(() => null)
+    ]);
+    result = JSON.stringify({
       session: {
         totalCalls: sessionCalls,
         totalSpend: `$${sessionSpend.toFixed(4)}`,
@@ -110,7 +341,7 @@ async function analytix402_spend_report() {
       insights
     }, null, 2);
   } catch (error) {
-    return JSON.stringify({
+    result = JSON.stringify({
       session: {
         totalCalls: sessionCalls,
         totalSpend: `$${sessionSpend.toFixed(4)}`,
@@ -120,6 +351,8 @@ async function analytix402_spend_report() {
       error: error instanceof Error ? error.message : String(error)
     }, null, 2);
   }
+  await shutdown();
+  return result;
 }
 function analytix402_set_budget(params) {
   const updates = [];
@@ -242,12 +475,26 @@ async function shutdown() {
     client = null;
   }
 }
+function register(ctx) {
+  if (API_KEY) {
+    try {
+      getClient();
+    } catch (err) {
+      console.warn("[Analytix402] Failed to connect on register:", err instanceof Error ? err.message : err);
+    }
+  }
+}
+function activate(ctx) {
+  return register(ctx);
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  activate,
   analytix402_check_budget,
   analytix402_flag_purchase,
   analytix402_set_budget,
   analytix402_spend_report,
+  register,
   sendHeartbeat,
   shutdown,
   trackAPICall,

package/dist/index.mjs

@@ -1,5 +1,44 @@
 // src/index.ts
 import { createClient } from "@analytix402/sdk";
+import * as fs from "fs";
+import * as path from "path";
+function loadEnvFile() {
+  const thisDir = path.dirname(
+    typeof __filename !== "undefined" ? __filename : ""
+  );
+  const candidates = [
+    ...thisDir ? [
+      path.resolve(thisDir, "..", ".env"),
+      // plugin root (extensions/openclaw-skill/.env)
+      path.resolve(thisDir, ".env")
+      // dist/.env
+    ] : [],
+    path.join(process.cwd(), ".env"),
+    // cwd
+    path.resolve(process.env.HOME || process.env.USERPROFILE || "", ".openclaw", "workspace", ".env"),
+    path.resolve(process.env.HOME || process.env.USERPROFILE || "", ".openclaw", ".env")
+  ];
+  for (const envPath of candidates) {
+    try {
+      if (!fs.existsSync(envPath)) continue;
+      const content = fs.readFileSync(envPath, "utf-8");
+      for (const line of content.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith("#")) continue;
+        const eqIdx = trimmed.indexOf("=");
+        if (eqIdx < 0) continue;
+        const key = trimmed.slice(0, eqIdx).trim();
+        const val = trimmed.slice(eqIdx + 1).trim();
+        if (key.startsWith("ANALYTIX402_") && !process.env[key]) {
+          process.env[key] = val;
+        }
+      }
+      break;
+    } catch {
+    }
+  }
+}
+loadEnvFile();
 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()}`;
@@ -16,7 +55,7 @@ function getClient() {
   if (!client) {
     if (!API_KEY) {
       throw new Error(
-        "ANALYTIX402_API_KEY is not set. Add it to your OpenClaw skill config."
+        'ANALYTIX402_API_KEY is not set. Run "npx @analytix402/openclaw-skill init" to configure.'
       );
     }
     client = createClient({
@@ -30,44 +69,224 @@ function getClient() {
   }
   return client;
 }
+var MODEL_PRICING = {
+  // Anthropic
+  "claude-opus-4-6": { input: 15, output: 75 },
+  "claude-sonnet-4-5-20250929": { input: 3, output: 15 },
+  "claude-haiku-4-5-20251001": { input: 0.25, output: 1.25 },
+  "claude-3-5-sonnet-20241022": { input: 3, output: 15 },
+  "claude-3-5-haiku-20241022": { input: 0.25, output: 1.25 },
+  "claude-3-opus-20240229": { input: 15, output: 75 },
+  // OpenAI
+  "gpt-4o": { input: 2.5, output: 10 },
+  "gpt-4o-2024-11-20": { input: 2.5, output: 10 },
+  "gpt-4o-mini": { input: 0.15, output: 0.6 },
+  "gpt-4-turbo": { input: 10, output: 30 },
+  "o1": { input: 15, output: 60 },
+  "o1-mini": { input: 1.1, output: 4.4 },
+  "o3-mini": { input: 1.1, output: 4.4 }
+};
+function calculateCost(model, inputTokens, outputTokens) {
+  const pricing = MODEL_PRICING[model] || Object.entries(MODEL_PRICING).find(([key]) => model.startsWith(key))?.[1];
+  if (!pricing) return 0;
+  return (inputTokens * pricing.input + outputTokens * pricing.output) / 1e6;
+}
+var LLM_API_HOSTS = ["api.anthropic.com", "api.openai.com"];
+var originalFetch = globalThis.fetch;
+function createStreamingProxy(response, host, startTime) {
+  const reader = response.body.getReader();
+  const decoder = new TextDecoder();
+  let inputTokens = 0;
+  let outputTokens = 0;
+  let model = "unknown";
+  let sseBuffer = "";
+  function processSSEEvent(eventData) {
+    try {
+      const parsed = JSON.parse(eventData);
+      if (host === "api.anthropic.com") {
+        if (parsed.type === "message_start" && parsed.message) {
+          model = parsed.message.model || model;
+          inputTokens = parsed.message.usage?.input_tokens || 0;
+        }
+        if (parsed.type === "message_delta" && parsed.usage) {
+          outputTokens = parsed.usage.output_tokens || 0;
+        }
+      } else if (host === "api.openai.com") {
+        if (parsed.model) {
+          model = parsed.model;
+        }
+        if (parsed.usage) {
+          inputTokens = parsed.usage.prompt_tokens || 0;
+          outputTokens = parsed.usage.completion_tokens || 0;
+        }
+      }
+    } catch {
+    }
+  }
+  function processSSEChunk(text) {
+    sseBuffer += text;
+    const lines = sseBuffer.split("\n");
+    sseBuffer = lines.pop() || "";
+    for (const line of lines) {
+      if (line.startsWith("data: ")) {
+        const data = line.slice(6).trim();
+        if (data && data !== "[DONE]") {
+          processSSEEvent(data);
+        }
+      }
+    }
+  }
+  const stream = new ReadableStream({
+    async pull(controller) {
+      try {
+        const { done, value } = await reader.read();
+        if (done) {
+          if (sseBuffer.trim()) {
+            processSSEChunk("\n");
+          }
+          if (inputTokens > 0 || outputTokens > 0) {
+            const durationMs = Date.now() - startTime;
+            const cost = calculateCost(model, inputTokens, outputTokens);
+            trackLLMCall({
+              model,
+              provider: host === "api.anthropic.com" ? "anthropic" : "openai",
+              inputTokens,
+              outputTokens,
+              costUsd: cost,
+              durationMs
+            });
+          }
+          controller.close();
+          return;
+        }
+        processSSEChunk(decoder.decode(value, { stream: true }));
+        controller.enqueue(value);
+      } catch (err) {
+        controller.error(err);
+      }
+    },
+    cancel() {
+      reader.cancel();
+    }
+  });
+  return new Response(stream, {
+    status: response.status,
+    statusText: response.statusText,
+    headers: response.headers
+  });
+}
+function installFetchInterceptor() {
+  if (!TRACK_LLM || !originalFetch) return;
+  globalThis.fetch = async function interceptedFetch(input, init) {
+    const url = typeof input === "string" ? input : input instanceof URL ? input.href : input.url;
+    let host;
+    try {
+      host = new URL(url).host;
+    } catch {
+      host = "";
+    }
+    if (!LLM_API_HOSTS.some((h) => host === h)) {
+      return originalFetch(input, init);
+    }
+    const start = Date.now();
+    const response = await originalFetch(input, init);
+    const contentType = response.headers.get("content-type") || "";
+    if (contentType.includes("text/event-stream") && response.body) {
+      return createStreamingProxy(response, host, start);
+    }
+    if (contentType.includes("application/json")) {
+      const clone = response.clone();
+      clone.text().then((text) => {
+        try {
+          const body = JSON.parse(text);
+          const durationMs = Date.now() - start;
+          if (host === "api.anthropic.com" && body.usage) {
+            const inputTokens = body.usage.input_tokens || 0;
+            const outputTokens = body.usage.output_tokens || 0;
+            const model = body.model || "unknown";
+            const cost = calculateCost(model, inputTokens, outputTokens);
+            trackLLMCall({
+              model,
+              provider: "anthropic",
+              inputTokens,
+              outputTokens,
+              costUsd: cost,
+              durationMs
+            });
+          } else if (host === "api.openai.com" && body.usage) {
+            const inputTokens = body.usage.prompt_tokens || 0;
+            const outputTokens = body.usage.completion_tokens || 0;
+            const model = body.model || "unknown";
+            const cost = calculateCost(model, inputTokens, outputTokens);
+            trackLLMCall({
+              model,
+              provider: "openai",
+              inputTokens,
+              outputTokens,
+              costUsd: cost,
+              durationMs
+            });
+          }
+        } catch {
+        }
+      }).catch(() => {
+      });
+    }
+    return response;
+  };
+}
 if (API_KEY) {
   try {
     getClient();
   } catch (err) {
     console.warn("[Analytix402] Failed to connect on startup:", err instanceof Error ? err.message : err);
   }
+} else {
+  console.warn('[Analytix402] No API key found. Run "npx @analytix402/openclaw-skill init" to set up.');
 }
-async function apiRequest(method, path, body) {
-  const url = `${BASE_URL}/api${path}`;
+installFetchInterceptor();
+async function apiRequest(method, path2, body) {
+  const url = `${BASE_URL}/api${path2}`;
   const headers = {
     "Content-Type": "application/json",
-    "Authorization": `Bearer ${API_KEY}`,
     "X-API-Key": API_KEY
   };
-  const opts = { method, headers };
+  const controller = new AbortController();
+  const timeout = setTimeout(() => controller.abort(), 5e3);
+  const opts = { method, headers, signal: controller.signal };
   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.error || text}`);
+    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.error || text}`);
+    }
+    return data;
+  } finally {
+    clearTimeout(timeout);
   }
-  return data;
 }
 async function analytix402_spend_report() {
   const c = getClient();
-  c.heartbeat("healthy", { sessionCalls, sessionSpend });
   try {
-    const overview = await apiRequest("GET", "/agents/overview");
-    const insights = await apiRequest("GET", "/agents/insights");
-    return JSON.stringify({
+    c.heartbeat("healthy", { sessionCalls, sessionSpend });
+  } catch {
+  }
+  let result;
+  try {
+    const [overview, insights] = await Promise.all([
+      apiRequest("GET", "/agents/overview").catch(() => null),
+      apiRequest("GET", "/agents/insights").catch(() => null)
+    ]);
+    result = JSON.stringify({
       session: {
         totalCalls: sessionCalls,
         totalSpend: `$${sessionSpend.toFixed(4)}`,
@@ -79,7 +298,7 @@ async function analytix402_spend_report() {
       insights
     }, null, 2);
   } catch (error) {
-    return JSON.stringify({
+    result = JSON.stringify({
       session: {
         totalCalls: sessionCalls,
         totalSpend: `$${sessionSpend.toFixed(4)}`,
@@ -89,6 +308,8 @@ async function analytix402_spend_report() {
       error: error instanceof Error ? error.message : String(error)
     }, null, 2);
   }
+  await shutdown();
+  return result;
 }
 function analytix402_set_budget(params) {
   const updates = [];
@@ -211,11 +432,25 @@ async function shutdown() {
     client = null;
   }
 }
+function register(ctx) {
+  if (API_KEY) {
+    try {
+      getClient();
+    } catch (err) {
+      console.warn("[Analytix402] Failed to connect on register:", err instanceof Error ? err.message : err);
+    }
+  }
+}
+function activate(ctx) {
+  return register(ctx);
+}
 export {
+  activate,
   analytix402_check_budget,
   analytix402_flag_purchase,
   analytix402_set_budget,
   analytix402_spend_report,
+  register,
   sendHeartbeat,
   shutdown,
   trackAPICall,

package/dist/setup.js

@@ -0,0 +1,105 @@
+#!/usr/bin/env node
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+// src/setup.ts
+var readline = __toESM(require("readline"));
+var fs = __toESM(require("fs"));
+var path = __toESM(require("path"));
+var rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+function ask(question, fallback = "") {
+  return new Promise((resolve2) => {
+    rl.question(question, (answer) => {
+      resolve2(answer.trim() || fallback);
+    });
+  });
+}
+async function validateKey(apiKey, baseUrl) {
+  try {
+    const res = await fetch(`${baseUrl}/api/agents/overview`, {
+      headers: { "X-API-Key": apiKey }
+    });
+    return res.ok;
+  } catch {
+    return false;
+  }
+}
+async function main() {
+  console.log("\n  Analytix402 \u2014 Setup\n");
+  const apiKey = await ask("  API key (ax_live_... or ax_test_...): ");
+  if (!apiKey) {
+    console.log("\n  No API key provided. Exiting.\n");
+    rl.close();
+    process.exit(1);
+  }
+  if (!apiKey.startsWith("ax_live_") && !apiKey.startsWith("ax_test_")) {
+    console.log("  Warning: key should start with ax_live_ or ax_test_\n");
+  }
+  const agentName = await ask("  Agent display name [OpenClaw Agent]: ", "OpenClaw Agent");
+  const dailyBudget = await ask("  Daily budget in USD (0 = unlimited) [0]: ", "0");
+  const baseUrl = await ask("  API endpoint [https://analytix402.com]: ", "https://analytix402.com");
+  rl.close();
+  console.log("\n  Validating API key...");
+  const valid = await validateKey(apiKey, baseUrl.replace(/\/$/, ""));
+  if (valid) {
+    console.log("  Connected successfully.\n");
+  } else {
+    console.log("  Could not reach the dashboard \u2014 the key may still be correct.");
+    console.log("  (The server might be starting up or unreachable right now.)\n");
+  }
+  const envPath = path.resolve(process.cwd(), ".env");
+  const lines = [];
+  if (fs.existsSync(envPath)) {
+    const existing = fs.readFileSync(envPath, "utf-8");
+    for (const line of existing.split("\n")) {
+      if (!line.startsWith("ANALYTIX402_")) {
+        lines.push(line);
+      }
+    }
+    while (lines.length > 0 && lines[lines.length - 1].trim() === "") {
+      lines.pop();
+    }
+    if (lines.length > 0) {
+      lines.push("");
+    }
+  }
+  lines.push(`ANALYTIX402_API_KEY=${apiKey}`);
+  if (agentName !== "OpenClaw Agent") {
+    lines.push(`ANALYTIX402_AGENT_NAME=${agentName}`);
+  }
+  if (dailyBudget !== "0") {
+    lines.push(`ANALYTIX402_DAILY_BUDGET=${dailyBudget}`);
+  }
+  if (baseUrl !== "https://analytix402.com") {
+    lines.push(`ANALYTIX402_BASE_URL=${baseUrl}`);
+  }
+  lines.push("");
+  fs.writeFileSync(envPath, lines.join("\n"), "utf-8");
+  console.log(`  Wrote config to ${envPath}`);
+  console.log("  You're all set. The skill will connect automatically on next start.\n");
+}
+main().catch((err) => {
+  console.error("Setup failed:", err);
+  process.exit(1);
+});

package/package.json

@@ -1,10 +1,13 @@
 {
   "name": "@analytix402/openclaw-skill",
-  "version": "0.1.6",
+  "version": "0.2.1",
   "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",
+  "bin": {
+    "openclaw-skill": "./dist/setup.js"
+  },
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -13,12 +16,18 @@
     }
   },
   "scripts": {
-    "build": "tsup src/index.ts --format cjs,esm --dts",
+    "build": "tsup src/index.ts --format cjs,esm --dts && tsup src/setup.ts --format cjs --no-dts --outDir dist",
+    "build:index": "tsup src/index.ts --format cjs,esm --dts",
+    "build:setup": "tsup src/setup.ts --format cjs --no-dts --outDir dist",
     "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
     "typecheck": "tsc --noEmit",
-    "prepublishOnly": "npm run build"
+    "postinstall": "echo \"\n  Run 'npx @analytix402/openclaw-skill init' to configure your API key.\n\"",
+    "prepublishOnly": "npm run build:index && npm run build:setup"
   },
   "openclaw": {
+    "extensions": [
+      "dist/index.js"
+    ],
     "tools": {
       "analytix402_spend_report": {
         "description": "Get a summary of your agent's spend — total cost, breakdown by API and LLM provider, and efficiency score.",