@blockrun/clawrouter 0.12.56 → 0.12.61

package/dist/index.d.ts

@@ -522,6 +522,7 @@ type SessionEntry = {
     recentHashes: string[];
     strikes: number;
     escalated: boolean;
+    sessionCostMicros: bigint;
 };
 type SessionConfig = {
     /** Enable session persistence (default: false) */
@@ -590,6 +591,17 @@ declare class SessionStore {
         model: string;
         tier: string;
     } | null;
+    /**
+     * Add cost to a session's running total for maxCostPerRun tracking.
+     * Cost is in USDC 6-decimal units (micros).
+     * Creates a cost-tracking-only entry if none exists (e.g., explicit model requests
+     * that never go through the routing path).
+     */
+    addSessionCost(sessionId: string, additionalMicros: bigint): void;
+    /**
+     * Get the total accumulated cost for a session in USD.
+     */
+    getSessionCostUsd(sessionId: string): number;
     /**
      * Stop the cleanup interval.
      */
@@ -669,6 +681,8 @@ type ProxyOptions = {
     requestTimeoutMs?: number;
     /** Skip balance checks (for testing only). Default: false */
     skipBalanceCheck?: boolean;
+    /** Override the balance monitor with a mock (for testing only). */
+    _balanceMonitorOverride?: AnyBalanceMonitor;
     /**
      * Session persistence config. When enabled, maintains model selection
      * across requests within a session to prevent mid-task model switching.
@@ -693,6 +707,24 @@ type ProxyOptions = {
      * Default: enabled with 10 minute TTL, 200 max entries.
      */
     cacheConfig?: ResponseCacheConfig;
+    /**
+     * Maximum total spend (in USD) per session run.
+     * Default: undefined (no limit). Example: 0.5 = $0.50 per session.
+     */
+    maxCostPerRunUsd?: number;
+    /**
+     * How to enforce the per-run cost cap.
+     * - 'graceful' (default): when budget runs low, downgrade to cheaper models; use free model
+     *   as last resort. Only hard-stops when no model can serve the request.
+     * - 'strict': immediately return 429 once the session spend reaches the cap.
+     */
+    maxCostPerRunMode?: "graceful" | "strict";
+    /**
+     * Set of model IDs to exclude from routing.
+     * Excluded models are filtered out of fallback chains.
+     * Loaded from ~/.openclaw/blockrun/exclude-models.json
+     */
+    excludeModels?: Set<string>;
     onReady?: (port: number) => void;
     onError?: (error: Error) => void;
     onPayment?: (info: {
@@ -889,6 +921,8 @@ type UsageEntry = {
     latencyMs: number;
     /** Input (prompt) tokens reported by the provider */
     inputTokens?: number;
+    /** Output (completion) tokens reported by the provider */
+    outputTokens?: number;
     /** Partner service ID (e.g., "x_users_lookup") — only set for partner API calls */
     partnerId?: string;
     /** Partner service name (e.g., "AttentionVC") — only set for partner API calls */