@blockrun/clawrouter 0.12.102 → 0.12.104

package/dist/balance.d.ts

@@ -1,97 +0,0 @@
-/**
- * Balance Monitor for ClawRouter
- *
- * Monitors USDC balance on Base network with intelligent caching.
- * Provides pre-request balance checks to prevent failed payments.
- *
- * Caching Strategy:
- *   - TTL: 30 seconds (balance is cached to avoid excessive RPC calls)
- *   - Optimistic deduction: after successful payment, subtract estimated cost from cache
- *   - Invalidation: on payment failure, immediately refresh from RPC
- */
-/** Balance thresholds in USDC smallest unit (6 decimals) */
-export declare const BALANCE_THRESHOLDS: {
-    /** Low balance warning threshold: $1.00 */
-    readonly LOW_BALANCE_MICROS: 1000000n;
-    /** Effectively zero threshold: $0.0001 (covers dust/rounding) */
-    readonly ZERO_THRESHOLD: 100n;
-};
-/** Balance information returned by checkBalance() */
-export type BalanceInfo = {
-    /** Raw balance in USDC smallest unit (6 decimals) */
-    balance: bigint;
-    /** Formatted balance as "$X.XX" */
-    balanceUSD: string;
-    /** True if balance < $1.00 */
-    isLow: boolean;
-    /** True if balance < $0.0001 (effectively zero) */
-    isEmpty: boolean;
-    /** Wallet address for funding instructions */
-    walletAddress: string;
-};
-/** Result from checkSufficient() */
-export type SufficiencyResult = {
-    /** True if balance >= estimated cost */
-    sufficient: boolean;
-    /** Current balance info */
-    info: BalanceInfo;
-    /** If insufficient, the shortfall as "$X.XX" */
-    shortfall?: string;
-};
-/**
- * Monitors USDC balance on Base network.
- *
- * Usage:
- *   const monitor = new BalanceMonitor("0x...");
- *   const info = await monitor.checkBalance();
- *   if (info.isLow) console.warn("Low balance!");
- */
-export declare class BalanceMonitor {
-    private readonly client;
-    private readonly walletAddress;
-    /** Cached balance (null = not yet fetched) */
-    private cachedBalance;
-    /** Timestamp when cache was last updated */
-    private cachedAt;
-    constructor(walletAddress: string);
-    /**
-     * Check current USDC balance.
-     * Uses cache if valid, otherwise fetches from RPC.
-     */
-    checkBalance(): Promise<BalanceInfo>;
-    /**
-     * Check if balance is sufficient for an estimated cost.
-     *
-     * @param estimatedCostMicros - Estimated cost in USDC smallest unit (6 decimals)
-     */
-    checkSufficient(estimatedCostMicros: bigint): Promise<SufficiencyResult>;
-    /**
-     * Optimistically deduct estimated cost from cached balance.
-     * Call this after a successful payment to keep cache accurate.
-     *
-     * @param amountMicros - Amount to deduct in USDC smallest unit
-     */
-    deductEstimated(amountMicros: bigint): void;
-    /**
-     * Invalidate cache, forcing next checkBalance() to fetch from RPC.
-     * Call this after a payment failure to get accurate balance.
-     */
-    invalidate(): void;
-    /**
-     * Force refresh balance from RPC (ignores cache).
-     */
-    refresh(): Promise<BalanceInfo>;
-    /**
-     * Format USDC amount (in micros) as "$X.XX".
-     */
-    formatUSDC(amountMicros: bigint): string;
-    /**
-     * Get the wallet address being monitored.
-     */
-    getWalletAddress(): string;
-    /** Fetch balance from RPC */
-    private fetchBalance;
-    /** Build BalanceInfo from raw balance */
-    private buildInfo;
-}
-//# sourceMappingURL=balance.d.ts.map

