dsh-balance

DeepSeek Harness plugin that displays the selected model provider's account
balance as a small text next to the composer's model seat, once a model (and
its reasoning effort) is selected for the active conversation.

How it works

• Host half (lib/index.js, a Cordis plugin) mounts one loopback HTTP
  route — GET /dsh-balance/balance?provider=<route> — on the webserver. The
  route resolves the selected provider's own API key through the standard
  credentials service (the llm-deepseek section for the DeepSeek official
  route, the llm-pi-ai providers table for custom/other routes), then probes
  the provider's balance: DeepSeek-style GET <baseURL>/user/balance first,
  falling back to the OpenAI-style GET <baseURL>/v1/dashboard/billing/credit_grants.
  The key never crosses the wire boundary.
• Client half (client/client.js, a web client plugin) registers a seat
  into the conversation.input.right slot (immediately beside the model
  selector). It subscribes to the active session's model-selection directory
  (modelDirectories), passes the selected provider to the route, and only
  renders after a model with a non-empty id is selected — an empty selection
  hides the text instead of retaining a stale balance. Polls every 60s;
  clicking the text refreshes immediately.

Installation

From source (any DSH profile)

The package declares a dsh.bundle manifest, so it installs through the
standard plugin command once the repo is resolvable:

dsh plugin add @kkbsgg/dsh-balance

Manual (packaged DSH Desktop)

With the package resolvable from the profile's node_modules, add one loader
row to the profile patch ($DSH_HOME/profiles/<profile>/cordis.patch.yml):

- insert:
    - id: balance
      name: 'dsh-balance'

and restart the application so the loader composes the new row. Subsequent
edits to the client bundle hot-reload through the client HMR channel.

For the packaged DSH Desktop app, the package lives in the app's unpacked
node_modules and is linked into $DSH_HOME/profiles/node_modules as a
junction, so the profile loader resolves it exactly like the in-box plugins.

Note: the package is installed by hand into the pnpm-managed hoisted store.
A future pnpm install in the profile may prune it; re-create the link if
the balance text disappears after a plugin-market install.

Repository layout

dsh-balance/  (@kkbsgg/dsh-balance)
├── lib/index.js           # host half (Cordis plugin + balance route)
├── client/client.js       # client half (web client plugin bundle)
├── test/smoke.test.mjs    # host-half smoke test (run: node test/smoke.test.mjs)
├── cordis.patch.yml       # dsh.bundle patch (market installability)
├── package.json           # dsh.bundle + dsh.client manifest
├── CHANGELOG.md
├── .editorconfig
└── README.md

The live copy currently installed in the DSH Desktop app lives under the app's
unpacked node_modules; this repository is the source of truth. After
changing code here, re-sync the files into the installed copy (or install the
package from this repo and re-create the profile link).

Response shape

{ "ok": true, "isAvailable": true,
  "balanceInfos": [{ "currency": "CNY", "totalBalance": "110.00", "grantedBalance": "10.00", "toppedUpBalance": "100.00" }],
  "fetchedAt": "2026-01-01T00:00:00.000Z" }
{ "ok": false, "code": "no-api-key", "message": "no credential configured for DEEPSEEK_API_KEY" }