Skip to content

agentledger 0.3.0

Choose a tag to compare

@garyleelty garyleelty released this 16 Oct 18:21
· 69 commits to main since this release

Install (no npm account needed)

npm install -g https://github.com/garyleelty/agentledger/releases/download/v0.3.0/agentledger-cli-0.3.0.tgz

The tarball below is attached by the release workflow using the repo's own token — agentledger-cli is still not on the npm registry, so this is the direct-download path.

What's new since 0.2.0

Sixth source: DSH (DeepSeek Harness). ~/.dsh/sessions/*/session.v4.jsonl.zstd. These sessions are multi-frame zstd — one frame per append — and Node's zstdDecompressSync reads only the first, silently yielding 238 bytes of a 776 kB session and zero records. The parser splits on the frame magic and decompresses each independently. No other tool reads these logs.

Unknown-price disclosure. A model with no built-in price is billed at a documented default and the report now says so: the model names, record counts, the dollar share of the total, and how to fix it. This mattered immediately — on the maintainer's machine 8 models were unpriced and $755 of a $1000 total was a placeholder. That number now travels with its caveat through summary, aggregate, and both digest renderers, so a published page cannot assert a total it cannot back.

prices --template. Turns that warning into a one-step fix: emits an override file naming exactly the models your ledger could not price, each with its token volume, with null placeholders (never invented rates).

--prices <file> (0.2.x): override any model's rates; partial entries merge over the built-in row.

statusline (0.2.x): one line for Claude Code's status bar, preferring the host's own session cost over an estimate.

Also

  • Pricing table cross-checked against the live LiteLLM database by a weekly CI job; 25 of 30 entries reconcile, the rest are reported as unchecked rather than trusted.
  • 97 tests, all hermetic (committed fixtures — the suite cannot pass by measuring nothing).
  • Docs figures are generated from a committed sample and CI fails if they drift.

MIT. Zero dependencies. No network calls, ever.