@blockrun/clawrouter 0.8.10 → 0.8.12

package/dist/index.d.ts

@@ -860,6 +860,7 @@ type AggregatedStats = {
         percentage: number;
     }>;
     dailyBreakdown: DailyStats[];
+    entriesWithBaseline: number;
 };
 /**
  * Get aggregated statistics for the last N days.

package/dist/index.js

@@ -1829,6 +1829,12 @@ async function getStats(days = 7) {
   }
   const totalSavings = totalBaselineCost - totalCost;
   const savingsPercentage = totalBaselineCost > 0 ? totalSavings / totalBaselineCost * 100 : 0;
+  let entriesWithBaseline = 0;
+  for (const day of dailyBreakdown) {
+    if (day.totalBaselineCost !== day.totalCost) {
+      entriesWithBaseline += day.totalRequests;
+    }
+  }
   return {
     period: days === 1 ? "today" : `last ${days} days`,
     totalRequests,
@@ -1840,8 +1846,10 @@ async function getStats(days = 7) {
     avgCostPerRequest: totalRequests > 0 ? totalCost / totalRequests : 0,
     byTier: byTierWithPercentage,
     byModel: byModelWithPercentage,
-    dailyBreakdown: dailyBreakdown.reverse()
+    dailyBreakdown: dailyBreakdown.reverse(),
     // Oldest first for charts
+    entriesWithBaseline
+    // How many entries have valid baseline tracking
   };
 }
 function formatStatsAscii(stats) {
@@ -1853,20 +1861,27 @@ function formatStatsAscii(stats) {
   lines.push(`\u2551  Total Requests: ${stats.totalRequests.toString().padEnd(41)}\u2551`);
   lines.push(`\u2551  Total Cost: $${stats.totalCost.toFixed(4).padEnd(43)}\u2551`);
   lines.push(`\u2551  Baseline Cost (Opus): $${stats.totalBaselineCost.toFixed(4).padEnd(33)}\u2551`);
-  lines.push(
-    `\u2551  \u{1F4B0} Total Saved: $${stats.totalSavings.toFixed(4)} (${stats.savingsPercentage.toFixed(1)}%)`.padEnd(
-      61
-    ) + "\u2551"
-  );
+  const savingsLine = `\u2551  \u{1F4B0} Total Saved: $${stats.totalSavings.toFixed(4)} (${stats.savingsPercentage.toFixed(1)}%)`;
+  if (stats.entriesWithBaseline < stats.totalRequests && stats.entriesWithBaseline > 0) {
+    lines.push(savingsLine.padEnd(61) + "\u2551");
+    const note = `\u2551     (based on ${stats.entriesWithBaseline}/${stats.totalRequests} tracked requests)`;
+    lines.push(note.padEnd(61) + "\u2551");
+  } else {
+    lines.push(savingsLine.padEnd(61) + "\u2551");
+  }
   lines.push(`\u2551  Avg Latency: ${stats.avgLatencyMs.toFixed(0)}ms`.padEnd(61) + "\u2551");
   lines.push("\u2560\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2563");
   lines.push("\u2551  Routing by Tier:                                          \u2551");
-  const tierOrder = ["SIMPLE", "MEDIUM", "COMPLEX", "REASONING"];
+  const knownTiers = ["SIMPLE", "MEDIUM", "COMPLEX", "REASONING"];
+  const allTiers = Object.keys(stats.byTier);
+  const otherTiers = allTiers.filter((t) => !knownTiers.includes(t));
+  const tierOrder = [...knownTiers.filter((t) => stats.byTier[t]), ...otherTiers];
   for (const tier of tierOrder) {
     const data = stats.byTier[tier];
     if (data) {
       const bar = "\u2588".repeat(Math.min(20, Math.round(data.percentage / 5)));
-      const line = `\u2551    ${tier.padEnd(10)} ${bar.padEnd(20)} ${data.percentage.toFixed(1).padStart(5)}% (${data.count})`;
+      const displayTier = tier === "UNKNOWN" ? "OTHER" : tier;
+      const line = `\u2551    ${displayTier.padEnd(10)} ${bar.padEnd(20)} ${data.percentage.toFixed(1).padStart(5)}% (${data.count})`;
       lines.push(line.padEnd(61) + "\u2551");
     }
   }
@@ -2347,6 +2362,42 @@ var HEALTH_CHECK_TIMEOUT_MS = 2e3;
 var RATE_LIMIT_COOLDOWN_MS = 6e4;
 var PORT_RETRY_ATTEMPTS = 5;
 var PORT_RETRY_DELAY_MS = 1e3;
+function transformPaymentError(errorBody) {
+  try {
+    const parsed = JSON.parse(errorBody);
+    if (parsed.error === "Payment verification failed" && parsed.details) {
+      const match = parsed.details.match(/Verification failed:\s*(\{.*\})/s);
+      if (match) {
+        const innerJson = JSON.parse(match[1]);
+        if (innerJson.invalidReason === "insufficient_funds" && innerJson.invalidMessage) {
+          const balanceMatch = innerJson.invalidMessage.match(
+            /insufficient balance:\s*(\d+)\s*<\s*(\d+)/i
+          );
+          if (balanceMatch) {
+            const currentMicros = parseInt(balanceMatch[1], 10);
+            const requiredMicros = parseInt(balanceMatch[2], 10);
+            const currentUSD = (currentMicros / 1e6).toFixed(6);
+            const requiredUSD = (requiredMicros / 1e6).toFixed(6);
+            const wallet = innerJson.payer || "unknown";
+            const shortWallet = wallet.length > 12 ? `${wallet.slice(0, 6)}...${wallet.slice(-4)}` : wallet;
+            return JSON.stringify({
+              error: {
+                message: `Insufficient USDC balance. Current: $${currentUSD}, Required: ~$${requiredUSD}`,
+                type: "insufficient_funds",
+                wallet,
+                current_balance_usd: currentUSD,
+                required_usd: requiredUSD,
+                help: `Fund wallet ${shortWallet} with USDC on Base, or use free model: /model free`
+              }
+            });
+          }
+        }
+      }
+    }
+  } catch {
+  }
+  return errorBody;
+}
 var rateLimitedModels = /* @__PURE__ */ new Map();
 function isRateLimited(modelId) {
   const hitTime = rateLimitedModels.get(modelId);
@@ -3215,10 +3266,18 @@ async function proxyRequest(req, res, apiBase, payFetch, options, routerOpts, de
       options.onRouted?.(routingDecision);
     }
     if (!upstream) {
-      const errBody = lastError?.body || "All models in fallback chain failed";
+      const rawErrBody = lastError?.body || "All models in fallback chain failed";
       const errStatus = lastError?.status || 502;
+      const transformedErr = transformPaymentError(rawErrBody);
       if (headersSentEarly) {
-        const errEvent = `data: ${JSON.stringify({ error: { message: errBody, type: "provider_error", status: errStatus } })}
+        let errPayload;
+        try {
+          const parsed = JSON.parse(transformedErr);
+          errPayload = JSON.stringify(parsed);
+        } catch {
+          errPayload = JSON.stringify({ error: { message: rawErrBody, type: "provider_error", status: errStatus } });
+        }
+        const errEvent = `data: ${errPayload}
 
 `;
         safeWrite(res, errEvent);
@@ -3233,17 +3292,11 @@ async function proxyRequest(req, res, apiBase, payFetch, options, routerOpts, de
         });
       } else {
         res.writeHead(errStatus, { "Content-Type": "application/json" });
-        res.end(
-          JSON.stringify({
-            error: { message: errBody, type: "provider_error" }
-          })
-        );
+        res.end(transformedErr);
         deduplicator.complete(dedupKey, {
           status: errStatus,
           headers: { "content-type": "application/json" },
-          body: Buffer.from(
-            JSON.stringify({ error: { message: errBody, type: "provider_error" } })
-          ),
+          body: Buffer.from(transformedErr),
           completedAt: Date.now()
         });
       }