10049b8062
Usage frames carry optional usage.account {harness, source, plan, as_of,
windows[{id,label,used_percent,resets_at}], unsupported}. Claude Code quota
comes from its rate_limit_event stream lines and the initialize account
(plan), shared across chats on the same account. Codex reads
account/rateLimits/read once per connection (re-read when a chat opens after
5 min) and merges account/rateLimits/updated. OpenCode exposes no quota API
and says so. The app's chat info sheet shows an Account usage section with a
progress bar and reset countdown per window, Material and Cupertino.
131 lines
4.0 KiB
Dart
131 lines
4.0 KiB
Dart
/// The harness account's subscription quota, as carried by a usage frame's
|
||
/// `usage.account` (see docs/cli.md). Only reported values are kept: a window
|
||
/// without a usable percentage is dropped and nothing is estimated.
|
||
library;
|
||
|
||
/// One rolling quota window, e.g. "5-hour" or "Weekly".
|
||
class ChatQuotaWindow {
|
||
const ChatQuotaWindow({
|
||
required this.id,
|
||
required this.label,
|
||
required this.usedPercent,
|
||
required this.resetsAt,
|
||
});
|
||
|
||
final String id;
|
||
final String label;
|
||
|
||
/// 0–100; a harness may report more than 100 past a cap.
|
||
final double usedPercent;
|
||
|
||
/// Epoch milliseconds, 0 when the harness did not say.
|
||
final int resetsAt;
|
||
}
|
||
|
||
class ChatAccountUsage {
|
||
const ChatAccountUsage({
|
||
required this.harness,
|
||
required this.plan,
|
||
required this.asOf,
|
||
required this.windows,
|
||
required this.unsupported,
|
||
});
|
||
|
||
/// Display name of the harness ("Claude Code", "Codex", "OpenCode").
|
||
final String harness;
|
||
final String plan;
|
||
|
||
/// Epoch milliseconds when the server received the report, 0 if unknown.
|
||
final int asOf;
|
||
final List<ChatQuotaWindow> windows;
|
||
|
||
/// The harness exposes no quota at all.
|
||
final bool unsupported;
|
||
}
|
||
|
||
int _millis(Object? value) =>
|
||
value is num && value.isFinite && value > 0 ? value.toInt() : 0;
|
||
|
||
/// Parses `usage.account`, or null when it reports nothing usable.
|
||
ChatAccountUsage? chatAccountUsage(Object? value) {
|
||
if (value is! Map) return null;
|
||
final harness = '${value['harness'] ?? ''}'.trim();
|
||
if (value['unsupported'] == true) {
|
||
return ChatAccountUsage(
|
||
harness: harness.isEmpty ? 'the harness' : harness,
|
||
plan: '',
|
||
asOf: 0,
|
||
windows: const [],
|
||
unsupported: true,
|
||
);
|
||
}
|
||
final windows = <ChatQuotaWindow>[];
|
||
final raw = value['windows'];
|
||
if (raw is List) {
|
||
for (final entry in raw) {
|
||
if (entry is! Map) continue;
|
||
final percent = entry['used_percent'];
|
||
final label = '${entry['label'] ?? ''}'.trim();
|
||
if (percent is! num || !percent.isFinite || percent < 0) continue;
|
||
if (label.isEmpty) continue;
|
||
windows.add(
|
||
ChatQuotaWindow(
|
||
id: '${entry['id'] ?? label}',
|
||
label: label,
|
||
usedPercent: percent.toDouble(),
|
||
resetsAt: _millis(entry['resets_at']),
|
||
),
|
||
);
|
||
}
|
||
}
|
||
if (windows.isEmpty) return null;
|
||
return ChatAccountUsage(
|
||
harness: harness,
|
||
plan: '${value['plan'] ?? ''}'.trim(),
|
||
asOf: _millis(value['as_of']),
|
||
windows: List.unmodifiable(windows),
|
||
unsupported: false,
|
||
);
|
||
}
|
||
|
||
/// "42% used · resets in 2h 14m". The percentage is rounded, never clamped.
|
||
String chatQuotaSummary(ChatQuotaWindow window, DateTime now) {
|
||
final used = '${window.usedPercent.round()}% used';
|
||
if (window.resetsAt <= 0) return used;
|
||
final left = DateTime.fromMillisecondsSinceEpoch(
|
||
window.resetsAt,
|
||
).difference(now);
|
||
if (left.isNegative) return '$used · reset since this report';
|
||
return '$used · resets in ${_countdown(left)}';
|
||
}
|
||
|
||
String _countdown(Duration left) {
|
||
if (left.inMinutes < 1) return 'under a minute';
|
||
final days = left.inDays;
|
||
final hours = left.inHours % 24;
|
||
final minutes = left.inMinutes % 60;
|
||
if (days > 0) return hours > 0 ? '${days}d ${hours}h' : '${days}d';
|
||
if (left.inHours > 0) {
|
||
return minutes > 0 ? '${left.inHours}h ${minutes}m' : '${left.inHours}h';
|
||
}
|
||
return '${minutes}m';
|
||
}
|
||
|
||
/// "as of 5 min ago"; empty when the report time is unknown.
|
||
String chatQuotaAsOf(int asOf, DateTime now) {
|
||
if (asOf <= 0) return '';
|
||
final age = now.difference(DateTime.fromMillisecondsSinceEpoch(asOf));
|
||
if (age.inMinutes < 1) return 'as of just now';
|
||
if (age.inHours < 1) return 'as of ${age.inMinutes} min ago';
|
||
if (age.inDays < 1) return 'as of ${age.inHours} h ago';
|
||
return 'as of ${age.inDays} d ago';
|
||
}
|
||
|
||
/// A native plan id as a label: "max" -> "Max", "self_serve_business" ->
|
||
/// "Self serve business".
|
||
String chatPlanLabel(String plan) {
|
||
final words = plan.replaceAll('_', ' ').trim();
|
||
if (words.isEmpty) return '';
|
||
return words[0].toUpperCase() + words.substring(1);
|
||
}
|