usage-cli 0.30.23__tar.gz → 0.31.0__tar.gz

{usage_cli-0.30.23/usage_cli.egg-info → usage_cli-0.31.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: usage-cli
-Version: 0.30.23
+Version: 0.31.0
 Summary: usage — 在 macOS menu bar 與 Windows 系統匣顯示 Claude Code、Codex、Antigravity 用量的小工具（也提供終端機 TUI）
 License-Expression: AGPL-3.0-only
 Requires-Python: >=3.13
@@ -87,7 +87,7 @@ It lands in your Applications folder automatically. Open it once; if macOS 15 or
 
 ### Experience & Customization
 
-- **14 Visual Themes:** Switch between panel styles including Default, Matrix, Windows 95, Vintage Newspaper, Cloud Observation, Midnight Aquarium, Prism Arcade, Black Hole, World Cup 2026, Lepidoptera, Migration, Stained Glass, Origami, and Catppuccin (official palette, all four flavors).
+- **15 Visual Themes:** Switch between panel styles including Default, Matrix, Windows 95, Vintage Newspaper, Cloud Observation, Midnight Aquarium, Prism Arcade, Black Hole, World Cup 2026, Lepidoptera, Migration, Stained Glass, Origami, Sketchbook, and Catppuccin (official palette, all four flavors).
 - **Place the Panel Anywhere:** The panel is no longer pinned under the menu bar icon. Drag it from any empty spot to wherever you want it, and it reopens there next time. It stays put when another app takes focus — a second click on the menu bar icon, or Escape, closes it.
 - **Drag to Reorder:** Grab any quota card and drag it up or down to swap the order — the arrangement is shared across every theme with quota cards (all except World Cup 2026) and survives restarts.
 - **Automatic Localization:** UI text is available in Traditional Chinese, Simplified Chinese, English, Japanese, and Korean, automatically matching your system settings.
@@ -147,7 +147,7 @@ Once set up, the bottom of the Claude Code window will show a status line like t
 
 Windows has the full core experience: the system-tray UI, Claude Code status-line hook, and Codex history parsing all work natively. Download `usage-windows.zip` from the [latest GitHub Release](https://github.com/aqua5230/usage/releases/latest), unzip it, then run `usage.exe`—no installer is needed. If SmartScreen shows **Windows protected your PC** on first launch, click **More info** → **Run anyway**. The tray UI requires Microsoft Edge WebView2 Runtime, which is normally included with Windows 10 and 11.
 
-The system-tray icon updates with your Claude quota percentage; its tooltip summarizes the Claude and Codex windows. Left-click opens the same 14 quota themes available on macOS (Default plus the other thirteen) in WebView2. Right-click provides Reset Panel Position and Quit; panel switching, refresh, launch at login, and update checks are in the panel menu.
+The system-tray icon updates with your Claude quota percentage; its tooltip summarizes the Claude and Codex windows. Left-click opens the same 15 quota themes available on macOS (Default plus the other fourteen) in WebView2. Right-click provides Reset Panel Position and Quit; panel switching, refresh, launch at login, and update checks are in the panel menu.
 
 Windows differences: the panel opens at the bottom-right of the working area rather than next to the tray icon; update prompts use a system Yes/No dialog.
 
@@ -164,7 +164,7 @@ Privacy policy: this program will not transfer any information to other networke
 
 ## Theme Gallery
 
-Switch between **14 visual themes** directly from the UI:
+Switch between **15 visual themes** directly from the UI:
 
 <p align="center">
   <img src="docs/classic.en.png" width="32%" alt="Classic theme" />

{usage_cli-0.30.23 → usage_cli-0.31.0}/README.md

@@ -67,7 +67,7 @@ It lands in your Applications folder automatically. Open it once; if macOS 15 or
 
 ### Experience & Customization
 
-- **14 Visual Themes:** Switch between panel styles including Default, Matrix, Windows 95, Vintage Newspaper, Cloud Observation, Midnight Aquarium, Prism Arcade, Black Hole, World Cup 2026, Lepidoptera, Migration, Stained Glass, Origami, and Catppuccin (official palette, all four flavors).
+- **15 Visual Themes:** Switch between panel styles including Default, Matrix, Windows 95, Vintage Newspaper, Cloud Observation, Midnight Aquarium, Prism Arcade, Black Hole, World Cup 2026, Lepidoptera, Migration, Stained Glass, Origami, Sketchbook, and Catppuccin (official palette, all four flavors).
 - **Place the Panel Anywhere:** The panel is no longer pinned under the menu bar icon. Drag it from any empty spot to wherever you want it, and it reopens there next time. It stays put when another app takes focus — a second click on the menu bar icon, or Escape, closes it.
 - **Drag to Reorder:** Grab any quota card and drag it up or down to swap the order — the arrangement is shared across every theme with quota cards (all except World Cup 2026) and survives restarts.
 - **Automatic Localization:** UI text is available in Traditional Chinese, Simplified Chinese, English, Japanese, and Korean, automatically matching your system settings.
@@ -127,7 +127,7 @@ Once set up, the bottom of the Claude Code window will show a status line like t
 
 Windows has the full core experience: the system-tray UI, Claude Code status-line hook, and Codex history parsing all work natively. Download `usage-windows.zip` from the [latest GitHub Release](https://github.com/aqua5230/usage/releases/latest), unzip it, then run `usage.exe`—no installer is needed. If SmartScreen shows **Windows protected your PC** on first launch, click **More info** → **Run anyway**. The tray UI requires Microsoft Edge WebView2 Runtime, which is normally included with Windows 10 and 11.
 
-The system-tray icon updates with your Claude quota percentage; its tooltip summarizes the Claude and Codex windows. Left-click opens the same 14 quota themes available on macOS (Default plus the other thirteen) in WebView2. Right-click provides Reset Panel Position and Quit; panel switching, refresh, launch at login, and update checks are in the panel menu.
+The system-tray icon updates with your Claude quota percentage; its tooltip summarizes the Claude and Codex windows. Left-click opens the same 15 quota themes available on macOS (Default plus the other fourteen) in WebView2. Right-click provides Reset Panel Position and Quit; panel switching, refresh, launch at login, and update checks are in the panel menu.
 
 Windows differences: the panel opens at the bottom-right of the working area rather than next to the tray icon; update prompts use a system Yes/No dialog.
 
@@ -144,7 +144,7 @@ Privacy policy: this program will not transfer any information to other networke
 
 ## Theme Gallery
 
-Switch between **14 visual themes** directly from the UI:
+Switch between **15 visual themes** directly from the UI:
 
 <p align="center">
   <img src="docs/classic.en.png" width="32%" alt="Classic theme" />

{usage_cli-0.30.23 → usage_cli-0.31.0}/analyzer/aggregator.py

@@ -122,6 +122,7 @@ def aggregate_sessions(entries: list[UsageEntry]) -> list[SessionStats]:
             start_time=first.timestamp,
             end_time=last.timestamp,
             duration_minutes=round(duration, 1),
+            agent_id=first.agent_id,
         )
         for e in session_entries:
             cost = calculate_cost(e)

usage_cli-0.31.0/analyzer/dispatch_ledger.py

@@ -0,0 +1,451 @@
+# SPDX-License-Identifier: AGPL-3.0-only
+# Copyright (C) 2026 lollapalooza <https://github.com/aqua5230>
+
+"""Local dispatch matching and subscription quota estimates for HTML reports."""
+
+from __future__ import annotations
+
+from collections import defaultdict
+from dataclasses import dataclass
+from datetime import UTC, datetime, timedelta
+import json
+from pathlib import Path
+import re
+import sqlite3
+from typing import Any, TypedDict
+
+from adapters import rate_limits
+from adapters.types import UsageEntry
+from loaders import agy_loader, agy_quota_probe, codex_loader
+from loaders.claude_paths import claude_config_dirs
+
+_DISPATCH = {
+    "codex": re.compile(r"(^|[;&|(\s])codex exec"),
+    "antigravity": re.compile(r"(^|[;&|(\s])agy -p"),
+}
+_UUID = re.compile(r"\b[0-9a-fA-F]{8}(?:-[0-9a-fA-F]{4}){3}-[0-9a-fA-F]{12}\b")
+_CWD = re.compile(rb'"Cwd":"((?:[^"\\]|\\.)*)"')
+_file_cache: dict[tuple[Path, int, float], list[Dispatch]] = {}
+_codex_cache: dict[Path, tuple[tuple[int, float], Candidate | None]] = {}
+
+
+@dataclass(frozen=True)
+class Dispatch:
+    timestamp: datetime
+    session_id: str
+    cwd: str
+    command: str
+    agent_id: str
+
+
+@dataclass(frozen=True)
+class Candidate:
+    agent_id: str
+    session_id: str
+    timestamp: datetime
+    cwd: str
+    first_message: str = ""
+
+
+@dataclass(frozen=True)
+class QuotaWindow:
+    used_pct: float
+    resets_at: datetime
+    length: timedelta
+
+
+class LedgerRow(TypedDict):
+    date: str
+    project: str
+    title: str
+    dispatch_count: int
+    claude_pct: float | None
+    codex_pct: float | None
+    agy_pct: float | None
+    total_pct: float
+
+
+class LedgerData(TypedDict):
+    rows: list[LedgerRow]
+    unowned_codex: int
+    unowned_agy: int
+
+
+def _timestamp(value: object) -> datetime | None:
+    try:
+        if isinstance(value, (float, int)) and not isinstance(value, bool):
+            return datetime.fromtimestamp(value, UTC)
+        if isinstance(value, str):
+            parsed = datetime.fromisoformat(value.replace("Z", "+00:00"))
+            return parsed.replace(tzinfo=UTC) if parsed.tzinfo is None else parsed.astimezone(UTC)
+    except (ValueError, OverflowError):
+        pass
+    return None
+
+
+def _dict(value: object) -> dict[str, Any]:
+    return value if isinstance(value, dict) else {}
+
+
+def _claude_paths(cutoff: datetime) -> list[Path]:
+    paths: list[Path] = []
+    for root in claude_config_dirs():
+        for path in (root / "projects").glob("*/*.jsonl"):
+            try:
+                if path.stat().st_mtime >= cutoff.timestamp():
+                    paths.append(path)
+            except OSError:
+                continue
+    return paths
+
+
+def _read_dispatches(path: Path) -> list[Dispatch]:
+    try:
+        stat = path.stat()
+        key = (path, stat.st_size, stat.st_mtime)
+        cached = _file_cache.get(key)
+        if cached is not None:
+            return cached
+        found: list[Dispatch] = []
+        with path.open(encoding="utf-8", errors="replace") as stream:
+            for line in stream:
+                if "codex exec" not in line and "agy -p" not in line:
+                    continue
+                try:
+                    record = _dict(json.loads(line))
+                except json.JSONDecodeError:
+                    continue
+                timestamp = _timestamp(record.get("timestamp"))
+                if timestamp is None:
+                    continue
+                message = _dict(record.get("message"))
+                blocks = message.get("content")
+                if not isinstance(blocks, list):
+                    blocks = [record]
+                for block in blocks:
+                    item = _dict(block)
+                    if item.get("type") != "tool_use" or item.get("name") != "Bash":
+                        continue
+                    command = _dict(item.get("input")).get("command")
+                    if not isinstance(command, str):
+                        continue
+                    for agent_id, pattern in _DISPATCH.items():
+                        for _ in pattern.finditer(command):
+                            found.append(
+                                Dispatch(
+                                    timestamp,
+                                    path.stem,
+                                    str(record.get("cwd") or ""),
+                                    command,
+                                    agent_id,
+                                )
+                            )
+        for old_key in tuple(_file_cache):
+            if old_key[0] == path and old_key != key:
+                del _file_cache[old_key]
+        _file_cache[key] = found
+        return found
+    except OSError:
+        return []
+
+
+def _read_codex_candidate(path: Path) -> Candidate | None:
+    try:
+        stat = path.stat()
+        signature = (stat.st_size, stat.st_mtime)
+        cached = _codex_cache.get(path)
+        if cached is not None and cached[0] == signature:
+            return cached[1]
+        candidate = None
+        with path.open(encoding="utf-8", errors="replace") as stream:
+            first = _dict(json.loads(next(stream)))
+            meta = _dict(first.get("payload"))
+            started = _timestamp(first.get("timestamp"))
+            if (
+                first.get("type") == "session_meta"
+                and meta.get("originator") == "codex_exec"
+                and started is not None
+            ):
+                message = ""
+                for line in stream:
+                    if '"user_message"' not in line:
+                        continue
+                    try:
+                        payload = _dict(_dict(json.loads(line)).get("payload"))
+                    except json.JSONDecodeError:
+                        continue
+                    if payload.get("type") == "user_message":
+                        message = str(payload.get("message") or "")
+                        break
+                candidate = Candidate(
+                    "codex",
+                    str(meta.get("id") or path.stem),
+                    started,
+                    str(meta.get("cwd") or ""),
+                    message,
+                )
+        _codex_cache[path] = (signature, candidate)
+        return candidate
+    except (OSError, StopIteration, json.JSONDecodeError):
+        return None
+
+
+def _codex_candidates(cutoff: datetime, now: datetime) -> list[Candidate]:
+    day = (cutoff - timedelta(days=1)).date()
+    day_dirs = []
+    while day <= (now + timedelta(days=1)).date():
+        day_dirs.append(codex_loader.SESSIONS_DIR / f"{day:%Y}" / f"{day:%m}" / f"{day:%d}")
+        day += timedelta(days=1)
+    result: list[Candidate] = []
+    for path in (path for day_dir in day_dirs for path in day_dir.glob("*.jsonl")):
+        candidate = _read_codex_candidate(path)
+        if candidate is not None and cutoff <= candidate.timestamp <= now:
+            result.append(candidate)
+    return result
+
+
+def _agy_candidates(cutoff: datetime, now: datetime) -> list[Candidate]:
+    result: list[Candidate] = []
+    for path in agy_loader.AGY_SESSIONS_DIR.glob("*.db"):
+        try:
+            if path.stat().st_mtime < cutoff.timestamp():
+                continue
+            with sqlite3.connect(agy_loader._readonly_sqlite_uri(path), uri=True) as connection:
+                started = agy_loader._session_timestamp(connection, path)
+                if not cutoff <= started <= now:
+                    continue
+                row = connection.execute(
+                    'SELECT step_payload FROM steps WHERE step_payload LIKE \'%"Cwd":"%\' ORDER BY idx LIMIT 1'
+                ).fetchone()
+                match = _CWD.search(row[0]) if row and isinstance(row[0], bytes) else None
+                cwd = (
+                    json.loads('"' + match.group(1).decode("utf-8", "replace") + '"')
+                    if match
+                    else ""
+                )
+                result.append(
+                    Candidate(
+                        "antigravity", path.stem, started, cwd if isinstance(cwd, str) else ""
+                    )
+                )
+        except (OSError, sqlite3.Error, json.JSONDecodeError):
+            continue
+    return result
+
+
+def match_candidate(
+    candidate: Candidate, dispatches: list[Dispatch], known_sessions: set[str]
+) -> str | None:
+    if candidate.agent_id == "codex":
+        direct: set[str] = {
+            value.lower() for value in _UUID.findall(candidate.cwd + " " + candidate.first_message)
+        } & known_sessions
+        if len(direct) == 1:
+            return next(iter(direct))
+        if len(direct) > 1:
+            return None
+    eligible = [
+        dispatch
+        for dispatch in dispatches
+        if dispatch.agent_id == candidate.agent_id
+        and -5 <= (candidate.timestamp - dispatch.timestamp).total_seconds() <= 120
+    ]
+    owners = {dispatch.session_id for dispatch in eligible}
+    if len(owners) > 1:
+        eligible = [
+            dispatch
+            for dispatch in eligible
+            if candidate.cwd
+            and (candidate.cwd == dispatch.cwd or candidate.cwd in dispatch.command)
+        ]
+        owners = {dispatch.session_id for dispatch in eligible}
+    return next(iter(owners)) if len(owners) == 1 else None
+
+
+def _window(pct: float | None, reset: object, minutes: float) -> QuotaWindow | None:
+    resets_at = _timestamp(reset)
+    if pct is None or resets_at is None or minutes <= 0:
+        return None
+    return QuotaWindow(pct, resets_at, timedelta(minutes=minutes))
+
+
+def load_windows() -> dict[str, QuotaWindow]:
+    windows: dict[str, QuotaWindow] = {}
+    claude = rate_limits.load_rate_limits()
+    if claude:
+        window = _window(claude.seven_day_pct, claude.seven_day_resets_at, 7 * 24 * 60)
+        if window:
+            windows["claude-code"] = window
+    codex = codex_loader.load_rate_limits()
+    if codex:
+        window = _window(
+            codex.seven_day_pct,
+            codex.seven_day_resets_at,
+            codex.seven_day_window_minutes or 7 * 24 * 60,
+        )
+        if window:
+            windows["codex"] = window
+    agy = agy_quota_probe._read_cache()
+    if agy:
+        fetched = _timestamp(agy.fetched_at)
+        if fetched:
+            for group in agy.groups:
+                minutes = group.weekly.resets_in_minutes
+                if minutes is None:
+                    continue
+                window = QuotaWindow(
+                    100 - group.weekly.remaining_percent,
+                    fetched + timedelta(minutes=minutes),
+                    timedelta(days=7),
+                )
+                group_key = f"antigravity:{group.name}"
+                windows[group_key] = window
+                for model in group.models:
+                    windows[f"antigravity-model:{model.lower()}"] = window
+    return windows
+
+
+def estimate_pct(
+    session_tokens: int, total_tokens: int, window: QuotaWindow | None, now: datetime
+) -> float | None:
+    if window is None or window.resets_at <= now or total_tokens <= 0:
+        return None
+    return session_tokens / total_tokens * window.used_pct
+
+
+def estimate_sessions(
+    entries: list[UsageEntry], windows: dict[str, QuotaWindow], now: datetime
+) -> dict[tuple[str, str], float | None]:
+    totals: dict[str, int] = defaultdict(int)
+    sessions: dict[tuple[str, str, str], int] = defaultdict(int)
+    for entry in entries:
+        group = entry.agent_id
+        if entry.agent_id == "antigravity":
+            model = entry.model.lower().replace("-", " ")
+            matched = next(
+                (
+                    label.removeprefix("antigravity-model:")
+                    for label in windows
+                    if label.startswith("antigravity-model:")
+                    and all(
+                        word in model for word in label.removeprefix("antigravity-model:").split()
+                    )
+                ),
+                None,
+            )
+            if matched is None:
+                continue
+            group = next(
+                (
+                    key
+                    for key, window in windows.items()
+                    if key.startswith("antigravity:")
+                    and window is windows[f"antigravity-model:{matched}"]
+                ),
+                "",
+            )
+        window = windows.get(group)
+        if window is None or not window.resets_at - window.length <= entry.timestamp <= now:
+            continue
+        tokens = entry.input_tokens + entry.output_tokens + entry.cache_creation_tokens
+        totals[group] += tokens
+        sessions[(entry.agent_id, entry.session_id, group)] += tokens
+    estimates: dict[tuple[str, str], float | None] = {}
+    for (agent_id, session_id, group), tokens in sessions.items():
+        value = estimate_pct(tokens, totals[group], windows.get(group), now)
+        if value is not None:
+            key = (agent_id, session_id)
+            estimates[key] = (estimates.get(key) or 0.0) + value
+    return estimates
+
+
+def _session_title(path: Path) -> str:
+    """Return Claude Code's own ai-title, falling back to the first user text."""
+    title = first_text = ""
+    try:
+        with path.open(encoding="utf-8", errors="replace") as stream:
+            for line in stream:
+                if '"ai-title"' not in line and (first_text or '"user"' not in line):
+                    continue
+                try:
+                    item = _dict(json.loads(line))
+                except json.JSONDecodeError:
+                    continue
+                if item.get("type") == "ai-title" and isinstance(item.get("aiTitle"), str):
+                    title = item["aiTitle"].strip()
+                elif item.get("type") == "user" and not first_text:
+                    content = _dict(item.get("message")).get("content")
+                    blocks = [{"text": content}] if isinstance(content, str) else content
+                    for block in blocks if isinstance(blocks, list) else []:
+                        text = _dict(block).get("text")
+                        if isinstance(text, str) and text.strip():
+                            first_text = text.strip()[:40]
+                            break
+    except OSError:
+        return ""
+    return title or first_text
+
+
+def build_ledger(estimates: dict[tuple[str, str], float | None], now: datetime) -> LedgerData:
+    cutoff = now - timedelta(days=7)
+    paths = _claude_paths(cutoff)
+    dispatches = [
+        item for path in paths for item in _read_dispatches(path) if cutoff <= item.timestamp <= now
+    ]
+    empty: LedgerData = {"rows": [], "unowned_codex": 0, "unowned_agy": 0}
+    if not dispatches:
+        return empty
+    known_sessions = {path.stem for path in paths}
+    candidates = _codex_candidates(cutoff - timedelta(seconds=5), now) + _agy_candidates(
+        cutoff - timedelta(seconds=5), now
+    )
+    owned: dict[str, dict[str, set[str]]] = defaultdict(lambda: defaultdict(set))
+    for candidate in candidates:
+        owner = match_candidate(candidate, dispatches, known_sessions)
+        if owner is None:
+            if candidate.agent_id == "codex":
+                empty["unowned_codex"] += 1
+            else:
+                empty["unowned_agy"] += 1
+        else:
+            owned[owner][candidate.agent_id].add(candidate.session_id)
+    if not owned:
+        return empty
+    path_by_session = {path.stem: path for path in paths}
+    by_owner: dict[str, list[Dispatch]] = defaultdict(list)
+    for dispatch in dispatches:
+        by_owner[dispatch.session_id].append(dispatch)
+    rows: list[tuple[str, LedgerRow]] = []
+    for owner, children in owned.items():
+        origin = by_owner.get(owner)
+        if not origin:
+            continue
+        shares = {"claude-code": estimates.get(("claude-code", owner))}
+        for agent_id in ("codex", "antigravity"):
+            values = [estimates.get((agent_id, session_id)) for session_id in children[agent_id]]
+            shares[agent_id] = (
+                sum(value for value in values if value is not None)
+                if any(value is not None for value in values)
+                else None
+            )
+        first = min(origin, key=lambda item: item.timestamp)
+        rows.append(
+            (
+                owner,
+                {
+                    "date": first.timestamp.astimezone().strftime("%Y-%m-%d"),
+                    "project": Path(first.cwd).name or "unknown",
+                    "title": "",
+                    "dispatch_count": len(origin),
+                    "claude_pct": shares["claude-code"],
+                    "codex_pct": shares["codex"],
+                    "agy_pct": shares["antigravity"],
+                    "total_pct": sum(value for value in shares.values() if value is not None),
+                },
+            )
+        )
+    rows.sort(key=lambda item: item[1]["total_pct"], reverse=True)
+    for owner, row in rows[:15]:
+        row["title"] = _session_title(path_by_session[owner])
+        empty["rows"].append(row)
+    return empty

{usage_cli-0.30.23 → usage_cli-0.31.0}/analyzer/reporter.py

@@ -27,7 +27,7 @@ from adapters.types import AgentInfo, UsageEntry
 from pricing import calculate_cost, is_model_priced
 
 from .aggregator import aggregate_sessions
-from . import diagnoser, usage_snapshot
+from . import diagnoser, dispatch_ledger, usage_snapshot
 
 logger = logging.getLogger(__name__)
 
@@ -43,7 +43,7 @@ _YEAR_WEEKS = 53
 YEAR_CACHE_PATH = Path(os.path.expanduser("~/.usage/year_cache.json"))
 YEAR_LEDGER_PATH = YEAR_CACHE_PATH.with_name("year_ledger.json")
 YEAR_CACHE_TTL_SECONDS = 6 * 3600
-_YEAR_CACHE_SCHEMA = 3
+_YEAR_CACHE_SCHEMA = 4
 _YEAR_LEDGER_SCHEMA = 1
 _YEAR_LEDGER_TRIM_BUFFER_DAYS = 60
 
@@ -130,6 +130,7 @@ class TopSessionReportRow(TypedDict):
     duration_min: float
     tokens: int
     cost: float
+    weekly_quota_pct: float | None
 
 
 class CubeAgentData(TypedDict):
@@ -241,6 +242,7 @@ class ReportData(_ReportDataRequired, total=False):
     by_agent_model: list[AgentModelReportRow]
     cube: CubeReportData
     sessions: list[SessionRowData]
+    dispatch_ledger: dispatch_ledger.LedgerData
 
 
 @dataclass(frozen=True)
@@ -911,6 +913,11 @@ def build_report_data(agents: list[AgentInfo], period: str = "month") -> ReportD
         prev_date_from = date_from - timedelta(days=total_days_for_comparison)
         hours_back = ((date_to - prev_date_from).days + 2) * 24
 
+    weekly_preloaded = (
+        [entry for agent in agents for entry in _load_agent_entries(agent, 8 * 24)]
+        if hours_back < 8 * 24
+        else None
+    )
     raw_entries: list[UsageEntry] = []
     for agent in agents:
         raw_entries.extend(_load_agent_entries(agent, hours_back))
@@ -1193,6 +1200,10 @@ def build_report_data(agents: list[AgentInfo], period: str = "month") -> ReportD
         cursor += timedelta(days=1)
 
     top_sessions: list[TopSessionReportRow] = []
+    now = datetime.now().astimezone(timezone.utc)
+    weekly_entries = raw_entries if weekly_preloaded is None else weekly_preloaded
+    windows = dispatch_ledger.load_windows() if weekly_entries else {}
+    estimates = dispatch_ledger.estimate_sessions(weekly_entries, windows, now)
     sessions_by_cost = sorted(
         aggregate_sessions(entries), key=lambda session: session.cost_usd, reverse=True
     )
@@ -1200,16 +1211,16 @@ def build_report_data(agents: list[AgentInfo], period: str = "month") -> ReportD
         sessions_by_cost, key=lambda session: session.total_tokens, reverse=True
     )
     for session in sessions_by_tokens[:5]:
-        top_sessions.append(
-            {
-                "start_time": _session_start_text(session.start_time),
-                "project": session.project or "unknown",
-                "model": session.model or "unknown",
-                "duration_min": session.duration_minutes,
-                "tokens": session.total_tokens,
-                "cost": _round_cost(session.cost_usd),
-            }
-        )
+        session_row: TopSessionReportRow = {
+            "start_time": _session_start_text(session.start_time),
+            "project": session.project or "unknown",
+            "model": session.model or "unknown",
+            "duration_min": session.duration_minutes,
+            "tokens": session.total_tokens,
+            "cost": _round_cost(session.cost_usd),
+            "weekly_quota_pct": estimates.get((session.agent_id, session.session_id)),
+        }
+        top_sessions.append(session_row)
 
     session_rows: list[SessionRowData] = []
     for session in sessions_by_cost:
@@ -1256,6 +1267,7 @@ def build_report_data(agents: list[AgentInfo], period: str = "month") -> ReportD
         "sessions": session_rows,
         "daily_trend": daily_trend,
         "top_sessions": top_sessions,
+        "dispatch_ledger": dispatch_ledger.build_ledger(estimates, now),
         "comparison": comparison,
         "subscriptions": subscription.load_subscriptions(),
         "persona": _load_persona_for_period(period),