@blockrun/clawrouter 0.9.39 → 0.10.1

package/dist/cli.js

@@ -1199,10 +1199,10 @@ var DEFAULT_ROUTING_CONFIG = {
   tiers: {
     SIMPLE: {
       primary: "moonshot/kimi-k2.5",
-      // $0.50/$2.40 - best quality/price for simple tasks
+      // $0.60/$3.00 - best quality/price for simple tasks
       fallback: [
-        "google/gemini-2.5-flash",
-        // 1M context, cost-effective
+        "google/gemini-2.5-flash-lite",
+        // 1M context, ultra cheap ($0.10/$0.40)
         "nvidia/gpt-oss-120b",
         // FREE fallback
         "deepseek/deepseek-chat"
@@ -1212,26 +1212,28 @@ var DEFAULT_ROUTING_CONFIG = {
       primary: "xai/grok-code-fast-1",
       // Code specialist, $0.20/$1.50
       fallback: [
-        "google/gemini-2.5-flash",
-        // 1M context, cost-effective
+        "google/gemini-2.5-flash-lite",
+        // 1M context, ultra cheap ($0.10/$0.40)
         "deepseek/deepseek-chat",
         "xai/grok-4-1-fast-non-reasoning"
         // Upgraded Grok 4.1
       ]
     },
     COMPLEX: {
-      primary: "google/gemini-3-pro-preview",
-      // Latest Gemini - upgraded from 2.5
+      primary: "google/gemini-3.1-pro-preview",
+      // Newest Gemini 3.1 - upgraded from 3.0
       fallback: [
-        "google/gemini-2.5-flash",
-        // CRITICAL: 1M context, cheap failsafe before expensive models
+        "google/gemini-2.5-flash-lite",
+        // CRITICAL: 1M context, ultra-cheap failsafe ($0.10/$0.40)
+        "google/gemini-3-pro-preview",
+        // 3.0 fallback
         "google/gemini-2.5-pro",
         "deepseek/deepseek-chat",
         "xai/grok-4-0709",
         "openai/gpt-5.2",
         // Newer and cheaper input than gpt-4o
         "openai/gpt-4o",
-        "claude-sonnet-4"
+        "anthropic/claude-sonnet-4.6"
       ]
     },
     REASONING: {
@@ -1251,17 +1253,17 @@ var DEFAULT_ROUTING_CONFIG = {
     SIMPLE: {
       primary: "nvidia/gpt-oss-120b",
       // FREE! $0.00/$0.00
-      fallback: ["google/gemini-2.5-flash", "deepseek/deepseek-chat"]
+      fallback: ["google/gemini-2.5-flash-lite", "deepseek/deepseek-chat"]
     },
     MEDIUM: {
-      primary: "google/gemini-2.5-flash",
-      // $0.15/$0.60 - cheapest capable
+      primary: "google/gemini-2.5-flash-lite",
+      // $0.10/$0.40 - cheapest capable with 1M context
       fallback: ["deepseek/deepseek-chat", "nvidia/gpt-oss-120b"]
     },
     COMPLEX: {
-      primary: "google/gemini-2.5-flash",
-      // $0.15/$0.60 - 1M context handles complexity
-      fallback: ["deepseek/deepseek-chat", "xai/grok-4-0709"]
+      primary: "google/gemini-2.5-flash-lite",
+      // $0.10/$0.40 - 1M context handles complexity
+      fallback: ["google/gemini-2.5-flash", "deepseek/deepseek-chat", "xai/grok-4-0709"]
     },
     REASONING: {
       primary: "xai/grok-4-1-fast-reasoning",
@@ -1274,8 +1276,12 @@ var DEFAULT_ROUTING_CONFIG = {
   premiumTiers: {
     SIMPLE: {
       primary: "moonshot/kimi-k2.5",
-      // $0.50/$2.40 - good for simple coding
-      fallback: ["claude-haiku-4.5", "google/gemini-2.5-flash", "xai/grok-code-fast-1"]
+      // $0.60/$3.00 - good for simple coding
+      fallback: [
+        "anthropic/claude-haiku-4.5",
+        "google/gemini-2.5-flash-lite",
+        "xai/grok-code-fast-1"
+      ]
     },
     MEDIUM: {
       primary: "openai/gpt-5.2-codex",
@@ -1284,26 +1290,28 @@ var DEFAULT_ROUTING_CONFIG = {
         "moonshot/kimi-k2.5",
         "google/gemini-2.5-pro",
         "xai/grok-4-0709",
-        "claude-sonnet-4"
+        "anthropic/claude-sonnet-4.6"
       ]
     },
     COMPLEX: {
-      primary: "claude-opus-4",
+      primary: "anthropic/claude-opus-4.6",
       // Best quality for complex tasks
       fallback: [
         "openai/gpt-5.2-codex",
-        "claude-opus-4",
-        "claude-sonnet-4",
+        "anthropic/claude-opus-4.6",
+        "anthropic/claude-sonnet-4.6",
+        "google/gemini-3.1-pro-preview",
+        // Newest Gemini
         "google/gemini-3-pro-preview",
         "moonshot/kimi-k2.5"
       ]
     },
     REASONING: {
-      primary: "claude-sonnet-4",
+      primary: "anthropic/claude-sonnet-4.6",
       // $3/$15 - best for reasoning/instructions
       fallback: [
-        "claude-opus-4",
-        "claude-opus-4",
+        "anthropic/claude-opus-4.6",
+        "anthropic/claude-opus-4.6",
         "openai/o4-mini",
         // Newer and cheaper than o3 ($1.10 vs $2.00)
         "openai/o3",
@@ -1316,27 +1324,37 @@ var DEFAULT_ROUTING_CONFIG = {
     SIMPLE: {
       primary: "moonshot/kimi-k2.5",
       // Cheaper than Haiku ($0.5/$2.4 vs $1/$5), larger context
-      fallback: ["claude-haiku-4.5", "xai/grok-4-1-fast-non-reasoning", "openai/gpt-4o-mini"]
+      fallback: [
+        "anthropic/claude-haiku-4.5",
+        "xai/grok-4-1-fast-non-reasoning",
+        "openai/gpt-4o-mini"
+      ]
     },
     MEDIUM: {
       primary: "xai/grok-code-fast-1",
       // Code specialist for agentic coding
-      fallback: ["moonshot/kimi-k2.5", "claude-haiku-4.5", "claude-sonnet-4"]
+      fallback: ["moonshot/kimi-k2.5", "anthropic/claude-haiku-4.5", "claude-sonnet-4"]
     },
     COMPLEX: {
-      primary: "claude-sonnet-4",
+      primary: "anthropic/claude-sonnet-4.6",
       fallback: [
-        "claude-opus-4",
+        "anthropic/claude-opus-4.6",
         // Latest Opus - best agentic
         "openai/gpt-5.2",
+        "google/gemini-3.1-pro-preview",
+        // Newest Gemini
         "google/gemini-3-pro-preview",
         "xai/grok-4-0709"
       ]
     },
     REASONING: {
-      primary: "claude-sonnet-4",
+      primary: "anthropic/claude-sonnet-4.6",
       // Strong tool use + reasoning for agentic tasks
-      fallback: ["claude-opus-4", "xai/grok-4-1-fast-reasoning", "deepseek/deepseek-reasoner"]
+      fallback: [
+        "anthropic/claude-opus-4.6",
+        "xai/grok-4-1-fast-reasoning",
+        "deepseek/deepseek-reasoner"
+      ]
     }
   },
   overrides: {
@@ -1420,35 +1438,37 @@ function route(prompt, systemPrompt, maxOutputTokens, options) {
 
 // src/models.ts
 var MODEL_ALIASES = {
-  // Claude - short names (backend uses bare model names without anthropic/ prefix)
-  claude: "claude-sonnet-4",
-  sonnet: "claude-sonnet-4",
-  "sonnet-4.6": "claude-sonnet-4",
-  "sonnet-4-6": "claude-sonnet-4",
-  opus: "claude-opus-4",
-  "opus-4": "claude-opus-4",
-  haiku: "claude-haiku-4.5",
+  // Claude - use newest versions (4.6)
+  claude: "anthropic/claude-sonnet-4.6",
+  sonnet: "anthropic/claude-sonnet-4.6",
+  "sonnet-4": "anthropic/claude-sonnet-4.6",
+  "sonnet-4.6": "anthropic/claude-sonnet-4.6",
+  "sonnet-4-6": "anthropic/claude-sonnet-4.6",
+  opus: "anthropic/claude-opus-4.6",
+  "opus-4": "anthropic/claude-opus-4.6",
+  "opus-4.6": "anthropic/claude-opus-4.6",
+  "opus-4-6": "anthropic/claude-opus-4.6",
+  haiku: "anthropic/claude-haiku-4.5",
   // Claude - provider/shortname patterns (common in agent frameworks)
-  "anthropic/sonnet": "claude-sonnet-4",
-  "anthropic/opus": "claude-opus-4",
-  "anthropic/haiku": "claude-haiku-4.5",
-  "anthropic/claude": "claude-sonnet-4",
-  // Backward compatibility - various formats all route to backend names
-  "anthropic/claude-sonnet-4": "claude-sonnet-4",
-  "anthropic/claude-sonnet-4-6": "claude-sonnet-4",
-  "anthropic/claude-sonnet-4.6": "claude-sonnet-4",
-  "anthropic/claude-opus-4": "claude-opus-4",
-  "anthropic/claude-opus-4-6": "claude-opus-4",
-  "anthropic/claude-opus-4.6": "claude-opus-4",
-  "anthropic/claude-haiku-4": "claude-haiku-4.5",
-  "anthropic/claude-haiku-4-5": "claude-haiku-4.5",
-  "anthropic/claude-haiku-4.5": "claude-haiku-4.5",
+  "anthropic/sonnet": "anthropic/claude-sonnet-4.6",
+  "anthropic/opus": "anthropic/claude-opus-4.6",
+  "anthropic/haiku": "anthropic/claude-haiku-4.5",
+  "anthropic/claude": "anthropic/claude-sonnet-4.6",
+  // Backward compatibility - map all variants to 4.6
+  "anthropic/claude-sonnet-4": "anthropic/claude-sonnet-4.6",
+  "anthropic/claude-sonnet-4-6": "anthropic/claude-sonnet-4.6",
+  "anthropic/claude-opus-4": "anthropic/claude-opus-4.6",
+  "anthropic/claude-opus-4-6": "anthropic/claude-opus-4.6",
+  "anthropic/claude-opus-4.5": "anthropic/claude-opus-4.6",
+  "anthropic/claude-haiku-4": "anthropic/claude-haiku-4.5",
+  "anthropic/claude-haiku-4-5": "anthropic/claude-haiku-4.5",
   // OpenAI
   gpt: "openai/gpt-4o",
   gpt4: "openai/gpt-4o",
   gpt5: "openai/gpt-5.2",
   codex: "openai/gpt-5.2-codex",
   mini: "openai/gpt-4o-mini",
+  o1: "openai/o1",
   o3: "openai/o3",
   // DeepSeek
   deepseek: "deepseek/deepseek-chat",
@@ -1524,6 +1544,7 @@ var BLOCKRUN_MODELS = [
   {
     id: "openai/gpt-5.2",
     name: "GPT-5.2",
+    version: "5.2",
     inputPrice: 1.75,
     outputPrice: 14,
     contextWindow: 4e5,
@@ -1535,6 +1556,7 @@ var BLOCKRUN_MODELS = [
   {
     id: "openai/gpt-5-mini",
     name: "GPT-5 Mini",
+    version: "5.0",
     inputPrice: 0.25,
     outputPrice: 2,
     contextWindow: 2e5,
@@ -1543,6 +1565,7 @@ var BLOCKRUN_MODELS = [
   {
     id: "openai/gpt-5-nano",
     name: "GPT-5 Nano",
+    version: "5.0",
     inputPrice: 0.05,
     outputPrice: 0.4,
     contextWindow: 128e3,
@@ -1551,6 +1574,7 @@ var BLOCKRUN_MODELS = [
   {
     id: "openai/gpt-5.2-pro",
     name: "GPT-5.2 Pro",
+    version: "5.2",
     inputPrice: 21,
     outputPrice: 168,
     contextWindow: 4e5,
@@ -1561,8 +1585,9 @@ var BLOCKRUN_MODELS = [
   {
     id: "openai/gpt-5.2-codex",
     name: "GPT-5.2 Codex",
-    inputPrice: 2.5,
-    outputPrice: 12,
+    version: "5.2",
+    inputPrice: 1.75,
+    outputPrice: 14,
     contextWindow: 128e3,
     maxOutput: 32e3,
     agentic: true
@@ -1571,6 +1596,7 @@ var BLOCKRUN_MODELS = [
   {
     id: "openai/gpt-4.1",
     name: "GPT-4.1",
+    version: "4.1",
     inputPrice: 2,
     outputPrice: 8,
     contextWindow: 128e3,
@@ -1580,15 +1606,25 @@ var BLOCKRUN_MODELS = [
   {
     id: "openai/gpt-4.1-mini",
     name: "GPT-4.1 Mini",
+    version: "4.1",
     inputPrice: 0.4,
     outputPrice: 1.6,
     contextWindow: 128e3,
     maxOutput: 16384
   },
-  // gpt-4.1-nano removed - replaced by gpt-5-nano
+  {
+    id: "openai/gpt-4.1-nano",
+    name: "GPT-4.1 Nano",
+    version: "4.1",
+    inputPrice: 0.1,
+    outputPrice: 0.4,
+    contextWindow: 128e3,
+    maxOutput: 16384
+  },
   {
     id: "openai/gpt-4o",
     name: "GPT-4o",
+    version: "4o",
     inputPrice: 2.5,
     outputPrice: 10,
     contextWindow: 128e3,
@@ -1599,15 +1635,37 @@ var BLOCKRUN_MODELS = [
   {
     id: "openai/gpt-4o-mini",
     name: "GPT-4o Mini",
+    version: "4o-mini",
     inputPrice: 0.15,
     outputPrice: 0.6,
     contextWindow: 128e3,
     maxOutput: 16384
   },
-  // OpenAI O-series (Reasoning) - o1/o1-mini removed, replaced by o3/o4
+  // OpenAI O-series (Reasoning)
+  {
+    id: "openai/o1",
+    name: "o1",
+    version: "1",
+    inputPrice: 15,
+    outputPrice: 60,
+    contextWindow: 2e5,
+    maxOutput: 1e5,
+    reasoning: true
+  },
+  {
+    id: "openai/o1-mini",
+    name: "o1-mini",
+    version: "1-mini",
+    inputPrice: 1.1,
+    outputPrice: 4.4,
+    contextWindow: 128e3,
+    maxOutput: 65536,
+    reasoning: true
+  },
   {
     id: "openai/o3",
     name: "o3",
+    version: "3",
     inputPrice: 2,
     outputPrice: 8,
     contextWindow: 2e5,
@@ -1617,6 +1675,7 @@ var BLOCKRUN_MODELS = [
   {
     id: "openai/o3-mini",
     name: "o3-mini",
+    version: "3-mini",
     inputPrice: 1.1,
     outputPrice: 4.4,
     contextWindow: 128e3,
@@ -1626,6 +1685,7 @@ var BLOCKRUN_MODELS = [
   {
     id: "openai/o4-mini",
     name: "o4-mini",
+    version: "4-mini",
     inputPrice: 1.1,
     outputPrice: 4.4,
     contextWindow: 128e3,
@@ -1633,10 +1693,11 @@ var BLOCKRUN_MODELS = [
     reasoning: true
   },
   // Anthropic - all Claude models excel at agentic workflows
-  // Backend uses bare model names (claude-sonnet-4, not anthropic/claude-sonnet-4-6)
+  // Use newest versions (4.6) with full provider prefix
   {
-    id: "claude-haiku-4.5",
+    id: "anthropic/claude-haiku-4.5",
     name: "Claude Haiku 4.5",
+    version: "4.5",
     inputPrice: 1,
     outputPrice: 5,
     contextWindow: 2e5,
@@ -1644,8 +1705,9 @@ var BLOCKRUN_MODELS = [
     agentic: true
   },
   {
-    id: "claude-sonnet-4",
+    id: "anthropic/claude-sonnet-4.6",
     name: "Claude Sonnet 4.6",
+    version: "4.6",
     inputPrice: 3,
     outputPrice: 15,
     contextWindow: 2e5,
@@ -1654,19 +1716,32 @@ var BLOCKRUN_MODELS = [
     agentic: true
   },
   {
-    id: "claude-opus-4",
+    id: "anthropic/claude-opus-4.6",
     name: "Claude Opus 4.6",
-    inputPrice: 15,
-    outputPrice: 75,
+    version: "4.6",
+    inputPrice: 5,
+    outputPrice: 25,
     contextWindow: 2e5,
     maxOutput: 32e3,
     reasoning: true,
     agentic: true
   },
   // Google
+  {
+    id: "google/gemini-3.1-pro-preview",
+    name: "Gemini 3.1 Pro Preview",
+    version: "3.1",
+    inputPrice: 2,
+    outputPrice: 12,
+    contextWindow: 105e4,
+    maxOutput: 65536,
+    reasoning: true,
+    vision: true
+  },
   {
     id: "google/gemini-3-pro-preview",
     name: "Gemini 3 Pro Preview",
+    version: "3.0",
     inputPrice: 2,
     outputPrice: 12,
     contextWindow: 105e4,
@@ -1674,9 +1749,20 @@ var BLOCKRUN_MODELS = [
     reasoning: true,
     vision: true
   },
+  {
+    id: "google/gemini-3-flash-preview",
+    name: "Gemini 3 Flash Preview",
+    version: "3.0",
+    inputPrice: 0.5,
+    outputPrice: 3,
+    contextWindow: 1e6,
+    maxOutput: 65536,
+    vision: true
+  },
   {
     id: "google/gemini-2.5-pro",
     name: "Gemini 2.5 Pro",
+    version: "2.5",
     inputPrice: 1.25,
     outputPrice: 10,
     contextWindow: 105e4,
@@ -1687,8 +1773,18 @@ var BLOCKRUN_MODELS = [
   {
     id: "google/gemini-2.5-flash",
     name: "Gemini 2.5 Flash",
-    inputPrice: 0.15,
-    outputPrice: 0.6,
+    version: "2.5",
+    inputPrice: 0.3,
+    outputPrice: 2.5,
+    contextWindow: 1e6,
+    maxOutput: 65536
+  },
+  {
+    id: "google/gemini-2.5-flash-lite",
+    name: "Gemini 2.5 Flash Lite",
+    version: "2.5",
+    inputPrice: 0.1,
+    outputPrice: 0.4,
     contextWindow: 1e6,
     maxOutput: 65536
   },
@@ -1696,6 +1792,7 @@ var BLOCKRUN_MODELS = [
   {
     id: "deepseek/deepseek-chat",
     name: "DeepSeek V3.2 Chat",
+    version: "3.2",
     inputPrice: 0.28,
     outputPrice: 0.42,
     contextWindow: 128e3,
@@ -1704,6 +1801,7 @@ var BLOCKRUN_MODELS = [
   {
     id: "deepseek/deepseek-reasoner",
     name: "DeepSeek V3.2 Reasoner",
+    version: "3.2",
     inputPrice: 0.28,
     outputPrice: 0.42,
     contextWindow: 128e3,
@@ -1714,8 +1812,9 @@ var BLOCKRUN_MODELS = [
   {
     id: "moonshot/kimi-k2.5",
     name: "Kimi K2.5",
-    inputPrice: 0.5,
-    outputPrice: 2.4,
+    version: "k2.5",
+    inputPrice: 0.6,
+    outputPrice: 3,
     contextWindow: 262144,
     maxOutput: 8192,
     reasoning: true,
@@ -1726,6 +1825,7 @@ var BLOCKRUN_MODELS = [
   {
     id: "xai/grok-3",
     name: "Grok 3",
+    version: "3",
     inputPrice: 3,
     outputPrice: 15,
     contextWindow: 131072,
@@ -1736,6 +1836,7 @@ var BLOCKRUN_MODELS = [
   {
     id: "xai/grok-3-mini",
     name: "Grok 3 Mini",
+    version: "3-mini",
     inputPrice: 0.3,
     outputPrice: 0.5,
     contextWindow: 131072,
@@ -1745,6 +1846,7 @@ var BLOCKRUN_MODELS = [
   {
     id: "xai/grok-4-fast-reasoning",
     name: "Grok 4 Fast Reasoning",
+    version: "4",
     inputPrice: 0.2,
     outputPrice: 0.5,
     contextWindow: 131072,
@@ -1754,6 +1856,7 @@ var BLOCKRUN_MODELS = [
   {
     id: "xai/grok-4-fast-non-reasoning",
     name: "Grok 4 Fast",
+    version: "4",
     inputPrice: 0.2,
     outputPrice: 0.5,
     contextWindow: 131072,
@@ -1762,6 +1865,7 @@ var BLOCKRUN_MODELS = [
   {
     id: "xai/grok-4-1-fast-reasoning",
     name: "Grok 4.1 Fast Reasoning",
+    version: "4.1",
     inputPrice: 0.2,
     outputPrice: 0.5,
     contextWindow: 131072,
@@ -1771,6 +1875,7 @@ var BLOCKRUN_MODELS = [
   {
     id: "xai/grok-4-1-fast-non-reasoning",
     name: "Grok 4.1 Fast",
+    version: "4.1",
     inputPrice: 0.2,
     outputPrice: 0.5,
     contextWindow: 131072,
@@ -1779,6 +1884,7 @@ var BLOCKRUN_MODELS = [
   {
     id: "xai/grok-code-fast-1",
     name: "Grok Code Fast",
+    version: "1",
     inputPrice: 0.2,
     outputPrice: 1.5,
     contextWindow: 131072,
@@ -1789,17 +1895,28 @@ var BLOCKRUN_MODELS = [
   {
     id: "xai/grok-4-0709",
     name: "Grok 4 (0709)",
+    version: "4-0709",
     inputPrice: 0.2,
     outputPrice: 1.5,
     contextWindow: 131072,
     maxOutput: 16384,
     reasoning: true
   },
-  // grok-2-vision removed - old, 0 transactions
+  {
+    id: "xai/grok-2-vision",
+    name: "Grok 2 Vision",
+    version: "2",
+    inputPrice: 2,
+    outputPrice: 10,
+    contextWindow: 131072,
+    maxOutput: 16384,
+    vision: true
+  },
   // MiniMax
   {
     id: "minimax/minimax-m2.5",
     name: "MiniMax M2.5",
+    version: "m2.5",
     inputPrice: 0.3,
     outputPrice: 1.2,
     contextWindow: 204800,
@@ -1811,6 +1928,7 @@ var BLOCKRUN_MODELS = [
   {
     id: "nvidia/gpt-oss-120b",
     name: "NVIDIA GPT-OSS 120B",
+    version: "120b",
     inputPrice: 0,
     outputPrice: 0,
     contextWindow: 128e3,
@@ -1819,6 +1937,7 @@ var BLOCKRUN_MODELS = [
   {
     id: "nvidia/kimi-k2.5",
     name: "NVIDIA Kimi K2.5",
+    version: "k2.5",
     inputPrice: 0.55,
     outputPrice: 2.5,
     contextWindow: 262144,
@@ -5124,6 +5243,282 @@ async function resolveOrGenerateWalletKey() {
   return { key, address, source: "generated" };
 }
 
+// src/doctor.ts
+import { platform, arch, freemem, totalmem } from "os";
+function formatBytes(bytes) {
+  const gb = bytes / (1024 * 1024 * 1024);
+  return `${gb.toFixed(1)}GB`;
+}
+function green(text) {
+  return `\x1B[32m\u2713\x1B[0m ${text}`;
+}
+function red(text) {
+  return `\x1B[31m\u2717\x1B[0m ${text}`;
+}
+function yellow(text) {
+  return `\x1B[33m\u26A0\x1B[0m ${text}`;
+}
+function collectSystemInfo() {
+  return {
+    os: `${platform()} ${arch()}`,
+    arch: arch(),
+    nodeVersion: process.version,
+    memoryFree: formatBytes(freemem()),
+    memoryTotal: formatBytes(totalmem())
+  };
+}
+async function collectWalletInfo() {
+  try {
+    const { key, address, source } = await resolveOrGenerateWalletKey();
+    if (!key || !address) {
+      return {
+        exists: false,
+        valid: false,
+        address: null,
+        balance: null,
+        isLow: false,
+        isEmpty: true,
+        source: null
+      };
+    }
+    const monitor = new BalanceMonitor(address);
+    try {
+      const balanceInfo = await monitor.checkBalance();
+      return {
+        exists: true,
+        valid: true,
+        address,
+        balance: balanceInfo.balanceUSD,
+        isLow: balanceInfo.isLow,
+        isEmpty: balanceInfo.isEmpty,
+        source
+      };
+    } catch {
+      return {
+        exists: true,
+        valid: true,
+        address,
+        balance: null,
+        isLow: false,
+        isEmpty: false,
+        source
+      };
+    }
+  } catch {
+    return {
+      exists: false,
+      valid: false,
+      address: null,
+      balance: null,
+      isLow: false,
+      isEmpty: true,
+      source: null
+    };
+  }
+}
+async function collectNetworkInfo() {
+  const port = getProxyPort();
+  let blockrunReachable = false;
+  let blockrunLatency = null;
+  try {
+    const start = Date.now();
+    const response = await fetch("https://blockrun.ai/api/v1/models", {
+      method: "GET",
+      signal: AbortSignal.timeout(1e4)
+    });
+    blockrunLatency = Date.now() - start;
+    blockrunReachable = response.ok || response.status === 402;
+  } catch {
+    blockrunReachable = false;
+  }
+  let proxyRunning = false;
+  try {
+    const response = await fetch(`http://127.0.0.1:${port}/health`, {
+      method: "GET",
+      signal: AbortSignal.timeout(3e3)
+    });
+    proxyRunning = response.ok;
+  } catch {
+    proxyRunning = false;
+  }
+  return {
+    blockrunApi: { reachable: blockrunReachable, latencyMs: blockrunLatency },
+    localProxy: { running: proxyRunning, port }
+  };
+}
+async function collectLogInfo() {
+  try {
+    const stats = await getStats(1);
+    return {
+      requestsLast24h: stats.totalRequests,
+      costLast24h: `$${stats.totalCost.toFixed(4)}`,
+      errorsFound: 0
+      // TODO: parse error logs
+    };
+  } catch {
+    return {
+      requestsLast24h: 0,
+      costLast24h: "$0.00",
+      errorsFound: 0
+    };
+  }
+}
+function identifyIssues(result) {
+  const issues = [];
+  if (!result.wallet.exists) {
+    issues.push("No wallet found");
+  }
+  if (result.wallet.isEmpty) {
+    issues.push("Wallet is empty - need to fund with USDC on Base");
+  } else if (result.wallet.isLow) {
+    issues.push("Wallet balance is low (< $1.00)");
+  }
+  if (!result.network.blockrunApi.reachable) {
+    issues.push("Cannot reach BlockRun API - check internet connection");
+  }
+  if (!result.network.localProxy.running) {
+    issues.push(`Local proxy not running on port ${result.network.localProxy.port}`);
+  }
+  return issues;
+}
+function printDiagnostics(result) {
+  console.log("\n\u{1F50D} Collecting diagnostics...\n");
+  console.log("System");
+  console.log(`  ${green(`OS: ${result.system.os}`)}`);
+  console.log(`  ${green(`Node: ${result.system.nodeVersion}`)}`);
+  console.log(`  ${green(`Memory: ${result.system.memoryFree} free / ${result.system.memoryTotal}`)}`);
+  console.log("\nWallet");
+  if (result.wallet.exists && result.wallet.valid) {
+    console.log(`  ${green(`Key: ${WALLET_FILE} (${result.wallet.source})`)}`);
+    console.log(`  ${green(`Address: ${result.wallet.address}`)}`);
+    if (result.wallet.isEmpty) {
+      console.log(`  ${red(`Balance: $0.00 - NEED TO FUND!`)}`);
+    } else if (result.wallet.isLow) {
+      console.log(`  ${yellow(`Balance: ${result.wallet.balance} (low)`)}`);
+    } else if (result.wallet.balance) {
+      console.log(`  ${green(`Balance: ${result.wallet.balance}`)}`);
+    } else {
+      console.log(`  ${yellow(`Balance: checking...`)}`);
+    }
+  } else {
+    console.log(`  ${red("No wallet found")}`);
+  }
+  console.log("\nNetwork");
+  if (result.network.blockrunApi.reachable) {
+    console.log(`  ${green(`BlockRun API: reachable (${result.network.blockrunApi.latencyMs}ms)`)}`);
+  } else {
+    console.log(`  ${red("BlockRun API: unreachable")}`);
+  }
+  if (result.network.localProxy.running) {
+    console.log(`  ${green(`Local proxy: running on :${result.network.localProxy.port}`)}`);
+  } else {
+    console.log(`  ${red(`Local proxy: not running on :${result.network.localProxy.port}`)}`);
+  }
+  console.log("\nLogs");
+  console.log(`  ${green(`Last 24h: ${result.logs.requestsLast24h} requests, ${result.logs.costLast24h} spent`)}`);
+  if (result.logs.errorsFound > 0) {
+    console.log(`  ${yellow(`${result.logs.errorsFound} errors found in logs`)}`);
+  }
+  if (result.issues.length > 0) {
+    console.log("\n\u26A0\uFE0F  Issues Found:");
+    for (const issue of result.issues) {
+      console.log(`  \u2022 ${issue}`);
+    }
+  }
+}
+async function analyzeWithAI(diagnostics, userQuestion) {
+  if (diagnostics.wallet.isEmpty) {
+    console.log("\n\u{1F4B3} Wallet is empty - cannot call AI for analysis.");
+    console.log(`   Fund your wallet with USDC on Base: ${diagnostics.wallet.address}`);
+    console.log("   Get USDC: https://www.coinbase.com/price/usd-coin");
+    console.log("   Bridge to Base: https://bridge.base.org\n");
+    return;
+  }
+  console.log("\n\u{1F4E4} Sending to Claude Opus 4.6...\n");
+  try {
+    const { key } = await resolveOrGenerateWalletKey();
+    const { fetch: paymentFetch } = createPaymentFetch(key);
+    const response = await paymentFetch(
+      "https://blockrun.ai/api/v1/chat/completions",
+      {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          model: "anthropic/claude-opus-4.6",
+          stream: false,
+          messages: [
+            {
+              role: "system",
+              content: `You are a technical support expert for BlockRun and ClawRouter.
+Analyze the diagnostics and:
+1. Identify the root cause of any issues
+2. Provide specific, actionable fix commands (bash)
+3. Explain why the issue occurred briefly
+4. Be concise but thorough
+5. Format commands in code blocks`
+            },
+            {
+              role: "user",
+              content: userQuestion ? `Here are my system diagnostics:
+
+${JSON.stringify(diagnostics, null, 2)}
+
+User's question: ${userQuestion}` : `Here are my system diagnostics:
+
+${JSON.stringify(diagnostics, null, 2)}
+
+Please analyze and help me fix any issues.`
+            }
+          ],
+          max_tokens: 1e3
+        })
+      },
+      void 0
+    );
+    if (!response.ok) {
+      const text = await response.text();
+      console.log(`Error: ${response.status} - ${text}`);
+      return;
+    }
+    const data = await response.json();
+    const content = data.choices?.[0]?.message?.content;
+    if (content) {
+      console.log("\u{1F916} AI Analysis:\n");
+      console.log(content);
+      console.log();
+    } else {
+      console.log("Error: No response from AI");
+    }
+  } catch (err) {
+    console.log(`
+Error calling AI: ${err instanceof Error ? err.message : String(err)}`);
+    console.log("Try again or check your wallet balance.\n");
+  }
+}
+async function runDoctor(userQuestion) {
+  console.log(`
+\u{1FA7A} BlockRun Doctor v${VERSION}
+`);
+  const [system, wallet, network, logs] = await Promise.all([
+    collectSystemInfo(),
+    collectWalletInfo(),
+    collectNetworkInfo(),
+    collectLogInfo()
+  ]);
+  const result = {
+    version: VERSION,
+    timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+    system,
+    wallet,
+    network,
+    logs,
+    issues: []
+  };
+  result.issues = identifyIssues(result);
+  printDiagnostics(result);
+  await analyzeWithAI(result, userQuestion);
+}
+
 // src/cli.ts
 function printHelp() {
   console.log(`
@@ -5131,12 +5526,17 @@ ClawRouter v${VERSION} - Smart LLM Router
 
 Usage:
   clawrouter [options]
+  clawrouter doctor         Run AI-powered diagnostics
 
 Options:
   --version, -v     Show version number
   --help, -h        Show this help message
   --port <number>   Port to listen on (default: ${getProxyPort()})
 
+Commands:
+  doctor [question] Diagnose issues and get AI-powered fix suggestions
+                    Optional: Add your question for targeted help
+
 Examples:
   # Start standalone proxy (survives gateway restarts)
   npx @blockrun/clawrouter
@@ -5144,6 +5544,12 @@ Examples:
   # Start on custom port
   npx @blockrun/clawrouter --port 9000
 
+  # Run diagnostics when something isn't working
+  npx @blockrun/clawrouter doctor
+
+  # Ask a specific question
+  npx @blockrun/clawrouter doctor "why is my request failing?"
+
   # Production deployment with PM2
   pm2 start "npx @blockrun/clawrouter" --name clawrouter
 
@@ -5155,13 +5561,15 @@ For more info: https://github.com/BlockRunAI/ClawRouter
 `);
 }
 function parseArgs(args) {
-  const result = { version: false, help: false, port: void 0 };
+  const result = { version: false, help: false, doctor: false, port: void 0 };
   for (let i = 0; i < args.length; i++) {
     const arg = args[i];
     if (arg === "--version" || arg === "-v") {
       result.version = true;
     } else if (arg === "--help" || arg === "-h") {
       result.help = true;
+    } else if (arg === "doctor" || arg === "--doctor") {
+      result.doctor = true;
     } else if (arg === "--port" && args[i + 1]) {
       result.port = parseInt(args[i + 1], 10);
       i++;
@@ -5179,6 +5587,13 @@ async function main() {
     printHelp();
     process.exit(0);
   }
+  if (args.doctor) {
+    const rawArgs = process.argv.slice(2);
+    const doctorIndex = rawArgs.findIndex((a) => a === "doctor" || a === "--doctor");
+    const userQuestion = rawArgs.slice(doctorIndex + 1).join(" ").trim() || void 0;
+    await runDoctor(userQuestion);
+    process.exit(0);
+  }
   const { key: walletKey, address, source } = await resolveOrGenerateWalletKey();
   if (source === "generated") {
     console.log(`[ClawRouter] Generated new wallet: ${address}`);