@analytix402/openclaw-skill 0.1.0 → 0.1.1

package/Skill/SKILL.md

@@ -0,0 +1,47 @@
+# Analytix402
+
+Monitor, control, and optimize your AI agent's API spend and LLM costs in real-time.
+
+## Description
+
+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 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
+
+## Configuration
+
+```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
+```
+
+## 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.
+
+## 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,7 +50,7 @@ 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,

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()}`;

package/package.json

@@ -1,16 +1,80 @@
 {
   "name": "@analytix402/openclaw-skill",
-  "version": "0.1.0",
+  "version": "0.1.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",
+  "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"
+    ]
   },
   "keywords": [
     "openclaw",
+    "openclaw-skill",
     "analytix402",
     "x402",
     "ai-agent",

package/src/index.ts

@@ -8,8 +8,8 @@
  * real-time visibility into what their agents are spending.
  */
 
-import { createClient } from '../../sdk/src/client';
-import type { Analytix402Client } from '../../sdk/src/types';
+import { createClient } from '@analytix402/sdk';
+import type { Analytix402Client } from '@analytix402/sdk';
 
 // ============================================================
 // Configuration

package/tsconfig.json

@@ -0,0 +1,21 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "NodeNext",
+    "moduleResolution": "nodenext",
+    "lib": ["ES2020", "DOM"],
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}