@blockrun/clawrouter 0.12.95 → 0.12.96

package/dist/spend-control.js

@@ -0,0 +1,278 @@
+/**
+ * Spend Control - Time-windowed spending limits
+ *
+ * Absorbed from @blockrun/clawwallet. Chain-agnostic (works for both EVM and Solana).
+ *
+ * Features:
+ * - Per-request limits (e.g., max $0.10 per call)
+ * - Hourly limits (e.g., max $3.00 per hour)
+ * - Daily limits (e.g., max $20.00 per day)
+ * - Session limits (e.g., max $5.00 per session)
+ * - Rolling windows (last 1h, last 24h)
+ * - Persistent storage (~/.openclaw/blockrun/spending.json)
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { homedir } from "node:os";
+import { readTextFileSync } from "./fs-read.js";
+const WALLET_DIR = path.join(homedir(), ".openclaw", "blockrun");
+const HOUR_MS = 60 * 60 * 1000;
+const DAY_MS = 24 * HOUR_MS;
+export class FileSpendControlStorage {
+    spendingFile;
+    constructor() {
+        this.spendingFile = path.join(WALLET_DIR, "spending.json");
+    }
+    load() {
+        try {
+            if (fs.existsSync(this.spendingFile)) {
+                const data = JSON.parse(readTextFileSync(this.spendingFile));
+                const rawLimits = data.limits ?? {};
+                const rawHistory = data.history ?? [];
+                const limits = {};
+                for (const key of ["perRequest", "hourly", "daily", "session"]) {
+                    const val = rawLimits[key];
+                    if (typeof val === "number" && val > 0 && Number.isFinite(val)) {
+                        limits[key] = val;
+                    }
+                }
+                const history = [];
+                if (Array.isArray(rawHistory)) {
+                    for (const r of rawHistory) {
+                        if (typeof r?.timestamp === "number" &&
+                            typeof r?.amount === "number" &&
+                            Number.isFinite(r.timestamp) &&
+                            Number.isFinite(r.amount) &&
+                            r.amount >= 0) {
+                            history.push({
+                                timestamp: r.timestamp,
+                                amount: r.amount,
+                                model: typeof r.model === "string" ? r.model : undefined,
+                                action: typeof r.action === "string" ? r.action : undefined,
+                            });
+                        }
+                    }
+                }
+                return { limits, history };
+            }
+        }
+        catch (err) {
+            console.error(`[ClawRouter] Failed to load spending data, starting fresh: ${err}`);
+        }
+        return null;
+    }
+    save(data) {
+        try {
+            if (!fs.existsSync(WALLET_DIR)) {
+                fs.mkdirSync(WALLET_DIR, { recursive: true, mode: 0o700 });
+            }
+            fs.writeFileSync(this.spendingFile, JSON.stringify(data, null, 2), {
+                mode: 0o600,
+            });
+        }
+        catch (err) {
+            console.error(`[ClawRouter] Failed to save spending data: ${err}`);
+        }
+    }
+}
+export class InMemorySpendControlStorage {
+    data = null;
+    load() {
+        return this.data
+            ? {
+                limits: { ...this.data.limits },
+                history: this.data.history.map((r) => ({ ...r })),
+            }
+            : null;
+    }
+    save(data) {
+        this.data = {
+            limits: { ...data.limits },
+            history: data.history.map((r) => ({ ...r })),
+        };
+    }
+}
+export class SpendControl {
+    limits = {};
+    history = [];
+    sessionSpent = 0;
+    sessionCalls = 0;
+    storage;
+    now;
+    constructor(options) {
+        this.storage = options?.storage ?? new FileSpendControlStorage();
+        this.now = options?.now ?? (() => Date.now());
+        this.load();
+    }
+    setLimit(window, amount) {
+        if (!Number.isFinite(amount) || amount <= 0) {
+            throw new Error("Limit must be a finite positive number");
+        }
+        this.limits[window] = amount;
+        this.save();
+    }
+    clearLimit(window) {
+        delete this.limits[window];
+        this.save();
+    }
+    getLimits() {
+        return { ...this.limits };
+    }
+    check(estimatedCost) {
+        const now = this.now();
+        if (this.limits.perRequest !== undefined) {
+            if (estimatedCost > this.limits.perRequest) {
+                return {
+                    allowed: false,
+                    blockedBy: "perRequest",
+                    remaining: this.limits.perRequest,
+                    reason: `Per-request limit exceeded: $${estimatedCost.toFixed(4)} > $${this.limits.perRequest.toFixed(2)} max`,
+                };
+            }
+        }
+        if (this.limits.hourly !== undefined) {
+            const hourlySpent = this.getSpendingInWindow(now - HOUR_MS, now);
+            const remaining = this.limits.hourly - hourlySpent;
+            if (estimatedCost > remaining) {
+                const oldestInWindow = this.history.find((r) => r.timestamp >= now - HOUR_MS);
+                const resetIn = oldestInWindow
+                    ? Math.ceil((oldestInWindow.timestamp + HOUR_MS - now) / 1000)
+                    : 0;
+                return {
+                    allowed: false,
+                    blockedBy: "hourly",
+                    remaining,
+                    reason: `Hourly limit exceeded: $${(hourlySpent + estimatedCost).toFixed(2)} > $${this.limits.hourly.toFixed(2)} max`,
+                    resetIn,
+                };
+            }
+        }
+        if (this.limits.daily !== undefined) {
+            const dailySpent = this.getSpendingInWindow(now - DAY_MS, now);
+            const remaining = this.limits.daily - dailySpent;
+            if (estimatedCost > remaining) {
+                const oldestInWindow = this.history.find((r) => r.timestamp >= now - DAY_MS);
+                const resetIn = oldestInWindow
+                    ? Math.ceil((oldestInWindow.timestamp + DAY_MS - now) / 1000)
+                    : 0;
+                return {
+                    allowed: false,
+                    blockedBy: "daily",
+                    remaining,
+                    reason: `Daily limit exceeded: $${(dailySpent + estimatedCost).toFixed(2)} > $${this.limits.daily.toFixed(2)} max`,
+                    resetIn,
+                };
+            }
+        }
+        if (this.limits.session !== undefined) {
+            const remaining = this.limits.session - this.sessionSpent;
+            if (estimatedCost > remaining) {
+                return {
+                    allowed: false,
+                    blockedBy: "session",
+                    remaining,
+                    reason: `Session limit exceeded: $${(this.sessionSpent + estimatedCost).toFixed(2)} > $${this.limits.session.toFixed(2)} max`,
+                };
+            }
+        }
+        return { allowed: true };
+    }
+    record(amount, metadata) {
+        if (!Number.isFinite(amount) || amount < 0) {
+            throw new Error("Record amount must be a non-negative finite number");
+        }
+        const record = {
+            timestamp: this.now(),
+            amount,
+            model: metadata?.model,
+            action: metadata?.action,
+        };
+        this.history.push(record);
+        this.sessionSpent += amount;
+        this.sessionCalls += 1;
+        this.cleanup();
+        this.save();
+    }
+    getSpendingInWindow(from, to) {
+        return this.history
+            .filter((r) => r.timestamp >= from && r.timestamp <= to)
+            .reduce((sum, r) => sum + r.amount, 0);
+    }
+    getSpending(window) {
+        const now = this.now();
+        switch (window) {
+            case "hourly":
+                return this.getSpendingInWindow(now - HOUR_MS, now);
+            case "daily":
+                return this.getSpendingInWindow(now - DAY_MS, now);
+            case "session":
+                return this.sessionSpent;
+        }
+    }
+    getRemaining(window) {
+        const limit = this.limits[window];
+        if (limit === undefined)
+            return null;
+        return Math.max(0, limit - this.getSpending(window));
+    }
+    getStatus() {
+        const now = this.now();
+        const hourlySpent = this.getSpendingInWindow(now - HOUR_MS, now);
+        const dailySpent = this.getSpendingInWindow(now - DAY_MS, now);
+        return {
+            limits: { ...this.limits },
+            spending: {
+                hourly: hourlySpent,
+                daily: dailySpent,
+                session: this.sessionSpent,
+            },
+            remaining: {
+                hourly: this.limits.hourly !== undefined ? this.limits.hourly - hourlySpent : null,
+                daily: this.limits.daily !== undefined ? this.limits.daily - dailySpent : null,
+                session: this.limits.session !== undefined ? this.limits.session - this.sessionSpent : null,
+            },
+            calls: this.sessionCalls,
+        };
+    }
+    getHistory(limit) {
+        const records = [...this.history].reverse();
+        return limit ? records.slice(0, limit) : records;
+    }
+    resetSession() {
+        this.sessionSpent = 0;
+        this.sessionCalls = 0;
+    }
+    cleanup() {
+        const cutoff = this.now() - DAY_MS;
+        this.history = this.history.filter((r) => r.timestamp >= cutoff);
+    }
+    save() {
+        this.storage.save({
+            limits: { ...this.limits },
+            history: [...this.history],
+        });
+    }
+    load() {
+        const data = this.storage.load();
+        if (data) {
+            this.limits = data.limits;
+            this.history = data.history;
+            this.cleanup();
+        }
+    }
+}
+export function formatDuration(seconds) {
+    if (seconds < 60) {
+        return `${seconds}s`;
+    }
+    else if (seconds < 3600) {
+        const mins = Math.ceil(seconds / 60);
+        return `${mins} min`;
+    }
+    else {
+        const hours = Math.floor(seconds / 3600);
+        const mins = Math.ceil((seconds % 3600) / 60);
+        return mins > 0 ? `${hours}h ${mins}m` : `${hours}h`;
+    }
+}
+//# sourceMappingURL=spend-control.js.map

package/dist/spend-control.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spend-control.js","sourceRoot":"","sources":["../src/spend-control.ts"],"names":[],"mappings":"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"}

package/dist/spend-control.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * SpendControl tests — limits, recording, window expiry, persistence.
+ */
+export {};
+//# sourceMappingURL=spend-control.test.d.ts.map

