@blockrun/clawrouter 0.12.94 → 0.12.96

package/dist/session.test.js

@@ -0,0 +1,163 @@
+import { describe, expect, it } from "vitest";
+import { deriveSessionId, DEFAULT_SESSION_CONFIG, SessionStore, hashRequestContent, } from "./session.js";
+describe("deriveSessionId", () => {
+    it("returns same ID for same first user message", () => {
+        const messages = [{ role: "user", content: "hello world" }];
+        const id1 = deriveSessionId(messages);
+        const id2 = deriveSessionId(messages);
+        expect(id1).toBe(id2);
+    });
+    it("returns different IDs for different first user messages", () => {
+        const a = deriveSessionId([{ role: "user", content: "first conversation" }]);
+        const b = deriveSessionId([{ role: "user", content: "second conversation" }]);
+        expect(a).not.toBe(b);
+    });
+    it("is stable regardless of subsequent messages", () => {
+        const firstMsg = { role: "user", content: "what is the capital of France?" };
+        const id1 = deriveSessionId([firstMsg]);
+        const id2 = deriveSessionId([
+            firstMsg,
+            { role: "assistant", content: "Paris" },
+            { role: "user", content: "and Germany?" },
+        ]);
+        expect(id1).toBe(id2);
+    });
+    it("skips system messages and uses first user message", () => {
+        const withSystem = [
+            { role: "system", content: "you are a helpful assistant" },
+            { role: "user", content: "my question" },
+        ];
+        const withoutSystem = [{ role: "user", content: "my question" }];
+        expect(deriveSessionId(withSystem)).toBe(deriveSessionId(withoutSystem));
+    });
+    it("returns undefined when no user messages exist", () => {
+        expect(deriveSessionId([])).toBeUndefined();
+        expect(deriveSessionId([{ role: "system", content: "only system" }])).toBeUndefined();
+    });
+    it("returns a short hex string (8 chars)", () => {
+        const id = deriveSessionId([{ role: "user", content: "test" }]);
+        expect(id).toMatch(/^[0-9a-f]{8}$/);
+    });
+});
+describe("DEFAULT_SESSION_CONFIG", () => {
+    it("has session persistence enabled by default", () => {
+        expect(DEFAULT_SESSION_CONFIG.enabled).toBe(true);
+    });
+});
+describe("SessionStore.setSession", () => {
+    it("updates pinned model when fallback model differs from routing decision", () => {
+        const store = new SessionStore();
+        const sessionId = "abc12345";
+        // First call: routing decision pins kimi-k2.5
+        store.setSession(sessionId, "moonshot/kimi-k2.5", "MEDIUM");
+        expect(store.getSession(sessionId)?.model).toBe("moonshot/kimi-k2.5");
+        // Second call: actual model used was fallback (gemini-flash)
+        store.setSession(sessionId, "google/gemini-2.5-flash-lite", "MEDIUM");
+        expect(store.getSession(sessionId)?.model).toBe("google/gemini-2.5-flash-lite");
+    });
+    it("subsequent requests use the fallback model when pinned", () => {
+        const store = new SessionStore();
+        const sessionId = "abc12345";
+        store.setSession(sessionId, "moonshot/kimi-k2.5", "MEDIUM");
+        store.setSession(sessionId, "google/gemini-2.5-flash-lite", "MEDIUM");
+        // Next request reads pinned model — should get the fallback, not the primary
+        const pinned = store.getSession(sessionId);
+        expect(pinned?.model).toBe("google/gemini-2.5-flash-lite");
+        expect(pinned?.requestCount).toBe(2);
+    });
+    it("initializes three-strike fields on new session", () => {
+        const store = new SessionStore();
+        store.setSession("s1", "model-a", "SIMPLE");
+        const entry = store.getSession("s1");
+        expect(entry?.recentHashes).toEqual([]);
+        expect(entry?.strikes).toBe(0);
+        expect(entry?.escalated).toBe(false);
+    });
+});
+describe("SessionStore.recordRequestHash", () => {
+    it("triggers escalation after 3 consecutive identical hashes", () => {
+        const store = new SessionStore();
+        store.setSession("s1", "moonshot/kimi-k2.5", "MEDIUM");
+        expect(store.recordRequestHash("s1", "aaa")).toBe(false); // 1st — no prior
+        expect(store.recordRequestHash("s1", "aaa")).toBe(false); // 2nd — strikes=1
+        expect(store.recordRequestHash("s1", "aaa")).toBe(true); // 3rd — strikes=2, trigger!
+    });
+    it("resets strikes when a different hash is inserted", () => {
+        const store = new SessionStore();
+        store.setSession("s1", "moonshot/kimi-k2.5", "MEDIUM");
+        store.recordRequestHash("s1", "aaa");
+        store.recordRequestHash("s1", "aaa"); // strikes=1
+        store.recordRequestHash("s1", "bbb"); // different → strikes=0
+        expect(store.recordRequestHash("s1", "bbb")).toBe(false); // strikes=1, not 2 yet
+    });
+    it("returns false for unknown session", () => {
+        const store = new SessionStore();
+        expect(store.recordRequestHash("nonexistent", "aaa")).toBe(false);
+    });
+});
+describe("SessionStore.escalateSession", () => {
+    const tierConfigs = {
+        SIMPLE: { primary: "cheap-model", fallback: [] },
+        MEDIUM: { primary: "moonshot/kimi-k2.5", fallback: ["google/gemini-2.5-flash-lite"] },
+        COMPLEX: { primary: "anthropic/claude-sonnet-4", fallback: ["openai/gpt-4o"] },
+        REASONING: { primary: "anthropic/claude-opus-4", fallback: [] },
+    };
+    it("escalates from MEDIUM to COMPLEX", () => {
+        const store = new SessionStore();
+        store.setSession("s1", "moonshot/kimi-k2.5", "MEDIUM");
+        const result = store.escalateSession("s1", tierConfigs);
+        expect(result).toEqual({ model: "anthropic/claude-sonnet-4", tier: "COMPLEX" });
+        const entry = store.getSession("s1");
+        expect(entry?.model).toBe("anthropic/claude-sonnet-4");
+        expect(entry?.tier).toBe("COMPLEX");
+        expect(entry?.escalated).toBe(true);
+        expect(entry?.strikes).toBe(0);
+    });
+    it("returns null when already at REASONING (max tier)", () => {
+        const store = new SessionStore();
+        store.setSession("s1", "anthropic/claude-opus-4", "REASONING");
+        const result = store.escalateSession("s1", tierConfigs);
+        expect(result).toBeNull();
+    });
+    it("does not re-trigger after escalation (escalated flag)", () => {
+        const store = new SessionStore();
+        store.setSession("s1", "moonshot/kimi-k2.5", "MEDIUM");
+        // Trigger escalation
+        store.recordRequestHash("s1", "aaa");
+        store.recordRequestHash("s1", "aaa");
+        const shouldEscalate = store.recordRequestHash("s1", "aaa");
+        expect(shouldEscalate).toBe(true);
+        store.escalateSession("s1", tierConfigs);
+        // Now even with more repeated hashes, should NOT trigger again
+        store.recordRequestHash("s1", "bbb");
+        store.recordRequestHash("s1", "bbb");
+        expect(store.recordRequestHash("s1", "bbb")).toBe(false); // escalated=true blocks it
+    });
+});
+describe("hashRequestContent", () => {
+    it("produces same hash for identical content", () => {
+        const h1 = hashRequestContent("hello world");
+        const h2 = hashRequestContent("hello world");
+        expect(h1).toBe(h2);
+    });
+    it("produces different hash for different content", () => {
+        const h1 = hashRequestContent("hello world");
+        const h2 = hashRequestContent("goodbye world");
+        expect(h1).not.toBe(h2);
+    });
+    it("normalizes whitespace differences", () => {
+        const h1 = hashRequestContent("hello   world\n\tfoo");
+        const h2 = hashRequestContent("hello world foo");
+        expect(h1).toBe(h2);
+    });
+    it("includes tool call names in hash", () => {
+        const h1 = hashRequestContent("hello", ["read_file", "write_file"]);
+        const h2 = hashRequestContent("hello");
+        expect(h1).not.toBe(h2);
+    });
+    it("returns a 12-char hex string", () => {
+        const h = hashRequestContent("test content");
+        expect(h).toMatch(/^[0-9a-f]{12}$/);
+    });
+});
+//# sourceMappingURL=session.test.js.map

