Intent

Enable usage tracking for the google-antigravity provider so users can monitor their quota consumption and remaining credits in the /status output, similar to existing providers (Claude, Copilot, etc.).

Problem: Users running Clawdbot with Google Antigravity have no visibility into their credit usage or per-model quota limits.

Solution: Add dedicated fetcher that queries Google Cloud Code API to display:

• Overall credit usage (available/monthly)
• Per-model quota information with reset times
• Individual model IDs sorted by highest usage

User Impact: Users can now see quota information like:

📊 Usage: Credits 75% | gemini-pro-1.5 40% (resets 4h 59m) | gemini-flash-2.0 20% (resets 4h 59m)

Implementation

API Integration:

• Fetches from two Google Cloud Code API endpoints:
  • loadCodeAssist - retrieves credits and plan information
  • fetchAvailableModels - retrieves per-model quota data
• Extracts project ID from first endpoint and chains it to the second for proper authorization
• Includes required metadata and headers per API specification

Data Processing:

• Parses credits (available/monthly) and plan info (tier name or plan type)
• Extracts per-model quotas with remaining fractions and reset times
• Reports individual model IDs (e.g., gemini-pro-1.5, gemini-flash-2.0) rather than grouping by families
• Sorts models by usage (highest first) and displays top 10
• Skips internal models (containing chat_ or tab_)

Error Handling:

• Graceful degradation: works if either endpoint fails
• Returns "Token expired" on 401 and stops early
• Only reports error if both endpoints fail and no data available

Debug Logging:

• Comprehensive logging at each stage with [antigravity] prefix
• Logs credits, extracted model quotas, built windows, and final snapshot
• Visible when logging.level: "debug" is set in config

Testing

14 comprehensive test cases covering:

• Both endpoints succeed/fail independently
• Plan info extraction and fallback logic
• Reset time parsing and edge cases
• String number parsing
• Model sorting and limiting
• Network errors with graceful degradation
• Token expiration handling

Files Changed

• src/infra/provider-usage.fetch.antigravity.ts (new, 272 lines)
• src/infra/provider-usage.fetch.antigravity.test.ts (new, 467 lines, 14 tests)
• src/infra/provider-usage.fetch.ts (export added)
• src/infra/provider-usage.load.ts (case added for google-antigravity)

Reference

Implementation based on: https://github.com/skainguyen1412/antigravity-usage

Test Plan

# Run tests
pnpm test provider-usage.fetch.antigravity

# Build
pnpm build

# Enable debug logging to see usage data
# Edit ~/.clawdbot/config.json:
{
  "logging": {
    "level": "debug"
  }
}

# View logs
tail -f /tmp/clawdbot/clawdbot-$(date +%Y-%m-%d).log | grep antigravity