package/dist/spend-control.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spend-control.test.d.ts","sourceRoot":"","sources":["../src/spend-control.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/spend-control.test.js

@@ -0,0 +1,210 @@
+/**
+ * SpendControl tests — limits, recording, window expiry, persistence.
+ */
+import { describe, it, expect } from "vitest";
+import { SpendControl, InMemorySpendControlStorage, formatDuration } from "./spend-control.js";
+function createControl(nowMs = Date.now()) {
+    let clock = nowMs;
+    const storage = new InMemorySpendControlStorage();
+    const control = new SpendControl({ storage, now: () => clock });
+    const advance = (ms) => {
+        clock += ms;
+    };
+    return { control, storage, advance };
+}
+describe("SpendControl", () => {
+    describe("per-request limit", () => {
+        it("allows requests under the limit", () => {
+            const { control } = createControl();
+            control.setLimit("perRequest", 0.1);
+            expect(control.check(0.05).allowed).toBe(true);
+        });
+        it("blocks requests over the limit", () => {
+            const { control } = createControl();
+            control.setLimit("perRequest", 0.1);
+            const result = control.check(0.15);
+            expect(result.allowed).toBe(false);
+            expect(result.blockedBy).toBe("perRequest");
+        });
+        it("blocks requests exactly at the limit boundary", () => {
+            const { control } = createControl();
+            control.setLimit("perRequest", 0.1);
+            // Exactly equal should pass
+            expect(control.check(0.1).allowed).toBe(true);
+            // Just over should fail
+            expect(control.check(0.100001).allowed).toBe(false);
+        });
+    });
+    describe("hourly limit", () => {
+        it("accumulates spending within the hour", () => {
+            const { control } = createControl();
+            control.setLimit("hourly", 1.0);
+            control.record(0.4);
+            control.record(0.4);
+            expect(control.check(0.25).allowed).toBe(false);
+            expect(control.check(0.15).allowed).toBe(true);
+        });
+        it("resets after the hour window passes", () => {
+            const { control, advance } = createControl();
+            control.setLimit("hourly", 1.0);
+            control.record(0.9);
+            expect(control.check(0.2).allowed).toBe(false);
+            // Advance past the 1-hour window
+            advance(61 * 60 * 1000);
+            expect(control.check(0.2).allowed).toBe(true);
+        });
+        it("provides resetIn seconds", () => {
+            const { control } = createControl();
+            control.setLimit("hourly", 0.5);
+            control.record(0.5);
+            const result = control.check(0.01);
+            expect(result.allowed).toBe(false);
+            expect(result.resetIn).toBeGreaterThan(0);
+            expect(result.resetIn).toBeLessThanOrEqual(3600);
+        });
+    });
+    describe("daily limit", () => {
+        it("accumulates across hours within the day", () => {
+            const { control, advance } = createControl();
+            control.setLimit("daily", 5.0);
+            control.record(2.0);
+            advance(2 * 60 * 60 * 1000); // 2 hours later
+            control.record(2.0);
+            expect(control.check(1.5).allowed).toBe(false);
+            expect(control.check(0.9).allowed).toBe(true);
+        });
+        it("resets after the day window passes", () => {
+            const { control, advance } = createControl();
+            control.setLimit("daily", 5.0);
+            control.record(4.9);
+            expect(control.check(0.2).allowed).toBe(false);
+            advance(25 * 60 * 60 * 1000); // 25 hours
+            expect(control.check(0.2).allowed).toBe(true);
+        });
+    });
+    describe("session limit", () => {
+        it("tracks spending within the session", () => {
+            const { control } = createControl();
+            control.setLimit("session", 2.0);
+            control.record(1.5);
+            expect(control.check(0.6).allowed).toBe(false);
+            expect(control.check(0.4).allowed).toBe(true);
+        });
+        it("resetSession clears session spending", () => {
+            const { control } = createControl();
+            control.setLimit("session", 2.0);
+            control.record(1.9);
+            expect(control.check(0.2).allowed).toBe(false);
+            control.resetSession();
+            expect(control.check(0.2).allowed).toBe(true);
+        });
+    });
+    describe("multiple limits", () => {
+        it("checks all limits and reports the first violation", () => {
+            const { control } = createControl();
+            control.setLimit("perRequest", 0.5);
+            control.setLimit("hourly", 2.0);
+            // Over per-request limit
+            const result = control.check(0.6);
+            expect(result.allowed).toBe(false);
+            expect(result.blockedBy).toBe("perRequest");
+        });
+        it("checks hourly after per-request passes", () => {
+            const { control } = createControl();
+            control.setLimit("perRequest", 1.0);
+            control.setLimit("hourly", 2.0);
+            control.record(1.8);
+            const result = control.check(0.3);
+            expect(result.allowed).toBe(false);
+            expect(result.blockedBy).toBe("hourly");
+        });
+    });
+    describe("getStatus", () => {
+        it("returns current spending and remaining amounts", () => {
+            const { control } = createControl();
+            control.setLimit("hourly", 3.0);
+            control.setLimit("daily", 10.0);
+            control.record(1.0);
+            control.record(0.5);
+            const status = control.getStatus();
+            expect(status.spending.hourly).toBeCloseTo(1.5);
+            expect(status.spending.session).toBeCloseTo(1.5);
+            expect(status.remaining.hourly).toBeCloseTo(1.5);
+            expect(status.remaining.daily).toBeCloseTo(8.5);
+            expect(status.calls).toBe(2);
+        });
+    });
+    describe("getHistory", () => {
+        it("returns records in reverse chronological order", () => {
+            const { control, advance } = createControl();
+            control.record(0.1, { model: "first" });
+            advance(1000);
+            control.record(0.2, { model: "second" });
+            const history = control.getHistory();
+            expect(history).toHaveLength(2);
+            expect(history[0].model).toBe("second");
+            expect(history[1].model).toBe("first");
+        });
+        it("respects limit parameter", () => {
+            const { control, advance } = createControl();
+            control.record(0.1);
+            advance(100);
+            control.record(0.2);
+            advance(100);
+            control.record(0.3);
+            expect(control.getHistory(2)).toHaveLength(2);
+        });
+    });
+    describe("clearLimit", () => {
+        it("removes a specific limit", () => {
+            const { control } = createControl();
+            control.setLimit("perRequest", 0.01);
+            expect(control.check(0.05).allowed).toBe(false);
+            control.clearLimit("perRequest");
+            expect(control.check(0.05).allowed).toBe(true);
+        });
+    });
+    describe("persistence", () => {
+        it("persists limits and history across instances via shared storage", () => {
+            const storage = new InMemorySpendControlStorage();
+            const clock = Date.now();
+            const c1 = new SpendControl({ storage, now: () => clock });
+            c1.setLimit("hourly", 5.0);
+            c1.record(2.0);
+            // New instance, same storage
+            const c2 = new SpendControl({ storage, now: () => clock });
+            expect(c2.getLimits().hourly).toBe(5.0);
+            expect(c2.getSpending("hourly")).toBeCloseTo(2.0);
+        });
+    });
+    describe("validation", () => {
+        it("rejects non-positive limits", () => {
+            const { control } = createControl();
+            expect(() => control.setLimit("hourly", 0)).toThrow();
+            expect(() => control.setLimit("hourly", -1)).toThrow();
+        });
+        it("rejects negative record amounts", () => {
+            const { control } = createControl();
+            expect(() => control.record(-0.5)).toThrow();
+        });
+        it("rejects non-finite values", () => {
+            const { control } = createControl();
+            expect(() => control.setLimit("hourly", Infinity)).toThrow();
+            expect(() => control.setLimit("hourly", NaN)).toThrow();
+        });
+    });
+});
+describe("formatDuration", () => {
+    it("formats seconds", () => {
+        expect(formatDuration(30)).toBe("30s");
+    });
+    it("formats minutes", () => {
+        expect(formatDuration(120)).toBe("2 min");
+        expect(formatDuration(90)).toBe("2 min");
+    });
+    it("formats hours and minutes", () => {
+        expect(formatDuration(3660)).toBe("1h 1m");
+        expect(formatDuration(7200)).toBe("2h");
+    });
+});
+//# sourceMappingURL=spend-control.test.js.map