package/dist/session.test.js.map

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

package/dist/solana-balance.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Solana USDC Balance Monitor
+ *
+ * Checks USDC balance on Solana mainnet with caching.
+ * Absorbed from @blockrun/clawwallet's solana-adapter.ts (balance portion only).
+ */
+export type SolanaBalanceInfo = {
+    balance: bigint;
+    balanceUSD: string;
+    isLow: boolean;
+    isEmpty: boolean;
+    walletAddress: string;
+};
+/** Result from checkSufficient() */
+export type SolanaSufficiencyResult = {
+    sufficient: boolean;
+    info: SolanaBalanceInfo;
+    shortfall?: string;
+};
+export declare class SolanaBalanceMonitor {
+    private readonly rpc;
+    private readonly walletAddress;
+    private cachedBalance;
+    private cachedAt;
+    constructor(walletAddress: string, rpcUrl?: string);
+    checkBalance(): Promise<SolanaBalanceInfo>;
+    deductEstimated(amountMicros: bigint): void;
+    invalidate(): void;
+    refresh(): Promise<SolanaBalanceInfo>;
+    /**
+     * Check if balance is sufficient for an estimated cost.
+     */
+    checkSufficient(estimatedCostMicros: bigint): Promise<SolanaSufficiencyResult>;
+    /**
+     * Format USDC amount (in micros) as "$X.XX".
+     */
+    formatUSDC(amountMicros: bigint): string;
+    getWalletAddress(): string;
+    /**
+     * Check native SOL balance (in lamports). Useful for detecting users who
+     * funded with SOL instead of USDC.
+     */
+    checkSolBalance(): Promise<bigint>;
+    private fetchBalance;
+    private fetchBalanceOnce;
+    private buildInfo;
+}
+//# sourceMappingURL=solana-balance.d.ts.map

