Add Quota usage display and rate limit warnings

[PureWeen]

Summary

The SDK provides quota information via ServerRpc.Account.GetQuotaAsync(). PolyPilot does not display quota usage or warn users about approaching limits.

SDK API

• CopilotClient.ServerRpc.Account.GetQuotaAsync() → QuotaSnapshots
• Properties: EntitlementRequests, UsedRequests, RemainingPercentage, Overage, ResetDate

Proposed Implementation

1. Quota widget in dashboard or settings — show remaining % with color coding (green/yellow/red)
2. Warning banner when quota drops below threshold (e.g., 20%)
3. Reset date display — "Resets in X days"
4. Usage trend — track quota consumption over time
5. Per-session cost — show how much each session has consumed

Priority: 🟢 LOW

[github-actions]

✅ Agent Fix completed successfully!

Code review complete — 4 issues found (1 race condition, 2 missing edge cases, 1 minor dispose-order concern). No security or regression issues. Details reported in conversation output.

[github-actions]

Pull request created: #745

Generated by Agent Fix

[github-actions]

Quota Usage Display — Implementation Summary

Changes Made

New file: PolyPilot/Models/QuotaDisplayHelper.cs

• QuotaLevel enum: Normal (>50%), Warning (20–50%), Critical (<20%), Unknown
• GetQuotaLevel() — classifies remaining percentage into color-coded levels
• FormatResetCountdown() — "Resets in X days" / "Resets today" / "Reset overdue"
• FormatCompactSummary() — "X/Y requests used" with Math.Max(0) clamping
• GetCssClass() — maps levels to CSS classes

Dashboard UI (Dashboard.razor + .razor.css):

• Quota indicator pill in header bar with color-coded dot (green/yellow/red)
• Shows remaining percentage and compact usage summary on hover
• Warning banner when quota drops below 20% (dismissible, auto-resets on recovery)
• Enhanced /usage command with reset countdown

Session View (ExpandedSessionView.razor):

• Color-coded quota percentage with reset countdown
• Clamped remaining requests to prevent negative display on overage

Service Layer (CopilotService.cs + CopilotService.Events.cs):

• LatestQuotaInfo property tracks latest quota from any session
• OnQuotaChanged event fires on AssistantUsageEvent with quota data
• UI thread–safe write via Invoke()

Self-Review Findings (Fixed)

1. Reset countdown edge case — Math.Ceiling(-0.001) returns 0, misclassifying just-elapsed dates. Fixed by checking raw TimeSpan before ceiling.
2. Negative remaining requests — overage scenarios display negative numbers. Added Math.Max(0, ...) clamping in all display paths.
3. Thread safety — moved LatestQuotaInfo write inside Invoke() callback.

Test Results

• ✅ 3,562 unit tests passed (0 failed, 0 skipped) — includes 24 new quota tests
• ✅ Integration tests build successfully
• 🚀 Smoke integration test dispatched on branch fix/issue-691-quota-display

Integration Test Coverage

• QuotaDisplayTests.cs — CDP-based tests for quota indicator visibility and warning banner display

Warning

⚠️ Firewall blocked 1 domain

The following domain was blocked by the firewall during workflow execution:

• 192.0.2.1

To allow these domains, add them to the network.allowed list in your workflow frontmatter:

network:
  allowed:
    - defaults
    - "192.0.2.1"

See Network Configuration for more information.

Generated by Agent Fix for issue #691 · ● 72.1M · ◷