package/dist/spend-control.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spend-control.test.js","sourceRoot":"","sources":["../src/spend-control.test.ts"],"names":[],"mappings":"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"}

package/dist/stats.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Usage Statistics Aggregator
+ *
+ * Reads usage log files and aggregates statistics for terminal display.
+ * Supports filtering by date range and provides multiple aggregation views.
+ */
+export type DailyStats = {
+    date: string;
+    totalRequests: number;
+    totalCost: number;
+    totalBaselineCost: number;
+    totalSavings: number;
+    avgLatencyMs: number;
+    byTier: Record<string, {
+        count: number;
+        cost: number;
+    }>;
+    byModel: Record<string, {
+        count: number;
+        cost: number;
+    }>;
+};
+export type AggregatedStats = {
+    period: string;
+    totalRequests: number;
+    totalCost: number;
+    totalBaselineCost: number;
+    totalSavings: number;
+    savingsPercentage: number;
+    avgLatencyMs: number;
+    avgCostPerRequest: number;
+    byTier: Record<string, {
+        count: number;
+        cost: number;
+        percentage: number;
+    }>;
+    byModel: Record<string, {
+        count: number;
+        cost: number;
+        percentage: number;
+    }>;
+    dailyBreakdown: DailyStats[];
+    entriesWithBaseline: number;
+};
+/**
+ * Get aggregated statistics for the last N days.
+ */
+export declare function getStats(days?: number): Promise<AggregatedStats>;
+/**
+ * Format stats as ASCII table for terminal display.
+ */
+export declare function formatStatsAscii(stats: AggregatedStats): string;
+/**
+ * Format per-request log entries as an ASCII table for terminal display.
+ * Reads the last N days of log files and shows each request individually.
+ */
+export declare function formatRecentLogs(days?: number): Promise<string>;
+/**
+ * Delete all usage log files, resetting stats to zero.
+ */
+export declare function clearStats(): Promise<{
+    deletedFiles: number;
+}>;
+//# sourceMappingURL=stats.d.ts.map

package/dist/stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../src/stats.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC1D,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5E,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7E,cAAc,EAAE,UAAU,EAAE,CAAC;IAC7B,mBAAmB,EAAE,MAAM,CAAC;CAC7B,CAAC;AAqFF;;GAEG;AACH,wBAAsB,QAAQ,CAAC,IAAI,GAAE,MAAU,GAAG,OAAO,CAAC,eAAe,CAAC,CAsFzE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CA4E/D;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,GAAE,MAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAsDxE;AAED;;GAEG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC;IAAE,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC,CAWpE"}