package/dist/solana-balance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"solana-balance.d.ts","sourceRoot":"","sources":["../src/solana-balance.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,oCAAoC;AACpC,MAAM,MAAM,uBAAuB,GAAG;IACpC,UAAU,EAAE,OAAO,CAAC;IACpB,IAAI,EAAE,iBAAiB,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAqC;IACzD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,QAAQ,CAAK;gBAET,aAAa,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;IAM5C,YAAY,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAmBhD,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAM3C,UAAU,IAAI,IAAI;IAKZ,OAAO,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAK3C;;OAEG;IACG,eAAe,CAAC,mBAAmB,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAapF;;OAEG;IACH,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAKxC,gBAAgB,IAAI,MAAM;IAI1B;;;OAGG;IACG,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC;YAc1B,YAAY;YAcZ,gBAAgB;IAgC9B,OAAO,CAAC,SAAS;CAUlB"}

package/dist/solana-balance.js

@@ -0,0 +1,142 @@
+/**
+ * Solana USDC Balance Monitor
+ *
+ * Checks USDC balance on Solana mainnet with caching.
+ * Absorbed from @blockrun/clawwallet's solana-adapter.ts (balance portion only).
+ */
+import { address as solAddress, createSolanaRpc } from "@solana/kit";
+const SOLANA_USDC_MINT = "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v";
+const SOLANA_DEFAULT_RPC = "https://api.mainnet-beta.solana.com";
+const BALANCE_TIMEOUT_MS = 10_000;
+const CACHE_TTL_MS = 30_000;
+export class SolanaBalanceMonitor {
+    rpc;
+    walletAddress;
+    cachedBalance = null;
+    cachedAt = 0;
+    constructor(walletAddress, rpcUrl) {
+        this.walletAddress = walletAddress;
+        const url = rpcUrl || process["env"].CLAWROUTER_SOLANA_RPC_URL || SOLANA_DEFAULT_RPC;
+        this.rpc = createSolanaRpc(url);
+    }
+    async checkBalance() {
+        const now = Date.now();
+        if (this.cachedBalance !== null &&
+            this.cachedBalance > 0n &&
+            now - this.cachedAt < CACHE_TTL_MS) {
+            return this.buildInfo(this.cachedBalance);
+        }
+        // Zero balance is never cached — always re-fetch so a funded wallet is
+        // detected on the next request without waiting for cache expiry.
+        const balance = await this.fetchBalance();
+        if (balance > 0n) {
+            this.cachedBalance = balance;
+            this.cachedAt = now;
+        }
+        return this.buildInfo(balance);
+    }
+    deductEstimated(amountMicros) {
+        if (this.cachedBalance !== null && this.cachedBalance >= amountMicros) {
+            this.cachedBalance -= amountMicros;
+        }
+    }
+    invalidate() {
+        this.cachedBalance = null;
+        this.cachedAt = 0;
+    }
+    async refresh() {
+        this.invalidate();
+        return this.checkBalance();
+    }
+    /**
+     * Check if balance is sufficient for an estimated cost.
+     */
+    async checkSufficient(estimatedCostMicros) {
+        const info = await this.checkBalance();
+        if (info.balance >= estimatedCostMicros) {
+            return { sufficient: true, info };
+        }
+        const shortfall = estimatedCostMicros - info.balance;
+        return {
+            sufficient: false,
+            info,
+            shortfall: this.formatUSDC(shortfall),
+        };
+    }
+    /**
+     * Format USDC amount (in micros) as "$X.XX".
+     */
+    formatUSDC(amountMicros) {
+        const dollars = Number(amountMicros) / 1_000_000;
+        return `$${dollars.toFixed(2)}`;
+    }
+    getWalletAddress() {
+        return this.walletAddress;
+    }
+    /**
+     * Check native SOL balance (in lamports). Useful for detecting users who
+     * funded with SOL instead of USDC.
+     */
+    async checkSolBalance() {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), BALANCE_TIMEOUT_MS);
+        try {
+            const owner = solAddress(this.walletAddress);
+            const response = await this.rpc.getBalance(owner).send({ abortSignal: controller.signal });
+            return BigInt(response.value);
+        }
+        catch {
+            return 0n;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    async fetchBalance() {
+        const owner = solAddress(this.walletAddress);
+        const mint = solAddress(SOLANA_USDC_MINT);
+        // The public Solana RPC frequently returns empty token account lists even
+        // for funded wallets. Retry once on empty before accepting $0 as truth.
+        for (let attempt = 0; attempt < 2; attempt++) {
+            const result = await this.fetchBalanceOnce(owner, mint);
+            if (result > 0n || attempt === 1)
+                return result;
+            await new Promise((r) => setTimeout(r, 1_000));
+        }
+        return 0n;
+    }
+    async fetchBalanceOnce(owner, mint) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), BALANCE_TIMEOUT_MS);
+        try {
+            const response = await this.rpc
+                .getTokenAccountsByOwner(owner, { mint }, { encoding: "jsonParsed" })
+                .send({ abortSignal: controller.signal });
+            if (response.value.length === 0)
+                return 0n;
+            let total = 0n;
+            for (const account of response.value) {
+                const parsed = account.account.data;
+                total += BigInt(parsed.parsed.info.tokenAmount.amount);
+            }
+            return total;
+        }
+        catch (err) {
+            throw new Error(`Failed to fetch Solana USDC balance: ${err instanceof Error ? err.message : String(err)}`, { cause: err });
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    buildInfo(balance) {
+        const dollars = Number(balance) / 1_000_000;
+        return {
+            balance,
+            balanceUSD: `$${dollars.toFixed(2)}`,
+            isLow: balance < 1000000n,
+            isEmpty: balance < 100n,
+            walletAddress: this.walletAddress,
+        };
+    }
+}
+//# sourceMappingURL=solana-balance.js.map

