dsh-matrix-terminal-balance: A DSH plugin that feeds balance data to the DeepSeek Harness prompt line

What Does It Do?

It is a DSH plugin for DeepSeek Harness that supplies the account balance behind the dsh-matrix-terminal prompt line. It solves the problem of showing a balance in the UI without ever exposing the API key to the browser: the key is resolved per request inside the host process, used for a single outbound call, and only decimal strings reach the page. Its core capabilities are an authenticated balance route, a 30-second cache with in-flight request sharing, structured failure reasons, and no key material written anywhere.

Core Features

• Authenticated balance route: exposes the balance over the harness's authenticated /api channel, answering 401 to unauthenticated requests and 403 to requests carrying a foreign Origin, so the amount is readable only from a page your own harness served.
• Key stays on the host: each request resolves the same credential reference the model provider reads, uses it for one outbound call, and never writes it to a response, cache file, or log line.
• Caching and request coalescing: the last successful answer is cached for 30 seconds and concurrent requests share one in-flight read, so focus-driven UI refreshes do not each cost a request.
• Structured failures: returns ok false with a reason such as no-key, network, http-, or protocol instead of failing the route, letting the skin keep the last known amount.
• Exact amount formatting: fields like total stay documented decimal strings rather than numbers, so formatting remains precise and multiple wallets can be joined with a plus sign.

How to Use This Plugin?

After enabling it in DSH, the plugin registers the balance route automatically and the terminal skin reads it as needed, with no manual trigger. It requires the connection and credentials services on the host plus an API key configured for the DeepSeek provider; without a key the route answers no-key and the prompt line simply ends at the cursor. You can also call the route from your own DSH plugin and use the returned ok, available, and wallets fields to display the amount anywhere in your interface.

How to Troubleshoot This Plugin?

A no-key response means the host has no API key configured for the DeepSeek provider, so add the credential as described in the official docs. A network response means the outbound call failed or exceeded the 8-second timeout, so check host connectivity. An http- or protocol response means the platform endpoint misbehaved or returned an unexpected shape, so retry later and confirm the host version meets the requirements. A direct 401 or 403 means the caller failed host authentication or came from an untrusted origin, so issue the request from a page your own harness served.