dsh-usage-guard

DeepSeek Harness replays event logs on every session open, accumulating token counts across four buckets. The core only guards cache fields with a ?? 0 fallback, leaving inputTokens and outputTokens as raw numbers in arithmetic. A single NaN, negative value, or missing field from a third-party provider, local inference server, or custom proxy contaminates the cumulative sum, schema validation rejects the digest, and the entire conversation history becomes permanently unreadable. Because replay is dynamic, the damage is irreversible.

dsh-usage-guard intercepts the projection fold at runtime without touching any log files on disk. It ships a broad alias lexicon covering OpenAI, Google Gemini, and Ollama field names, attempts to borrow a valid value before defaulting to zero, and enforces three gates (typeof number, Number.isFinite, >= 0) to screen out NaN, Infinity, negative codes, and stringified numbers. Both already-registered and late-bound projections are wrapped with full this-context preservation, and a deduplicated diagnostic log (capped at 1,000 entries) names the exact session, turn, step, and recovery action without flooding output. After installing and restarting the Web UI, every previously bricked session is instantly restorable.

Ideal for DeepSeek Harness users who route through non-standard upstreams, multi-provider gateways, local Ollama or GPU inference, or custom proxy layers. One install line plus a single service restart is all it takes to eliminate token-poisoning failures without ever rewriting a log file.