dsh-vorssaint

Report DeepSeek Harness
usage to Vorssaint: token spend, live runs, models and
projects, and — with your model prices — the API value that feeds the daily
budget.

Vorssaint already follows Claude, Codex, OpenCode and GitHub Copilot by reading
their local session logs. DSH keeps its logs compressed and rotates them, so
this plugin writes the small, stable JSONL feed that Vorssaint's DSH reader
tails instead:

~/.vorssaint/agents/dsh/.jsonl

The plugin starts reporting from the moment it loads; usage from recent
sessions is imported from DSH's own logs on first run, so the current day and
month are not empty after installing it.

Requirements

• DeepSeek Harness 0.2.2-rc.1 or newer in the 0.2.x line.
• A Vorssaint build with DeepSeek Harness support (the dsh provider).
• Node.js 22.15 or newer for backfill; without it the live feed still works.

Install

dsh plugin --profile web add dsh-vorssaint

Use --profile desktop when your app runs the desktop profile. From a local
checkout, before the npm release:

dsh plugin --profile web add link:$PWD

Enable the bundle if the Plugin Manager did not (add "dsh-vorssaint" to
dsh.profile.bundles in ~/.dsh/profiles//package.json), then
restart DSH. The installer marks a new bundle as requiring a restart because
the running host cannot pick up a plugin that is not in its live list.

Finally, open Vorssaint → Settings → the AI page and switch DeepSeek Harness
on. It is enabled by default like the other agents once the feature is
installed.

Prices and the daily budget

DSH reports tokens per response, not a price, and a gateway can report any
model id it likes. The plugin therefore ships no prices: configure the rates
you are actually billed, in USD per million tokens, keyed by the exact model id
Vorssaint will show (the id DSH reports in assistant/message). Add a *
entry as the fallback for ids you did not list.

Add this to ~/.dsh/profiles//cordis.patch.yml (the file's existing
entries stay):

- id: vorssaint
config:
pricing:
"deepseek/deepseek-v4.1-flash":
input: 0.28
output: 0.42
cacheRead: 0.028
cacheWrite: 0.28
"*":
input: 1
output: 2

cacheRead and cacheWrite default to the input rate. Reasoning tokens are
already part of output and are not billed twice. Without a price the feed still
carries tokens, model, project and runs; only API value and the daily budget
stay empty for those responses.

Change the values to the rates on your provider's pricing page — the numbers
above are a shape example, not a quote.

How it works

1. The plugin listens to DSH's committed session/event stream.
2. Every response that reports usage becomes one usage line with input,
   cache-write, cache-read, output and reasoning tokens, the model id and the
   provider route, plus cost when the model has a rate.
3. Turn boundaries become turn lines, which Vorssaint shows as a live run.
4. One file per session, append-only and serialized; the writer skips sequences
   already on disk, so restarts and re-reads never double count. Vorssaint also
   dedupes by the response id.
5. On start, before buffered live events are written, the plugin imports the
   usage already in DSH's session logs from the last backfillDays days. A
   session whose feed is at least as new as its log is skipped, so a normal
   restart costs nothing. A fork's inherited prefix is not billed again.

The exact line schema, tolerances and golden lines are in
docs/FEED.md.

Configuration

Configuration is validated by the loader; invalid rates are dropped rather than
guessed. The feed directory and files are created with 0700/0600.

Privacy

Only the fields in docs/FEED.md are written: session id,
working directory, timestamps, turn numbers, model/provider ids, token counts
and the optional cost. No prompt text, tool arguments, model output, file
contents or credentials ever enter the feed. Writes are fire-and-forget: a full
disk or a closed permissions dialog is logged once and never blocks or fails an
agent turn.

Troubleshooting

• No DeepSeek Harness entry in Vorssaint. Update Vorssaint to a build with
  the DSH provider, then enable it on the AI settings page.
• Plugin not loaded. dsh --profile web --dump-config | grep vorssaint
  should show the vorssaint row. If it does not, enable the bundle and restart
  DSH.
• No data. Check that ~/.vorssaint/agents/dsh exists after a DSH turn. A
  turn with no model response (for example, cancelled before the first step)
  writes no usage line.
• Tokens but no budget. Configure pricing (above).

Development

pnpm install
pnpm check        # typecheck, build, unit tests

The tests cover the line mapping, cost rules, backfill parsing (including fork
cuts and subagents), the append-only writer's restart behavior, and the package
metadata the loader reads.

License

MIT © Rúben Garrido