/status: show usage fetch errors instead of silently hiding

felixclack · felixclack · commit f7249fb69407 · 2026-03-26T01:34:49.000Z
Improves UX by showing why usage info is missing.
- Display provider API errors (e.g., timeout, auth failure)
- Show structured errors from usage summary responses
- Users no longer left wondering if usage tracking is broken
- Better debugging signal for rate-limit/API issues
diff --git a/src/auto-reply/reply/commands-status.ts b/src/auto-reply/reply/commands-status.ts
@@ -94,7 +94,9 @@ export async function buildStatusReply(params: {
         agentDir: statusAgentDir,
       });
       const usageEntry = usageSummary.providers[0];
-      if (usageEntry && !usageEntry.error && usageEntry.windows.length > 0) {
+      if (usageEntry && usageEntry.error) {
+        usageLine = `📊 Usage: (unavailable: ${usageEntry.error})`;
+      } else if (usageEntry && usageEntry.windows.length > 0) {
         const summaryLine = formatUsageWindowSummary(usageEntry, {
           now: Date.now(),
           maxWindows: 2,
@@ -104,8 +106,9 @@ export async function buildStatusReply(params: {
           usageLine = `📊 Usage: ${summaryLine}`;
         }
       }
-    } catch {
-      usageLine = null;
+    } catch (err) {
+      const errorMessage = err instanceof Error ? err.message : "unknown error";
+      usageLine = `📊 Usage: (error: ${errorMessage})`;
     }
   }
   const queueSettings = resolveQueueSettings({

Original file line number	Diff line number	Diff line change
`@@ -94,7 +94,9 @@ export async function buildStatusReply(params: {`
`94`	`94`	`agentDir: statusAgentDir,`
`95`	`95`	`});`
`96`	`96`	`const usageEntry = usageSummary.providers[0];`
`97`		`- if (usageEntry && !usageEntry.error && usageEntry.windows.length > 0) {`
	`97`	`+ if (usageEntry && usageEntry.error) {`
	`98`	+ usageLine = `📊 Usage: (unavailable: ${usageEntry.error})`;
	`99`	`+ } else if (usageEntry && usageEntry.windows.length > 0) {`
`98`	`100`	`const summaryLine = formatUsageWindowSummary(usageEntry, {`
`99`	`101`	`now: Date.now(),`
`100`	`102`	`maxWindows: 2,`
`@@ -104,8 +106,9 @@ export async function buildStatusReply(params: {`
`104`	`106`	usageLine = `📊 Usage: ${summaryLine}`;
`105`	`107`	`}`
`106`	`108`	`}`
`107`		`- } catch {`
`108`		`- usageLine = null;`
	`109`	`+ } catch (err) {`
	`110`	`+ const errorMessage = err instanceof Error ? err.message : "unknown error";`
	`111`	+ usageLine = `📊 Usage: (error: ${errorMessage})`;
`109`	`112`	`}`
`110`	`113`	`}`
`111`	`114`	`const queueSettings = resolveQueueSettings({`