package/dist/balance.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"balance.d.ts","sourceRoot":"","sources":["../src/balance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAYH,4DAA4D;AAC5D,eAAO,MAAM,kBAAkB;IAC7B,2CAA2C;;IAE3C,iEAAiE;;CAEzD,CAAC;AAEX,qDAAqD;AACrD,MAAM,MAAM,WAAW,GAAG;IACxB,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,8BAA8B;IAC9B,KAAK,EAAE,OAAO,CAAC;IACf,mDAAmD;IACnD,OAAO,EAAE,OAAO,CAAC;IACjB,8CAA8C;IAC9C,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,oCAAoC;AACpC,MAAM,MAAM,iBAAiB,GAAG;IAC9B,wCAAwC;IACxC,UAAU,EAAE,OAAO,CAAC;IACpB,2BAA2B;IAC3B,IAAI,EAAE,WAAW,CAAC;IAClB,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;;;;;GAOG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IACxB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAE9C,8CAA8C;IAC9C,OAAO,CAAC,aAAa,CAAuB;IAC5C,4CAA4C;IAC5C,OAAO,CAAC,QAAQ,CAAK;gBAET,aAAa,EAAE,MAAM;IAUjC;;;OAGG;IACG,YAAY,IAAI,OAAO,CAAC,WAAW,CAAC;IAwB1C;;;;OAIG;IACG,eAAe,CAAC,mBAAmB,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAe9E;;;;;OAKG;IACH,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAM3C;;;OAGG;IACH,UAAU,IAAI,IAAI;IAKlB;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,WAAW,CAAC;IAKrC;;OAEG;IACH,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAMxC;;OAEG;IACH,gBAAgB,IAAI,MAAM;IAI1B,6BAA6B;YACf,YAAY;IAgB1B,yCAAyC;IACzC,OAAO,CAAC,SAAS;CASlB"}

package/dist/balance.js

@@ -1,157 +0,0 @@
-/**
- * Balance Monitor for ClawRouter
- *
- * Monitors USDC balance on Base network with intelligent caching.
- * Provides pre-request balance checks to prevent failed payments.
- *
- * Caching Strategy:
- *   - TTL: 30 seconds (balance is cached to avoid excessive RPC calls)
- *   - Optimistic deduction: after successful payment, subtract estimated cost from cache
- *   - Invalidation: on payment failure, immediately refresh from RPC
- */
-import { createPublicClient, http, erc20Abi } from "viem";
-import { base } from "viem/chains";
-import { RpcError } from "./errors.js";
-/** USDC contract address on Base mainnet */
-const USDC_BASE = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
-/** Cache TTL in milliseconds (30 seconds) */
-const CACHE_TTL_MS = 30_000;
-/** Balance thresholds in USDC smallest unit (6 decimals) */
-export const BALANCE_THRESHOLDS = {
-    /** Low balance warning threshold: $1.00 */
-    LOW_BALANCE_MICROS: 1000000n,
-    /** Effectively zero threshold: $0.0001 (covers dust/rounding) */
-    ZERO_THRESHOLD: 100n,
-};
-/**
- * Monitors USDC balance on Base network.
- *
- * Usage:
- *   const monitor = new BalanceMonitor("0x...");
- *   const info = await monitor.checkBalance();
- *   if (info.isLow) console.warn("Low balance!");
- */
-export class BalanceMonitor {
-    client;
-    walletAddress;
-    /** Cached balance (null = not yet fetched) */
-    cachedBalance = null;
-    /** Timestamp when cache was last updated */
-    cachedAt = 0;
-    constructor(walletAddress) {
-        this.walletAddress = walletAddress;
-        this.client = createPublicClient({
-            chain: base,
-            transport: http(undefined, {
-                timeout: 10_000, // 10 second timeout to prevent hanging on slow RPC
-            }),
-        });
-    }
-    /**
-     * Check current USDC balance.
-     * Uses cache if valid, otherwise fetches from RPC.
-     */
-    async checkBalance() {
-        const now = Date.now();
-        // Use cache only when balance is positive and still fresh.
-        // Zero balance is never cached — always re-fetch so a funded wallet is
-        // detected on the next request without waiting for cache expiry.
-        if (this.cachedBalance !== null &&
-            this.cachedBalance > 0n &&
-            now - this.cachedAt < CACHE_TTL_MS) {
-            return this.buildInfo(this.cachedBalance);
-        }
-        // Fetch from RPC
-        const balance = await this.fetchBalance();
-        if (balance > 0n) {
-            this.cachedBalance = balance;
-            this.cachedAt = now;
-        }
-        return this.buildInfo(balance);
-    }
-    /**
-     * Check if balance is sufficient for an estimated cost.
-     *
-     * @param estimatedCostMicros - Estimated cost in USDC smallest unit (6 decimals)
-     */
-    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),
-        };
-    }
-    /**
-     * Optimistically deduct estimated cost from cached balance.
-     * Call this after a successful payment to keep cache accurate.
-     *
-     * @param amountMicros - Amount to deduct in USDC smallest unit
-     */
-    deductEstimated(amountMicros) {
-        if (this.cachedBalance !== null && this.cachedBalance >= amountMicros) {
-            this.cachedBalance -= amountMicros;
-        }
-    }
-    /**
-     * Invalidate cache, forcing next checkBalance() to fetch from RPC.
-     * Call this after a payment failure to get accurate balance.
-     */
-    invalidate() {
-        this.cachedBalance = null;
-        this.cachedAt = 0;
-    }
-    /**
-     * Force refresh balance from RPC (ignores cache).
-     */
-    async refresh() {
-        this.invalidate();
-        return this.checkBalance();
-    }
-    /**
-     * Format USDC amount (in micros) as "$X.XX".
-     */
-    formatUSDC(amountMicros) {
-        // USDC has 6 decimals
-        const dollars = Number(amountMicros) / 1_000_000;
-        return `$${dollars.toFixed(2)}`;
-    }
-    /**
-     * Get the wallet address being monitored.
-     */
-    getWalletAddress() {
-        return this.walletAddress;
-    }
-    /** Fetch balance from RPC */
-    async fetchBalance() {
-        try {
-            const balance = await this.client.readContract({
-                address: USDC_BASE,
-                abi: erc20Abi,
-                functionName: "balanceOf",
-                args: [this.walletAddress],
-            });
-            return balance;
-        }
-        catch (error) {
-            // Throw typed error instead of silently returning 0
-            // This allows callers to distinguish "node down" from "wallet empty"
-            throw new RpcError(error instanceof Error ? error.message : "Unknown error", error);
-        }
-    }
-    /** Build BalanceInfo from raw balance */
-    buildInfo(balance) {
-        return {
-            balance,
-            balanceUSD: this.formatUSDC(balance),
-            isLow: balance < BALANCE_THRESHOLDS.LOW_BALANCE_MICROS,
-            isEmpty: balance < BALANCE_THRESHOLDS.ZERO_THRESHOLD,
-            walletAddress: this.walletAddress,
-        };
-    }
-}
-//# sourceMappingURL=balance.js.map

