codex-usage-tracking 0.6.1__tar.gz → 0.7.0__tar.gz

{codex_usage_tracking-0.6.1 → codex_usage_tracking-0.7.0}/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "codex-usage-tracker",
-  "version": "0.6.1",
+  "version": "0.7.0",
   "description": "Unofficial local tracker for aggregate Codex token usage from local session logs.",
   "author": {
     "name": "Douglas Monsky"

{codex_usage_tracking-0.6.1 → codex_usage_tracking-0.7.0}/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 ## Unreleased
 
+## 0.7.0 - 2026-06-18
+
+- Parse latest observed Codex usage snapshots from local rate-limit and token-count log events without persisting raw transcript text.
+- Store observed 5h and weekly usage snapshot fields in aggregate rows and expose a latest-observed usage summary for dashboard and API consumers.
+- Add a dashboard card for latest observed 5h and weekly usage with wording that distinguishes local observations from authoritative account limits.
+- Default the dashboard table experience to time-sorted Calls, replace the visible Signals column with Reasoning Output, and keep the Signals field out of the table for now.
+- Ignore known non-token parser events so refreshes stay focused on usage-bearing records.
+
 ## 0.6.1 - 2026-06-13
 
 - Polish the README landing screenshots with matched dashboard/investigator previews and an additional lower investigator evidence view.

{codex_usage_tracking-0.6.1 → codex_usage_tracking-0.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codex-usage-tracking
-Version: 0.6.1
+Version: 0.7.0
 Summary: Unofficial local Codex plugin and dashboard for investigating aggregate token usage, costs, caching, and thread patterns.
 Author: Douglas Monsky
 License-Expression: MIT
@@ -188,7 +188,7 @@ Optional allowance context:
 codex-usage-tracker parse-allowance "5h 79% 6:50 PM Weekly 33% Jun 7"
 ```
 
-The tracker cannot read your logged-in ChatGPT plan or live remaining usage automatically. Allowance values are only as accurate as the values you manually copy from Codex Settings, `/status`, or another trusted usage display. Details: [Pricing, Credits, And Allowance](docs/pricing-and-credits.md).
+The tracker cannot read your logged-in ChatGPT plan or live remaining usage automatically. When local Codex logs include `token_count.rate_limits`, the dashboard can show the latest observed 5-hour and weekly remaining percentages from those logs. Otherwise, allowance values are only as accurate as the values you manually copy from Codex Settings, `/status`, or another trusted usage display. Details: [Pricing, Credits, And Allowance](docs/pricing-and-credits.md).
 
 ## What It Includes
 
@@ -296,7 +296,7 @@ This is optional. The normal shell install above is the fastest trusted path for
 - Token counts come from Codex's logged counters; the tracker does not re-tokenize prompts.
 - Pricing and rate-card sources can change outside this project.
 - Pricing and Codex credit estimates depend on local rate data and confidence labels and are not guaranteed to match exact billing.
-- Live account allowance cannot be read automatically by this local tracker; remaining 5-hour and weekly allowance is only available when you configure copied values.
+- Live account allowance cannot be read automatically by this local tracker; remaining 5-hour and weekly allowance is shown only from local Codex `token_count.rate_limits` snapshots when present, or from copied values you configure.
 - Local Codex logs may not include usage from other ChatGPT agentic surfaces that share the same allowance.
 - Plugin discovery limitations are separate from core Python CLI/dashboard support.
 - Parent-child thread relationships are only as good as the metadata Codex logs; inferred auto-review attachments are labeled as inferred.

{codex_usage_tracking-0.6.1 → codex_usage_tracking-0.7.0}/README.md

@@ -150,7 +150,7 @@ Optional allowance context:
 codex-usage-tracker parse-allowance "5h 79% 6:50 PM Weekly 33% Jun 7"
 ```
 
-The tracker cannot read your logged-in ChatGPT plan or live remaining usage automatically. Allowance values are only as accurate as the values you manually copy from Codex Settings, `/status`, or another trusted usage display. Details: [Pricing, Credits, And Allowance](docs/pricing-and-credits.md).
+The tracker cannot read your logged-in ChatGPT plan or live remaining usage automatically. When local Codex logs include `token_count.rate_limits`, the dashboard can show the latest observed 5-hour and weekly remaining percentages from those logs. Otherwise, allowance values are only as accurate as the values you manually copy from Codex Settings, `/status`, or another trusted usage display. Details: [Pricing, Credits, And Allowance](docs/pricing-and-credits.md).
 
 ## What It Includes
 
@@ -258,7 +258,7 @@ This is optional. The normal shell install above is the fastest trusted path for
 - Token counts come from Codex's logged counters; the tracker does not re-tokenize prompts.
 - Pricing and rate-card sources can change outside this project.
 - Pricing and Codex credit estimates depend on local rate data and confidence labels and are not guaranteed to match exact billing.
-- Live account allowance cannot be read automatically by this local tracker; remaining 5-hour and weekly allowance is only available when you configure copied values.
+- Live account allowance cannot be read automatically by this local tracker; remaining 5-hour and weekly allowance is shown only from local Codex `token_count.rate_limits` snapshots when present, or from copied values you configure.
 - Local Codex logs may not include usage from other ChatGPT agentic surfaces that share the same allowance.
 - Plugin discovery limitations are separate from core Python CLI/dashboard support.
 - Parent-child thread relationships are only as good as the metadata Codex logs; inferred auto-review attachments are labeled as inferred.

{codex_usage_tracking-0.6.1 → codex_usage_tracking-0.7.0}/docs/dashboard-guide.md

@@ -111,7 +111,7 @@ Useful interpretation notes:
 - `Cached input` and `Uncached input` are split so cache behavior is visible without storing transcript text.
 - A cost with `*` means the pricing row is marked as a best-guess estimate.
 - Codex credits are estimated from aggregate input, cached-input, and output token counters. Direct model matches use the bundled OpenAI Codex rate-card snapshot; inferred labels are marked estimated, and local credit-rate overrides are marked user-provided.
-- `Usage Remaining` is not read from the logged-in account plan. Configure `~/.codex-usage-tracker/allowance.json` with values copied from Codex Settings > Usage, the Codex Usage dashboard, or `/status` when you want current remaining allowance context.
+- `Usage observed` is not a live account query. It uses the latest local Codex `token_count.rate_limits` snapshot when present; otherwise configure `~/.codex-usage-tracker/allowance.json` with values copied from Codex Settings > Usage, the Codex Usage dashboard, or `/status` when you want current remaining allowance context.
 
 ## Threads View
 
@@ -212,7 +212,7 @@ The dashboard is designed to be shareable as an aggregate report, but only after
 
 It includes:
 
-- session ids, thread names, cwd values, source file paths, timestamps, model labels, reasoning effort, token counts, cost estimates, Codex credit estimates, optional manually entered allowance windows, and derived ratios
+- session ids, thread names, cwd values, source file paths, timestamps, model labels, reasoning effort, token counts, cost estimates, Codex credit estimates, optional observed/copied allowance windows, and derived ratios
 
 It does not include:
 
@@ -222,7 +222,7 @@ The screenshots in this guide are produced from synthetic fixture data used by t
 
 Use `--privacy-mode redacted` or `--privacy-mode strict` before sharing generated dashboards, CSV exports, query JSON, or support bundles. Redacted mode removes raw cwd/source paths and hides unnamed project names behind stable hashes. Strict mode also hides project-relative cwd, branch, and tags. Configured project aliases are treated as explicit display opt-ins in both modes.
 
-Remaining 5-hour and weekly allowance is not read from Codex logs or inferred from the logged-in account plan automatically. Add `~/.codex-usage-tracker/allowance.json` only when you want the dashboard to show current copied allowance state. Local Codex logs may also omit usage from other ChatGPT agentic surfaces that share the same allowance.
+Remaining 5-hour and weekly allowance is not inferred from the logged-in account plan. When Codex writes local `token_count.rate_limits` snapshots, the dashboard can show the latest observed local-log percentages; otherwise add `~/.codex-usage-tracker/allowance.json` when you want copied allowance state. Local Codex logs may also omit usage from other ChatGPT agentic surfaces that share the same allowance.
 
 Archived sessions are excluded from dashboard payloads by default. The `All history` mode is an explicit opt-in because archived logs can make refreshes slower and can make current dashboards look inflated by older work.
 

{codex_usage_tracking-0.6.1 → codex_usage_tracking-0.7.0}/docs/development.md

@@ -38,7 +38,7 @@ fix/<issue-number>-short-description
 docs/<issue-number>-short-description
 chore/<issue-number>-short-description
 test/<issue-number>-short-description
-release/0.6.1
+release/0.7.0
 hotfix/0.3.3
 ```
 
@@ -91,7 +91,7 @@ blocked
 Recommended milestones:
 
 ```text
-0.6.1
+0.7.0
 1.0-readiness
 1.0.0
 ```
@@ -146,8 +146,8 @@ python scripts/smoke_installed_package.py --docker
 To verify the public PyPI package instead of the local checkout:
 
 ```bash
-python scripts/smoke_installed_package.py --from-pypi --version 0.6.1
-python scripts/smoke_installed_package.py --docker --from-pypi --version 0.6.1
+python scripts/smoke_installed_package.py --from-pypi --version 0.7.0
+python scripts/smoke_installed_package.py --docker --from-pypi --version 0.7.0
 ```
 
 `scripts/check_release.py` treats these public-package smoke commands as release-state claims. Keep their `--version` and `codex-usage-tracking==...` values aligned with `pyproject.toml`; the release gate fails when the docs claim a different public version. It also checks that install docs point at the real PyPI distribution, `codex-usage-tracking`, and keep the warning that `codex-usage-tracker` is a different PyPI package.
@@ -286,8 +286,8 @@ After the release branch merges, tag from updated `main`, not from an unreviewed
 ```bash
 git switch main
 git pull --ff-only
-git tag -a v0.6.1 -m "codex-usage-tracker 0.6.1"
-git push origin v0.6.1
+git tag -a v0.7.0 -m "codex-usage-tracker 0.7.0"
+git push origin v0.7.0
 ```
 
 Do not create or push release tags without maintainer approval.
@@ -296,7 +296,7 @@ Do not create or push release tags without maintainer approval.
 
 Publishing uses GitHub Actions Trusted Publishing through `.github/workflows/publish.yml`; do not upload from a local machine and do not add PyPI or TestPyPI API tokens.
 
-The first public package release, `0.3.0`, was published on June 8, 2026. Patch release `0.3.1` followed the same day to ship the live-dashboard skill launch fix. Patch release `0.3.2` made dashboard launch refresh the default and added runtime enablement for context loading. Minor release `0.4.0` added Python 3.14 support, release recovery docs, stricter privacy/support-bundle regression coverage, and large-history benchmark thresholds. Patch release `0.4.1` was published by workflow dispatch from `main`; it hardened the PyPI publish workflow and checked off completed 1.0 readiness gates. Minor release `0.5.0` added dashboard localization support and initial language catalogs. Minor release `0.6.0` is the performance and call-drilldown release with SQL-backed live API slices, materialized thread summaries, faster evidence loading, and dashboard runtime module refactors. Patch release `0.6.1` aligns the final README/package screenshots and companion plugin assets.
+The first public package release, `0.3.0`, was published on June 8, 2026. Patch release `0.3.1` followed the same day to ship the live-dashboard skill launch fix. Patch release `0.3.2` made dashboard launch refresh the default and added runtime enablement for context loading. Minor release `0.4.0` added Python 3.14 support, release recovery docs, stricter privacy/support-bundle regression coverage, and large-history benchmark thresholds. Patch release `0.4.1` was published by workflow dispatch from `main`; it hardened the PyPI publish workflow and checked off completed 1.0 readiness gates. Minor release `0.5.0` added dashboard localization support and initial language catalogs. Minor release `0.6.0` is the performance and call-drilldown release with SQL-backed live API slices, materialized thread summaries, faster evidence loading, and dashboard runtime module refactors. Patch release `0.6.1` aligns the final README/package screenshots and companion plugin assets. Minor release `0.7.0` adds observed usage snapshots and the latest-observed dashboard card while keeping raw evidence on demand only.
 
 - GitHub Release: `https://github.com/douglasmonsky/codex-usage-tracker/releases/tag/v0.3.0`
 - GitHub Release: `https://github.com/douglasmonsky/codex-usage-tracker/releases/tag/v0.3.1`

{codex_usage_tracking-0.6.1 → codex_usage_tracking-0.7.0}/docs/one-dot-oh-readiness.md

@@ -24,12 +24,12 @@ Not guaranteed:
 
 ## 1. Public Install And Package Metadata
 
-- [x] Verify the current public PyPI version is visible as `0.6.1`: `python -c "import json, urllib.request; print(json.load(urllib.request.urlopen('https://pypi.org/pypi/codex-usage-tracking/json'))['info']['version'])"`.
-- [x] Verify public venv install for `0.6.1`: `python -m venv /tmp/codex-usage-pypi-smoke && . /tmp/codex-usage-pypi-smoke/bin/activate && python -m pip install codex-usage-tracking==0.6.1 && codex-usage-tracker --version`.
-- [x] Verify public pipx install path for `0.6.1`: `PIPX_HOME=/tmp/codex-usage-pipx-home PIPX_BIN_DIR=/tmp/codex-usage-pipx-bin pipx install codex-usage-tracking==0.6.1 && /tmp/codex-usage-pipx-bin/codex-usage-tracker --version`.
+- [x] Verify the current public PyPI version is visible as `0.7.0`: `python -c "import json, urllib.request; print(json.load(urllib.request.urlopen('https://pypi.org/pypi/codex-usage-tracking/json'))['info']['version'])"`.
+- [x] Verify public venv install for `0.7.0`: `python -m venv /tmp/codex-usage-pypi-smoke && . /tmp/codex-usage-pypi-smoke/bin/activate && python -m pip install codex-usage-tracking==0.7.0 && codex-usage-tracker --version`.
+- [x] Verify public pipx install path for `0.7.0`: `PIPX_HOME=/tmp/codex-usage-pipx-home PIPX_BIN_DIR=/tmp/codex-usage-pipx-bin pipx install codex-usage-tracking==0.7.0 && /tmp/codex-usage-pipx-bin/codex-usage-tracker --version`.
 - [x] Verify installed package resources from a built wheel: `python scripts/smoke_installed_package.py`.
 - [x] Verify installed package resources in Linux Docker: `python scripts/smoke_installed_package.py --docker`.
-- [x] Verify public PyPI package in Docker: `python scripts/smoke_installed_package.py --docker --from-pypi --version 0.6.1`.
+- [x] Verify public PyPI package in Docker: `python scripts/smoke_installed_package.py --docker --from-pypi --version 0.7.0`.
 - [x] Verify PyPI metadata names remain unchanged: `python scripts/check_release.py`.
 - [x] Add Python 3.14 as an official support target after CI, package classifiers, docs, and installed-package smoke coverage were added. Docker smoke coverage uses `python:3.14-slim` by default. Track this in issue #12.
 
@@ -134,14 +134,14 @@ Not guaranteed:
 
 ## Evidence References
 
-These references are the concrete proof behind completed checklist items. Public package smoke commands are version-specific to `0.6.1`; all repo tests use synthetic or aggregate-only data.
+These references are the concrete proof behind completed checklist items. Public package smoke commands are version-specific to `0.7.0`; all repo tests use synthetic or aggregate-only data.
 
 ### Public Install And Package Metadata
 
 - Public PyPI version, public venv install, and public pipx install are proven by the exact public-install commands in section 1.
 - Built-wheel and installed-resource coverage is proven by `scripts/smoke_installed_package.py` and `tests/test_cli_release.py::test_installed_package_smoke_checks_help_for_stable_commands`.
 - Linux package-resource coverage is proven by `scripts/smoke_installed_package.py --docker`.
-- Public PyPI Docker coverage is proven by `scripts/smoke_installed_package.py --docker --from-pypi --version 0.6.1`.
+- Public PyPI Docker coverage is proven by `scripts/smoke_installed_package.py --docker --from-pypi --version 0.7.0`.
 - PyPI metadata, package/distribution names, package resources, source/wheel member names, Python 3.10-3.14 support metadata, CI workflow requirements, publish workflow safety text, and tracked secret patterns are proven by `scripts/check_release.py`, `scripts/check_release.py --dist`, and `tests/test_cli_release.py::test_release_check_script_passes`.
 
 ### Upgrade And Migration
@@ -219,8 +219,8 @@ These references are the concrete proof behind completed checklist items. Public
 - Publish workflow package name, Trusted Publishing, TestPyPI/PyPI job presence, event guards, no push/PR publishing, no token/password publishing, and manual PyPI main/tag preflight are proven by `scripts/check_release.py::_check_publish_workflow`.
 - The GitHub `pypi` environment gate is proven by `gh api repos/douglasmonsky/codex-usage-tracker/environments/pypi`, which reports a `required_reviewers` protection rule and `can_admins_bypass=false`.
 - Dist filename and wheel/sdist member checks are proven by `python -m build`, `python -m twine check dist/*`, and `python scripts/check_release.py --dist`.
-- TestPyPI publish process is proven by a workflow-dispatch run on `main`, followed by TestPyPI metadata and clean virtualenv install checks for `codex-usage-tracking==0.6.1`.
-- PyPI publish process is proven by a workflow-dispatch run on `main`, protected `pypi` environment approval, PyPI metadata visibility, clean virtualenv install, temporary pipx install, and Docker public-package smoke for `codex-usage-tracking==0.6.1`.
+- TestPyPI publish process is proven by a workflow-dispatch run on `main`, followed by TestPyPI metadata and clean virtualenv install checks for `codex-usage-tracking==0.7.0`.
+- PyPI publish process is proven by a workflow-dispatch run on `main`, protected `pypi` environment approval, PyPI metadata visibility, clean virtualenv install, temporary pipx install, and Docker public-package smoke for `codex-usage-tracking==0.7.0`.
 - Release recovery documentation is proven by `scripts/check_release.py` required-file and docs checks.
 
 ### Known Limitations

{codex_usage_tracking-0.6.1 → codex_usage_tracking-0.7.0}/docs/pricing-and-credits.md

@@ -4,7 +4,7 @@ Codex Usage Tracker has three related but different concepts:
 
 - `Estimated Cost`: optional USD estimates from a local pricing file.
 - `Codex Credits`: calculated usage credits from aggregate token counters and Codex credit rates.
-- `Usage Remaining`: optional user-provided 5-hour and weekly allowance snapshots.
+- `Usage observed`: optional latest local-log 5-hour and weekly allowance snapshots, falling back to copied allowance config when logs do not include rate-limit snapshots.
 
 ## Cost Estimates
 
@@ -58,11 +58,11 @@ codex-usage-tracker update-rate-card
 
 The local snapshot is written to `~/.codex-usage-tracker/rate-card.json`. Each bundled rate and alias includes source URL, fetched date, tier, confidence, and alias rationale where applicable. Use `--source-file` only when you have a reviewed replacement JSON snapshot you want the tracker to validate and use.
 
-## Usage Remaining
+## Usage Observed
 
-`Usage Remaining` is different from `Codex Credits`. The tracker cannot currently read your logged-in ChatGPT plan, live remaining credits, reset windows, or usage from other agentic surfaces automatically.
+`Usage observed` is different from `Codex Credits`. The tracker cannot currently read your logged-in ChatGPT plan, live remaining credits, reset windows, or usage from other agentic surfaces automatically.
 
-A plan name such as Free, Plus, Pro, Business, or Enterprise can provide context, but it is not enough to know the current remaining allowance. The dashboard shows remaining values only when you copy them into `~/.codex-usage-tracker/allowance.json`.
+A plan name such as Free, Plus, Pro, Business, or Enterprise can provide context, but it is not enough to know the current remaining allowance. When local Codex logs include `token_count.rate_limits`, the dashboard shows the latest observed 5-hour and weekly percentages from those logs. Otherwise, the dashboard shows remaining values only when you copy them into `~/.codex-usage-tracker/allowance.json`.
 
 Enable optional allowance context:
 
@@ -87,6 +87,7 @@ Configure the usage component:
 - Pricing and rate-card sources can change outside this project. Refresh or pin local files when reports need a known source snapshot.
 - Local Codex logs may not include usage from other ChatGPT agentic surfaces that share the same allowance.
 - Live account allowance cannot be read automatically by this local tracker, and the dashboard does not infer live remaining allowance from the logged-in account plan.
+- Observed local-log snapshots may be stale until Codex records another model call, and may omit other agentic surfaces that share the same allowance.
 - Pricing can change after a report is generated. Use `pin-pricing` when you need reproducible historical cost estimates.
 - Rows with direct model/rate-card matches are more trustworthy than inferred aliases or local overrides.
 - Cost and credit calculations use aggregate counters; the tracker does not re-tokenize prompts or reconstruct usage from raw text.

{codex_usage_tracking-0.6.1 → codex_usage_tracking-0.7.0}/docs/privacy.md

@@ -14,6 +14,7 @@ The local SQLite database is stored at `~/.codex-usage-tracker/usage.sqlite3` by
 - archived-session flag, conservative thread key, and adjacent aggregate record ids for dashboard navigation
 - materialized thread-level aggregate summaries for active and all-history scopes
 - source-file refresh metadata such as path, path hash, size, mtime, indexed line/byte offsets, latest aggregate record id, parser diagnostics, and last indexed time
+- observed Codex rate-limit snapshot metadata from local token-count logs, such as plan type, limit id, 5-hour/weekly used percentages, window lengths, and reset times
 - pricing, credit, allowance, recommendation, and project metadata derived from aggregate fields
 
 ## Not Stored
@@ -104,7 +105,7 @@ Cost estimates are calculated only from aggregate token fields and your local pr
 
 Codex credit estimates are calculated only from aggregate token fields and bundled or locally configured rate-card values.
 
-The optional allowance config is local and stores only the remaining percentages, reset times, or credit totals you manually enter.
+The optional allowance config is local and stores only the remaining percentages, reset times, or credit totals you manually enter. Observed rate-limit snapshots, when present in Codex token-count logs, store only structured percentages, window lengths, reset times, plan type, and limit id.
 
 ## Sharing Checklist
 

{codex_usage_tracking-0.6.1 → codex_usage_tracking-0.7.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "codex-usage-tracking"
-version = "0.6.1"
+version = "0.7.0"
 description = "Unofficial local Codex plugin and dashboard for investigating aggregate token usage, costs, caching, and thread patterns."
 readme = "README.md"
 requires-python = ">=3.10"

{codex_usage_tracking-0.6.1 → codex_usage_tracking-0.7.0}/skills/codex-usage-tracker/scripts/run_mcp.py

@@ -15,9 +15,9 @@ from pathlib import Path
 
 PACKAGE_SPEC = os.environ.get(
     "CODEX_USAGE_TRACKER_PACKAGE_SPEC",
-    "codex-usage-tracking==0.6.1",
+    "codex-usage-tracking==0.7.0",
 )
-RUNTIME_VERSION = "0.6.1"
+RUNTIME_VERSION = "0.7.0"
 PACKAGE_SPEC_MARKER = ".codex-usage-tracker-package-spec"
 MODULE_CHECK = (
     "import importlib.metadata; "

{codex_usage_tracking-0.6.1 → codex_usage_tracking-0.7.0}/src/codex_usage_tracker/__init__.py

@@ -2,6 +2,6 @@
 
 from codex_usage_tracker.models import UsageEvent
 
-__version__ = "0.6.1"
+__version__ = "0.7.0"
 
 __all__ = ["UsageEvent", "__version__"]

{codex_usage_tracking-0.6.1 → codex_usage_tracking-0.7.0}/src/codex_usage_tracker/dashboard.py

@@ -44,6 +44,7 @@ from codex_usage_tracker.store import (
     query_dashboard_event_count,
     query_dashboard_events,
     query_dashboard_token_summary,
+    query_latest_observed_usage,
     refresh_metadata,
 )
 from codex_usage_tracker.threads import annotate_thread_attachments
@@ -153,6 +154,10 @@ def dashboard_payload(
         token_summary["priced_model_rows"],
         allowance,
     )
+    observed_usage = query_latest_observed_usage(
+        db_path=db_path,
+        include_archived=include_archived,
+    )
     normalized_limit = _normalize_limit(limit)
     total_available_rows = query_dashboard_event_count(
         db_path=db_path,
@@ -187,6 +192,7 @@ def dashboard_payload(
         "allowance_source": allowance_summary["source"],
         "allowance_windows": allowance_summary["windows"],
         "allowance_error": allowance_summary["error"],
+        "observed_usage": observed_usage,
         "rate_card_configured": allowance_summary["rate_card_loaded"],
         "rate_card_error": allowance_summary["rate_card_error"],
         "loaded_row_count": len(rows),

{codex_usage_tracking-0.6.1 → codex_usage_tracking-0.7.0}/src/codex_usage_tracker/models.py

@@ -58,6 +58,14 @@ class UsageEvent:
     cumulative_output_tokens: int
     cumulative_reasoning_output_tokens: int
     cumulative_total_tokens: int
+    rate_limit_plan_type: str | None = None
+    rate_limit_limit_id: str | None = None
+    rate_limit_primary_used_percent: float | None = None
+    rate_limit_primary_window_minutes: int | None = None
+    rate_limit_primary_resets_at: int | None = None
+    rate_limit_secondary_used_percent: float | None = None
+    rate_limit_secondary_window_minutes: int | None = None
+    rate_limit_secondary_resets_at: int | None = None
 
     @property
     def uncached_input_tokens(self) -> int:

{codex_usage_tracking-0.6.1 → codex_usage_tracking-0.7.0}/src/codex_usage_tracker/parser.py

@@ -40,7 +40,19 @@ PARSER_DIAGNOSTIC_KEYS = (
 )
 
 KNOWN_NON_TOKEN_EVENT_MSG_TYPES = frozenset({
+    "agent_message",
     "context_compacted",
+    "image_generation_end",
+    "item_completed",
+    "mcp_tool_call_end",
+    "patch_apply_end",
+    "task_complete",
+    "task_started",
+    "thread_goal_updated",
+    "thread_rolled_back",
+    "turn_aborted",
+    "user_message",
+    "web_search_end",
 })
 
 
@@ -426,6 +438,7 @@ def _parse_codex_jsonl_v1(
                     ),
                     last_usage=last_usage,
                     total_usage=total_usage,
+                    rate_limits=payload.get("rate_limits"),
                     stats=stats,
                 )
             except ValueError:
@@ -462,6 +475,7 @@ def _build_event(
     model_context_window: int | None,
     last_usage: dict[str, Any],
     total_usage: dict[str, Any],
+    rate_limits: object = None,
     stats: MutableMapping[str, int] | None = None,
 ) -> UsageEvent:
     input_tokens = _required_usage_int(last_usage, "input_tokens", stats=stats)
@@ -477,6 +491,7 @@ def _build_event(
         stats=stats,
         missing_key="missing_cumulative_total",
     )
+    observed_usage = _observed_usage_from_rate_limits(rate_limits, stats=stats)
     record_id = _record_id(
         session_id=session_id,
         turn_id=_optional_str(current_turn.get("turn_id")),
@@ -533,9 +548,51 @@ def _build_event(
             total_usage, "reasoning_output_tokens", stats=stats
         ),
         cumulative_total_tokens=cumulative_total_tokens,
+        **observed_usage,
     )
 
 
+def _observed_usage_from_rate_limits(
+    value: object,
+    *,
+    stats: MutableMapping[str, int] | None = None,
+) -> dict[str, Any]:
+    if not isinstance(value, dict):
+        return {}
+    primary = _rate_limit_window(value.get("primary"), "primary", stats=stats)
+    secondary = _rate_limit_window(value.get("secondary"), "secondary", stats=stats)
+    return {
+        "rate_limit_plan_type": _optional_str(value.get("plan_type")),
+        "rate_limit_limit_id": _optional_str(value.get("limit_id")),
+        **primary,
+        **secondary,
+    }
+
+
+def _rate_limit_window(
+    value: object,
+    prefix: str,
+    *,
+    stats: MutableMapping[str, int] | None = None,
+) -> dict[str, object]:
+    if not isinstance(value, dict):
+        return {}
+    return {
+        f"rate_limit_{prefix}_used_percent": _nullable_float(
+            value.get("used_percent"),
+            stats=stats,
+        ),
+        f"rate_limit_{prefix}_window_minutes": _nullable_int(
+            value.get("window_minutes"),
+            stats=stats,
+        ),
+        f"rate_limit_{prefix}_resets_at": _nullable_int(
+            value.get("resets_at"),
+            stats=stats,
+        ),
+    }
+
+
 def _session_metadata(
     payload: dict[str, Any],
     session_index: dict[str, SessionInfo],
@@ -678,6 +735,23 @@ def _nullable_int(
         return None
 
 
+def _nullable_float(
+    value: object,
+    *,
+    stats: MutableMapping[str, int] | None = None,
+    invalid_key: str = "partial_field_count",
+) -> float | None:
+    if value is None:
+        return None
+    try:
+        return _strict_float(value)
+    except ValueError:
+        _increment_stat(stats, invalid_key)
+        if invalid_key != "partial_field_count":
+            _increment_stat(stats, "partial_field_count")
+        return None
+
+
 def _strict_int(value: object) -> int:
     if isinstance(value, bool):
         raise ValueError(f"invalid integer value: {value!r}")
@@ -693,6 +767,19 @@ def _strict_int(value: object) -> int:
     raise ValueError(f"invalid integer value: {value!r}")
 
 
+def _strict_float(value: object) -> float:
+    if isinstance(value, bool):
+        raise ValueError(f"invalid float value: {value!r}")
+    if isinstance(value, (int, float)):
+        return float(value)
+    if isinstance(value, str) and value.strip():
+        try:
+            return float(value)
+        except ValueError as exc:
+            raise ValueError(f"invalid float value: {value!r}") from exc
+    raise ValueError(f"invalid float value: {value!r}")
+
+
 def _required_usage_int(
     values: dict[str, Any],
     key: str,

{codex_usage_tracking-0.6.1 → codex_usage_tracking-0.7.0}/src/codex_usage_tracker/plugin_data/dashboard/dashboard.css

@@ -222,6 +222,26 @@
     }
     .card span { display: block; color: var(--muted); font-size: 12px; font-weight: 680; }
     .card strong { display: block; margin-top: 7px; font-size: 22px; }
+    .usage-card {
+      display: flex;
+      flex-direction: column;
+      align-items: flex-start;
+    }
+    .usage-reconcile {
+      display: inline-flex;
+      align-items: center;
+      width: fit-content;
+      margin-top: 10px;
+      padding: 3px 8px;
+      border-radius: 999px;
+      border: 1px solid #f2c66d;
+      background: #fff8e5;
+      color: #8a5b00;
+      font-size: 11px;
+      font-weight: 780;
+    }
+    .usage-reconcile[hidden] { display: none; }
+    #allowanceImpact { white-space: pre-line; line-height: 1.18; }
     .row-load-progress {
       display: grid;
       gap: 8px;
@@ -259,4 +279,3 @@
       background: linear-gradient(90deg, var(--blue), #74a3ff);
       transition: width 160ms ease;
     }
-    #allowanceImpact { white-space: pre-line; line-height: 1.18; }

{codex_usage_tracking-0.6.1 → codex_usage_tracking-0.7.0}/src/codex_usage_tracker/plugin_data/dashboard/dashboard.js

@@ -104,6 +104,7 @@
     let allowanceSource = activeInitialPayload.allowance_source || {};
     let allowanceWindows = Array.isArray(activeInitialPayload.allowance_windows) ? activeInitialPayload.allowance_windows : [];
     let allowanceError = activeInitialPayload.allowance_error || '';
+    let observedUsage = activeInitialPayload.observed_usage || { available: false, windows: [] };
     let rateCardError = activeInitialPayload.rate_card_error || '';
     let projectMetadataPrivacy = activeInitialPayload.project_metadata_privacy || { mode: activeInitialPayload.privacy_mode || 'normal' };
     let parserDiagnostics = activeInitialPayload.parser_diagnostics || {};
@@ -181,9 +182,11 @@
       custom: 'option.custom_range',
     };
     const allowedDatePresets = new Set(Object.keys(datePresetLabels));
-    let activeView = ['calls', 'threads', 'insights', 'call'].includes(initialState.view) ? initialState.view : 'insights';
+    const defaultDashboardView = 'calls';
+    const defaultDashboardSort = 'time';
+    let activeView = ['calls', 'threads', 'insights', 'call'].includes(initialState.view) ? initialState.view : defaultDashboardView;
     document.body.dataset.activeView = activeView;
-    let sortKey = optionValueExists(sortEl, initialState.sort) ? initialState.sort : sortEl.value || 'attention';
+    let sortKey = optionValueExists(sortEl, initialState.sort) ? initialState.sort : sortEl.value || defaultDashboardSort;
     let sortDirection = ['asc', 'desc'].includes(initialState.direction) ? initialState.direction : defaultSortDirection(sortKey);
     let threadCallSortKey = 'time';
     let threadCallSortDirection = 'desc';
@@ -388,6 +391,7 @@
         cached: t('table.cached'),
         uncached: t('table.uncached'),
         output: t('table.output'),
+        reasoning: t('metric.reasoning_output'),
         signals: t('table.signals'),
         thread: t('table.thread'),
         time: t('table.time'),
@@ -461,6 +465,7 @@
     }
     dashboardStatus = dashboardStatusFactory.create({
       allowanceImpactElement: document.getElementById('allowanceImpact'),
+      allowanceReconcileElement: document.getElementById('allowanceReconcile'),
       allowanceSourceElement: document.getElementById('allowanceSource'),
       creditCoverageRatio,
       credits,
@@ -471,6 +476,7 @@
       getAllowanceSource: () => allowanceSource,
       getAllowanceWindows: () => allowanceWindows,
       getData: () => data,
+      getObservedUsage: () => observedUsage,
       getParserDiagnostics: () => parserDiagnostics,
       getPricingConfigured: () => pricingConfigured,
       getPricingSnapshotWarning: () => pricingSnapshotWarning,
@@ -741,7 +747,7 @@
     function clearPreset() {
       activePreset = '';
       pricingStatusEl.value = '';
-      sortKey = 'attention';
+      sortKey = defaultDashboardSort;
       sortDirection = defaultSortDirection(sortKey);
       sortEl.value = sortKey;
       resetVisibleRows();
@@ -780,7 +786,7 @@
       effortTooltipText,
       outputTokenCell,
       outputTokens,
-      renderSignalPucks,
+      reasoningTokenCell,
       sourceLabelText,
       threadInitiatorSummary,
       tokenNumberCell,
@@ -964,7 +970,7 @@
         threadCallSortDirection = threadCallSortDirection === 'asc' ? 'desc' : 'asc';
       } else {
         threadCallSortKey = key;
-        threadCallSortDirection = key === 'time' || key === 'total' || key === 'cached' || key === 'uncached' || key === 'output' || key === 'cost' || key === 'cache' || key === 'signals' ? 'desc' : 'asc';
+        threadCallSortDirection = key === 'time' || key === 'total' || key === 'cached' || key === 'uncached' || key === 'output' || key === 'reasoning' || key === 'cost' || key === 'cache' ? 'desc' : 'asc';
       }
       render();
     }
@@ -1039,7 +1045,7 @@
       number,
       outputTokenCell,
       pct,
-      renderSignalPucks,
+      reasoningTokenCell,
       renderTimeCell,
       renderWithState: () => render(),
       rowInvestigatorLink,
@@ -1247,6 +1253,7 @@
       allowanceSource = nextPayload.allowance_source || {};
       allowanceWindows = Array.isArray(nextPayload.allowance_windows) ? nextPayload.allowance_windows : [];
       allowanceError = nextPayload.allowance_error || '';
+      observedUsage = nextPayload.observed_usage || { available: false, windows: [] };
       rateCardError = nextPayload.rate_card_error || '';
       parserDiagnostics = nextPayload.parser_diagnostics || {};
       projectMetadataPrivacy = nextPayload.project_metadata_privacy || { mode: nextPayload.privacy_mode || 'normal' };

{codex_usage_tracking-0.6.1 → codex_usage_tracking-0.7.0}/src/codex_usage_tracker/plugin_data/dashboard/dashboard_analysis.js

@@ -69,6 +69,7 @@
       if (key === 'cached') return cachedInputTokens(row);
       if (key === 'uncached') return uncachedInputTokens(row);
       if (key === 'output') return outputTokens(row);
+      if (key === 'reasoning') return Number(row.reasoning_output_tokens || 0);
       if (key === 'signals') return signalCount(row);
       if (key === 'thread') return textValue(rowThreadLabel(row));
       if (key === 'time') return String(row.event_timestamp || '');
@@ -93,6 +94,7 @@
       if (key === 'cached') return cachedInputTokens(row);
       if (key === 'uncached') return uncachedInputTokens(row);
       if (key === 'output') return outputTokens(row);
+      if (key === 'reasoning') return Number(row.reasoning_output_tokens || 0);
       if (key === 'signals') return signalCount(row);
       if (key === 'source') return textValue(callInitiatorText(row));
       if (key === 'time') return String(row.event_timestamp || '');
@@ -125,6 +127,7 @@
       if (key === 'cached') return group.cachedTokens;
       if (key === 'uncached') return group.uncachedTokens;
       if (key === 'output') return group.outputTokens;
+      if (key === 'reasoning') return group.reasoningOutputTokens;
       if (key === 'signals') return group.signalCount;
       if (key === 'thread') return textValue(group.label);
       if (key === 'time') return String(group.latestActivity || '');
@@ -321,6 +324,7 @@
         const cachedTokens = calls.reduce((sum, row) => sum + Number(row.cached_input_tokens || 0), 0);
         const uncachedTokens = calls.reduce((sum, row) => sum + uncachedInputTokens(row), 0);
         const outputTokensTotal = calls.reduce((sum, row) => sum + outputTokens(row), 0);
+        const reasoningOutputTokens = calls.reduce((sum, row) => sum + Number(row.reasoning_output_tokens || 0), 0);
         const estimatedCost = calls.reduce((sum, row) => sum + Number(row.estimated_cost_usd || 0), 0);
         const usageCredits = sumUsageCredits(calls);
         const signalTotal = calls.reduce((sum, row) => sum + signalCount(row), 0);
@@ -348,6 +352,7 @@
           cachedTokens,
           uncachedTokens,
           outputTokens: outputTokensTotal,
+          reasoningOutputTokens,
           estimatedCost,
           usageCredits,
           cacheRatio: inputTokens ? cachedTokens / inputTokens : 0,