@alaxrpg/dsh-sensenova-provider

Unofficial DeepSeek Harness (DSH) LLM provider plugin for SenseNova (OpenAI-compatible API). Registers the sensenova provider route with a Models-page card, a live model catalog, and multi-account API-key rotation on a single shared base URL.

Reference implementation: @mars-sea/dsh-commandcode-provider (MIT). This plugin keeps only the multi-account connection feature; it drops login flows, usage dashboards, plan windows, and command-line tools.

Features

• Registers provider route sensenova (display name SenseNova).
• Live model catalog via GET {apiBase}/v1/models.
• OpenAI-compatible streaming: POST {apiBase}/v1/chat/completions (SSE).
• Multiple API keys (accounts) on one shared base URL, with automatic rotation:
  • 429 Too Many Requests → cooldown the key (honors Retry-After; 60 s fallback when absent).
  • 401 Unauthorized → disable the key until the stored credential changes.
  • All keys exhausted → surfaces RATE_LIMIT / INVALID_CREDENTIAL with the earliest reset time.
• Web settings page (Models-page card + dedicated settings section).

Requirements

• DSH host >=0.1.2-alpha.3 (alpha line).
• Node.js >=22.

Compatibility note: the runtime import surface is a stable subset of @deepseek-ai/dsh-llm present since 0.1.1-rc.2 (LlmAdapter, LlmError, ReasoningEffortId, assertUsableApiKey, attributionHeaders, errorChain, resolveRetryPolicy); the drifting ToolCallId symbol is defined locally (src/brand.ts, identity-backed). Runtime loading on 0.1.1-rc.2 hosts works; the declared peer floor >=0.1.2-alpha.3 is the type-level support start (the ToolCallId type first appears there).

Install

dsh plugin --profile <name> add dsh-sensenova-provider

Or install from a local path:

dsh plugin --profile <name> add ./dsh-sensenova-provider

Then configure SenseNova in the Models page: the default credential environment variable is SENSENOVA_API_KEY, and the default base URL is https://token.sensenova.cn/v1.

Configuration

The plugin installs a llm-sensenova settings section with these fields:

Field	Type	Default	Meaning
apiBase	string	https://token.sensenova.cn/v1	Shared base URL for all accounts.
apiKeyEnv	credential-ref	SENSENOVA_API_KEY	Default account credential reference.
accounts[]	array	[]	Extra accounts: { id, label, apiKeyEnv }.
activeAccount	string	""	Preferred account id; empty means auto / first usable.

API keys are stored through the DSH credentials service; they are never logged and never sent to the model.

Development

pnpm install
pnpm run typecheck
pnpm run build    # tsdown → lib/
pnpm test         # node --import tsx --test tests/**/*.test.ts

License

MIT