package/dist/balance.js.map

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

package/dist/cli.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;GAYG"}

package/dist/compression/codebook.d.ts

@@ -1,24 +0,0 @@
-/**
- * Dictionary Codebook
- *
- * Static dictionary of frequently repeated phrases observed in LLM prompts.
- * Built from analysis of BlockRun production logs.
- *
- * Format: Short code ($XX) -> Long phrase
- * The LLM receives a codebook header and decodes in-context.
- */
-export declare const STATIC_CODEBOOK: Record<string, string>;
-/**
- * Get the inverse codebook for decompression.
- */
-export declare function getInverseCodebook(): Record<string, string>;
-/**
- * Generate the codebook header for inclusion in system message.
- * LLMs can decode in-context using this header.
- */
-export declare function generateCodebookHeader(usedCodes: Set<string>, pathMap?: Record<string, string>): string;
-/**
- * Decompress a string using the codebook (for logging).
- */
-export declare function decompressContent(content: string, codebook?: Record<string, string>): string;
-//# sourceMappingURL=codebook.d.ts.map

package/dist/compression/codebook.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"codebook.d.ts","sourceRoot":"","sources":["../../src/compression/codebook.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAuElD,CAAC;AAEF;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAM3D;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,EACtB,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GACnC,MAAM,CAwBR;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAmB,GACjD,MAAM,CAMR"}

package/dist/compression/codebook.js

