feat(usage): surface overages, time window, chain/network, and request counts

- 'usage summary' gains overages plus start_time/end_time rows so the
  numbers carry their window; unix seconds render as RFC-3339 via a new
  ParsedTime::from_unix, matching what --from/--to accept.
- 'usage by-method' gains CHAIN and NETWORK columns (a method name alone
  is ambiguous on multi-chain accounts) and renders ARCHIVE with the
  standard boolean cell.
- 'usage by-tag' gains the REQUESTS count.

Author: johnpmitsch

src/commands/usage.rs

@@ -7,7 +7,7 @@ use serde::Serialize;
 
 use crate::context::Ctx;
 use crate::errors::CliError;
-use crate::output::{new_table, opt_cell, set_header_bold, write_table, Render};
+use crate::output::{bool_cell, new_table, opt_cell, set_header_bold, write_table, Render};
 use crate::retry::retrying;
 use crate::time_arg;
 
@@ -128,6 +128,16 @@ impl Render for UsageSummaryView {
             opt_cell(&data.credits_remaining),
         ]);
         t.add_row(vec![Cell::new("limit"), opt_cell(&data.limit)]);
+        t.add_row(vec![Cell::new("overages"), opt_cell(&data.overages)]);
+        // The API reports the window as unix seconds; show RFC-3339 like the
+        // --from/--to flags accept. Out-of-range values fall back to the raw
+        // number rather than erroring a read-only command.
+        let time_cell = |ts: i64| match time_arg::ParsedTime::from_unix(ts) {
+            Some(t) => Cell::new(t.to_rfc3339()),
+            None => Cell::new(ts),
+        };
+        t.add_row(vec![Cell::new("start_time"), time_cell(data.start_time)]);
+        t.add_row(vec![Cell::new("end_time"), time_cell(data.end_time)]);
         write_table(w, &t)
     }
 }
@@ -179,12 +189,18 @@ impl Render for UsageByMethodView {
             }
         };
         let mut t = new_table(ctx);
-        set_header_bold(&mut t, ctx, vec!["METHOD", "CREDITS", "ARCHIVE"]);
+        set_header_bold(
+            &mut t,
+            ctx,
+            vec!["METHOD", "CHAIN", "NETWORK", "CREDITS", "ARCHIVE"],
+        );
         for m in &data.methods {
             t.add_row(vec![
                 Cell::new(&m.method_name),
+                opt_cell(&m.chain),
+                opt_cell(&m.network),
                 Cell::new(m.credits_used),
-                opt_cell(&m.archive),
+                bool_cell(m.archive),
             ]);
         }
         write_table(w, &t)
@@ -233,12 +249,13 @@ impl Render for UsageByTagView {
             }
         };
         let mut t = new_table(ctx);
-        set_header_bold(&mut t, ctx, vec!["TAG_ID", "LABEL", "CREDITS"]);
+        set_header_bold(&mut t, ctx, vec!["TAG_ID", "LABEL", "CREDITS", "REQUESTS"]);
         for tg in &data.tags {
             t.add_row(vec![
                 opt_cell(&tg.tag_id),
                 Cell::new(&tg.label),
                 Cell::new(tg.credits_used),
+                Cell::new(tg.requests),
             ]);
         }
         write_table(w, &t)

src/time_arg.rs

@@ -28,6 +28,11 @@ impl ParsedTime {
         self.0.unix_timestamp()
     }
 
+    /// Builds from unix seconds; `None` if out of `OffsetDateTime` range.
+    pub fn from_unix(ts: i64) -> Option<Self> {
+        OffsetDateTime::from_unix_timestamp(ts).ok().map(Self)
+    }
+
     pub fn to_rfc3339(self) -> String {
         self.0
             .format(&Rfc3339)

tests/snapshots/table_snapshots__usage_by_method_table_includes_chain_and_network.snap

@@ -0,0 +1,7 @@
+---
+source: tests/table_snapshots.rs
+expression: out
+---
+METHOD          CHAIN   NETWORK  CREDITS  ARCHIVE  
+eth_call        eth     mainnet  900      ✗        
+getBlockHeight  solana  mainnet  300      —

tests/snapshots/table_snapshots__usage_by_tag_table_includes_requests.snap

@@ -0,0 +1,7 @@
+---
+source: tests/table_snapshots.rs
+expression: out
+---
+TAG_ID  LABEL     CREDITS  REQUESTS  
+1       prod      1000     420       
+—       untagged  200      80

tests/snapshots/table_snapshots__usage_summary_table_shows_overages_and_window.snap

@@ -0,0 +1,11 @@
+---
+source: tests/table_snapshots.rs
+expression: out
+---
+FIELD              VALUE                 
+credits_used       1200                  
+credits_remaining  8800                  
+limit              10000                 
+overages           0                     
+start_time         2026-01-01T00:00:00Z  
+end_time           2026-02-01T00:00:00Z

tests/table_snapshots.rs

@@ -288,6 +288,65 @@ async fn billing_payments_table_includes_status_and_marketplace() {
     insta::assert_snapshot!(out);
 }
 
+#[tokio::test]
+async fn usage_summary_table_shows_overages_and_window() {
+    let body = serde_json::json!({
+        "data": {
+            "credits_used": 1200,
+            "credits_remaining": 8800,
+            "limit": 10000,
+            "overages": 0,
+            "start_time": 1767225600,
+            "end_time": 1769904000
+        },
+        "error": null
+    });
+    let out = table_stdout("/v0/usage/rpc", body, &["usage", "summary"]).await;
+    insta::assert_snapshot!(out);
+}
+
+#[tokio::test]
+async fn usage_by_method_table_includes_chain_and_network() {
+    let body = serde_json::json!({
+        "data": {
+            "methods": [
+                {
+                    "method_name": "eth_call",
+                    "credits_used": 900,
+                    "archive": false,
+                    "network": "mainnet",
+                    "chain": "eth"
+                },
+                {
+                    "method_name": "getBlockHeight",
+                    "credits_used": 300,
+                    "archive": null,
+                    "network": "mainnet",
+                    "chain": "solana"
+                }
+            ]
+        },
+        "error": null
+    });
+    let out = table_stdout("/v0/usage/rpc/by-method", body, &["usage", "by-method"]).await;
+    insta::assert_snapshot!(out);
+}
+
+#[tokio::test]
+async fn usage_by_tag_table_includes_requests() {
+    let body = serde_json::json!({
+        "data": {
+            "tags": [
+                { "tag_id": 1, "label": "prod", "credits_used": 1000, "requests": 420 },
+                { "tag_id": null, "label": "untagged", "credits_used": 200, "requests": 80 }
+            ]
+        },
+        "error": null
+    });
+    let out = table_stdout("/v0/usage/rpc/by-tag", body, &["usage", "by-tag"]).await;
+    insta::assert_snapshot!(out);
+}
+
 #[tokio::test]
 async fn endpoint_show_minimal_table_omits_security_and_rate_limit_rows() {
     let body = serde_json::json!({