@analytix402/openclaw-skill 0.1.1 → 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

@@ -54,11 +54,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/dist/index.mjs

@@ -23,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,6 +1,6 @@
 {
   "name": "@analytix402/openclaw-skill",
-  "version": "0.1.1",
+  "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",
@@ -72,6 +72,11 @@
       "shutdown"
     ]
   },
+  "files": [
+    "dist",
+    "SKILL.md",
+    "README.md"
+  ],
   "keywords": [
     "openclaw",
     "openclaw-skill",
@@ -86,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/Skill/SKILL.md

@@ -1,47 +0,0 @@
-# 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/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 '@analytix402/sdk';
-import type { Analytix402Client } from '@analytix402/sdk';
-
-// ============================================================
-// 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;
-  }
-}

package/tsconfig.json

@@ -1,21 +0,0 @@
-{
-  "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"]
-}