package/dist/solana-balance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"solana-balance.js","sourceRoot":"","sources":["../src/solana-balance.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAErE,MAAM,gBAAgB,GAAG,8CAA8C,CAAC;AACxE,MAAM,kBAAkB,GAAG,qCAAqC,CAAC;AACjE,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAClC,MAAM,YAAY,GAAG,MAAM,CAAC;AAiB5B,MAAM,OAAO,oBAAoB;IACd,GAAG,CAAqC;IACxC,aAAa,CAAS;IAC/B,aAAa,GAAkB,IAAI,CAAC;IACpC,QAAQ,GAAG,CAAC,CAAC;IAErB,YAAY,aAAqB,EAAE,MAAe;QAChD,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,MAAM,GAAG,GAAG,MAAM,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,yBAAyB,IAAI,kBAAkB,CAAC;QACrF,IAAI,CAAC,GAAG,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,YAAY;QAChB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IACE,IAAI,CAAC,aAAa,KAAK,IAAI;YAC3B,IAAI,CAAC,aAAa,GAAG,EAAE;YACvB,GAAG,GAAG,IAAI,CAAC,QAAQ,GAAG,YAAY,EAClC,CAAC;YACD,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC5C,CAAC;QACD,uEAAuE;QACvE,iEAAiE;QACjE,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAC1C,IAAI,OAAO,GAAG,EAAE,EAAE,CAAC;YACjB,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC;YAC7B,IAAI,CAAC,QAAQ,GAAG,GAAG,CAAC;QACtB,CAAC;QACD,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;IAED,eAAe,CAAC,YAAoB;QAClC,IAAI,IAAI,CAAC,aAAa,KAAK,IAAI,IAAI,IAAI,CAAC,aAAa,IAAI,YAAY,EAAE,CAAC;YACtE,IAAI,CAAC,aAAa,IAAI,YAAY,CAAC;QACrC,CAAC;IACH,CAAC;IAED,UAAU;QACR,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAC1B,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC;IACpB,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC,YAAY,EAAE,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe,CAAC,mBAA2B;QAC/C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QACvC,IAAI,IAAI,CAAC,OAAO,IAAI,mBAAmB,EAAE,CAAC;YACxC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QACpC,CAAC;QACD,MAAM,SAAS,GAAG,mBAAmB,GAAG,IAAI,CAAC,OAAO,CAAC;QACrD,OAAO;YACL,UAAU,EAAE,KAAK;YACjB,IAAI;YACJ,SAAS,EAAE,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;SACtC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,YAAoB;QAC7B,MAAM,OAAO,GAAG,MAAM,CAAC,YAAY,CAAC,GAAG,SAAS,CAAC;QACjD,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IAClC,CAAC;IAED,gBAAgB;QACd,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,eAAe;QACnB,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,kBAAkB,CAAC,CAAC;QACvE,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YAC7C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;YAC3F,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,YAAY;QACxB,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC7C,MAAM,IAAI,GAAG,UAAU,CAAC,gBAAgB,CAAC,CAAC;QAE1C,0EAA0E;QAC1E,wEAAwE;QACxE,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC;YAC7C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YACxD,IAAI,MAAM,GAAG,EAAE,IAAI,OAAO,KAAK,CAAC;gBAAE,OAAO,MAAM,CAAC;YAChD,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;QACjD,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IAEO,KAAK,CAAC,gBAAgB,CAC5B,KAAoC,EACpC,IAAmC;QAEnC,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,kBAAkB,CAAC,CAAC;QAEvE,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,GAAG;iBAC5B,uBAAuB,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC;iBACpE,IAAI,CAAC,EAAE,WAAW,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;YAE5C,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,EAAE,CAAC;YAE3C,IAAI,KAAK,GAAG,EAAE,CAAC;YACf,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;gBACrC,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,IAE9B,CAAC;gBACF,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YACzD,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CACb,wCAAwC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAC1F,EAAE,KAAK,EAAE,GAAG,EAAE,CACf,CAAC;QACJ,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IAEO,SAAS,CAAC,OAAe;QAC/B,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC;QAC5C,OAAO;YACL,OAAO;YACP,UAAU,EAAE,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;YACpC,KAAK,EAAE,OAAO,GAAG,QAAU;YAC3B,OAAO,EAAE,OAAO,GAAG,IAAI;YACvB,aAAa,EAAE,IAAI,CAAC,aAAa;SAClC,CAAC;IACJ,CAAC;CACF"}