@@ -1,119 +0,0 @@
-/**
- * Dictionary Codebook
- *
- * Static dictionary of frequently repeated phrases observed in LLM prompts.
- * Built from analysis of BlockRun production logs.
- *
- * Format: Short code ($XX) -> Long phrase
- * The LLM receives a codebook header and decodes in-context.
- */
-// Static codebook - common patterns from system prompts
-// Ordered by expected frequency and impact
-export const STATIC_CODEBOOK = {
-    // High-impact: OpenClaw/Agent system prompt patterns (very common)
-    $OC01: "unbrowse_", // Common prefix in tool names
-    $OC02: "<location>",
-    $OC03: "</location>",
-    $OC04: "<name>",
-    $OC05: "</name>",
-    $OC06: "<description>",
-    $OC07: "</description>",
-    $OC08: "(may need login)",
-    $OC09: "API skill for OpenClaw",
-    $OC10: "endpoints",
-    // Skill/tool markers
-    $SK01: "<available_skills>",
-    $SK02: "</available_skills>",
-    $SK03: "<skill>",
-    $SK04: "</skill>",
-    // Schema patterns (very common in tool definitions)
-    $T01: 'type: "function"',
-    $T02: '"type": "function"',
-    $T03: '"type": "string"',
-    $T04: '"type": "object"',
-    $T05: '"type": "array"',
-    $T06: '"type": "boolean"',
-    $T07: '"type": "number"',
-    // Common descriptions
-    $D01: "description:",
-    $D02: '"description":',
-    // Common instructions
-    $I01: "You are a personal assistant",
-    $I02: "Tool names are case-sensitive",
-    $I03: "Call tools exactly as listed",
-    $I04: "Use when",
-    $I05: "without asking",
-    // Safety phrases
-    $S01: "Do not manipulate or persuade",
-    $S02: "Prioritize safety and human oversight",
-    $S03: "unless explicitly requested",
-    // JSON patterns
-    $J01: '"required": ["',
-    $J02: '"properties": {',
-    $J03: '"additionalProperties": false',
-    // Heartbeat patterns
-    $H01: "HEARTBEAT_OK",
-    $H02: "Read HEARTBEAT.md if it exists",
-    // Role markers
-    $R01: '"role": "system"',
-    $R02: '"role": "user"',
-    $R03: '"role": "assistant"',
-    $R04: '"role": "tool"',
-    // Common endings/phrases
-    $E01: "would you like to",
-    $E02: "Let me know if you",
-    $E03: "internal APIs",
-    $E04: "session cookies",
-    // BlockRun model aliases (common in prompts)
-    $M01: "blockrun/",
-    $M02: "openai/",
-    $M03: "anthropic/",
-    $M04: "google/",
-    $M05: "xai/",
-};
-/**
- * Get the inverse codebook for decompression.
- */
-export function getInverseCodebook() {
-    const inverse = {};
-    for (const [code, phrase] of Object.entries(STATIC_CODEBOOK)) {
-        inverse[phrase] = code;
-    }
-    return inverse;
-}
-/**
- * Generate the codebook header for inclusion in system message.
- * LLMs can decode in-context using this header.
- */
-export function generateCodebookHeader(usedCodes, pathMap = {}) {
-    if (usedCodes.size === 0 && Object.keys(pathMap).length === 0) {
-        return "";
-    }
-    const parts = [];
-    // Add used dictionary codes
-    if (usedCodes.size > 0) {
-        const codeEntries = Array.from(usedCodes)
-            .map((code) => `${code}=${STATIC_CODEBOOK[code]}`)
-            .join(", ");
-        parts.push(`[Dict: ${codeEntries}]`);
-    }
-    // Add path map
-    if (Object.keys(pathMap).length > 0) {
-        const pathEntries = Object.entries(pathMap)
-            .map(([code, path]) => `${code}=${path}`)
-            .join(", ");
-        parts.push(`[Paths: ${pathEntries}]`);
-    }
-    return parts.join("\n");
-}
-/**
- * Decompress a string using the codebook (for logging).
- */
-export function decompressContent(content, codebook = STATIC_CODEBOOK) {
-    let result = content;
-    for (const [code, phrase] of Object.entries(codebook)) {
-        result = result.split(code).join(phrase);
-    }
-    return result;
-}
-//# sourceMappingURL=codebook.js.map

package/dist/compression/codebook.js.map

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

package/dist/compression/index.d.ts

@@ -1,33 +0,0 @@
-/**
- * LLM-Safe Context Compression
- *
- * Reduces token usage by 15-40% while preserving semantic meaning.
- * Implements 7 compression layers inspired by claw-compactor.
- *
- * Usage:
- *   const result = await compressContext(messages);
- *   // result.messages -> compressed version to send to provider
- *   // result.originalMessages -> original for logging
- */
-import { NormalizedMessage, CompressionConfig, CompressionResult } from "./types.js";
-export * from "./types.js";
-export { STATIC_CODEBOOK } from "./codebook.js";
-/**
- * Main compression function.
- *
- * Applies 5 layers in sequence:
- * 1. Deduplication - Remove exact duplicate messages
- * 2. Whitespace - Normalize excessive whitespace
- * 3. Dictionary - Replace common phrases with codes
- * 4. Paths - Shorten repeated file paths
- * 5. JSON - Compact JSON in tool calls
- *
- * Then prepends a codebook header for the LLM to decode in-context.
- */
-export declare function compressContext(messages: NormalizedMessage[], config?: Partial<CompressionConfig>): Promise<CompressionResult>;
-/**
- * Quick check if compression would benefit these messages.
- * Returns true if messages are large enough to warrant compression.
- */
-export declare function shouldCompress(messages: NormalizedMessage[]): boolean;
-//# sourceMappingURL=index.d.ts.map

package/dist/compression/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/compression/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EAGlB,MAAM,YAAY,CAAC;AAUpB,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAqEhD;;;;;;;;;;;GAWG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,iBAAiB,EAAE,EAC7B,MAAM,GAAE,OAAO,CAAC,iBAAiB,CAAM,GACtC,OAAO,CAAC,iBAAiB,CAAC,CA+J5B;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,iBAAiB,EAAE,GAAG,OAAO,CAIrE"}