dsh-spend-receipt

DeepSeek token invoices usually give you a single final number with no visibility into what happened underneath: how many tokens were served from cache, which calls landed in the peak window, which rate table applied. dsh-spend-receipt writes one append-only JSONL line for every token event a provider actually reports - the input and cache-hit counts, the dated rate table used, the peak or off-peak tier, and whether the timestamp came from the event itself or was recorded at write time. A reader can re-derive every cost independently without trusting any intermediary layer. When a call cannot be priced - unknown model, missing cache split, absent timestamp - the plugin keeps the token counts and sets usd to null rather than padding with zero or guessing a figure.

Pricing is done entirely in integer nano-USD, so a thousand-line receipt sums without floating-point drift. Peak windows are 01:00-04:00 and 06:00-10:00 UTC on weekdays; everything else is off-peak at half rate. Tier detection reads only the UTC instant, immune to whatever local-offset string the log carried. The spend_receipt tool returns the most recent N lines, full and windowed totals, cache-hit rate with its statistical basis, and a count of malformed lines - all from a local file read, no API key required. A standalone CLI exposes the same functions from a shell, so the receipt stays queryable even if the harness itself is down.

Built for teams and individual developers who need per-call cost auditing, cache-hit tracking, or a consistent billing view across CI pipelines and daily development. If you are tired of reverse-engineering invoices to figure out which calls actually cost money, this plugin makes every step reproducible.