@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.
• Streaming over both wire protocols: POST {apiBase}/v1/responses (default, see below) and POST {apiBase}/v1/chat/completions (SSE; automatic fallback).
• Multiple API keys (accounts) on one shared base URL:
• 429 Too Many Requests → does not cool down or rotate the key (protects the server-side per-key prompt cache); raises RATE_LIMIT with providerRetryAfterMs for the host retry layer (honors Retry-After, capped at 60 s; quota-class 429s carry a backoff floor). With quotaRotation enabled, quota-class 429s stickily switch to the next untried key.
• 401 Unauthorized → rotate to the next key; the rejected key stays disabled until the stored credential changes.
• All keys exhausted → surfaces RATE_LIMIT / INVALID_CREDENTIAL.
• Web settings page (Models-page card + dedicated settings section).
• Default wire protocol is Responses (auto mode): used whenever the request can be expressed faithfully, and automatically downgraded to Chat Completions when semantics would be lost (e.g. a stop sequence, or a reasoning effort away from the model's Responses default). Notable Responses differences: max_output_tokens counts reasoning tokens, temperature defaults to 0.6 (Chat uses 1), reasoning is replayed as a summary only, and stop is not supported (auto-downgrades to Chat).
• Image inputs: outbound images in production depend on a host-side attachment bridge (the 0.1.7-rc.2 adapter type surface has no channel for it yet). In this version images are sent as host-generated text placeholders — never silently dropped; the bridge is a follow-up host dependency.

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  add dsh-sensenova-provider

Or install from a local path:

dsh plugin --profile  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:

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