package/dist/spend-control.d.ts

@@ -0,0 +1,112 @@
+/**
+ * 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)
+ */
+export type SpendWindow = "perRequest" | "hourly" | "daily" | "session";
+export interface SpendLimits {
+    perRequest?: number;
+    hourly?: number;
+    daily?: number;
+    session?: number;
+}
+export interface SpendRecord {
+    timestamp: number;
+    amount: number;
+    model?: string;
+    action?: string;
+}
+export interface SpendingStatus {
+    limits: SpendLimits;
+    spending: {
+        hourly: number;
+        daily: number;
+        session: number;
+    };
+    remaining: {
+        hourly: number | null;
+        daily: number | null;
+        session: number | null;
+    };
+    calls: number;
+}
+export interface CheckResult {
+    allowed: boolean;
+    blockedBy?: SpendWindow;
+    remaining?: number;
+    reason?: string;
+    resetIn?: number;
+}
+export interface SpendControlStorage {
+    load(): {
+        limits: SpendLimits;
+        history: SpendRecord[];
+    } | null;
+    save(data: {
+        limits: SpendLimits;
+        history: SpendRecord[];
+    }): void;
+}
+export declare class FileSpendControlStorage implements SpendControlStorage {
+    private readonly spendingFile;
+    constructor();
+    load(): {
+        limits: SpendLimits;
+        history: SpendRecord[];
+    } | null;
+    save(data: {
+        limits: SpendLimits;
+        history: SpendRecord[];
+    }): void;
+}
+export declare class InMemorySpendControlStorage implements SpendControlStorage {
+    private data;
+    load(): {
+        limits: SpendLimits;
+        history: SpendRecord[];
+    } | null;
+    save(data: {
+        limits: SpendLimits;
+        history: SpendRecord[];
+    }): void;
+}
+export interface SpendControlOptions {
+    storage?: SpendControlStorage;
+    now?: () => number;
+}
+export declare class SpendControl {
+    private limits;
+    private history;
+    private sessionSpent;
+    private sessionCalls;
+    private readonly storage;
+    private readonly now;
+    constructor(options?: SpendControlOptions);
+    setLimit(window: SpendWindow, amount: number): void;
+    clearLimit(window: SpendWindow): void;
+    getLimits(): SpendLimits;
+    check(estimatedCost: number): CheckResult;
+    record(amount: number, metadata?: {
+        model?: string;
+        action?: string;
+    }): void;
+    private getSpendingInWindow;
+    getSpending(window: "hourly" | "daily" | "session"): number;
+    getRemaining(window: "hourly" | "daily" | "session"): number | null;
+    getStatus(): SpendingStatus;
+    getHistory(limit?: number): SpendRecord[];
+    resetSession(): void;
+    private cleanup;
+    private save;
+    private load;
+}
+export declare function formatDuration(seconds: number): string;
+//# sourceMappingURL=spend-control.d.ts.map

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

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