llm-usage-metrics 0.10.2 → 0.11.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +4 -2
  2. package/dist/index.js +987 -240
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -91,7 +91,7 @@ llm-usage session --top 10
91
91
  llm-usage session --by-repo
92
92
 
93
93
  # Last 14 local days as a token series
94
- llm-usage trends --metric tokens --days 14
94
+ llm-usage trends --metric tokens --last 14
95
95
 
96
96
  # Candidate-model pricing against observed usage
97
97
  llm-usage optimize monthly \
@@ -168,6 +168,8 @@ Cost rendering makes incomplete data visible:
168
168
  - `~$12.34` means the known cost is partial.
169
169
  - `-` means no contributing event has a resolved cost.
170
170
 
171
+ When any cost is marked `~`, stderr names how many of the shown events have no known price and their models. `--quiet` and `--no-cost` hide that line.
172
+
171
173
  The pricing request never includes session content. See [Pricing](https://ayagmar.github.io/llm-usage-metrics/pricing/) for rate matching, overrides, and error behavior.
172
174
 
173
175
  ## Local event ledger
@@ -210,7 +212,7 @@ llm-usage monthly --share
210
212
  llm-usage weekly --last 1 --no-cost
211
213
  ```
212
214
 
213
- Terminal tables fit the terminal width: on a narrow terminal, token counts are abbreviated and less-used columns are hidden, with a `stderr` note saying what was left out. `--compact` asks for the short table directly. `--last N` covers the last N days, weeks, or months, counting the current one, and `--no-cost` leaves spend out of tables and share cards.
215
+ Terminal tables fit the terminal width: on a narrow terminal, token counts are abbreviated and less-used columns are hidden, with a `stderr` note saying what was left out. When no table fits, as on a phone, each row is listed as labelled values instead. `--compact` asks for the short table directly. `--last N` covers the last N days, weeks, or months, counting the current one, and `--no-cost` leaves spend out of tables and share cards.
214
216
 
215
217
  Report data goes to `stdout`. Diagnostics go to `stderr` as one summary line plus any warnings, which keeps JSON and Markdown safe to redirect; `--quiet` keeps only warnings and `--verbose` adds per-source and skipped-row detail. JSON output is wrapped in a versioned envelope: `{ "schemaVersion": 1, "report": "usage", "data": ... }`. Scripts written against pre-0.8.0 JSON should follow the [migration guide](https://ayagmar.github.io/llm-usage-metrics/migrating-to-0-8/).
216
218