evan7ang/dsh-agent-hints ↗★ 0

dsh-agent-hints

Per-request serving-intent hints for DeepSeek Harness (dsh): an independent chat-completions provider route (deepseek-hint) carrying the X-Agent-Hint HTTP header (UTF-8 JSON, base64url) on every main-line model request

Package
dsh-agent-hints
Compatibility
Unverified
Version
0.2.0
License
Apache-2.0
Last updated
Oct 13, 2026

Install

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:evan7ang/dsh-agent-hints

Configuration reference

FieldTypeDefaultDescription
baseURLstring— (required)Upstream base; every chat request posts to ${baseURL}/chat/completions
apiKeyEnvstring— (required)Environment-variable name resolved per request
agentTypestringagentReported as session.agent_type
priority{level, reason} or null{level: 3, reason: "user_waiting"}Soft priority; null omits the field
cacheControlarray or null[{type: "pin", range: {end: 1}}]Cache control entries; null omits
thinking"enabled" / "disabled"enableddisabled limits every conversation request to off
reasoningEffort"off"/"low"/"high"/"max"highDefault reasoning effort when a request carries none
models{id, name, contextWindow, maxTokens}[]DeepSeek-V4 family catalogAdvisory model catalog for resolveModel; provide real limits when pointing at your own gateway (they feed compaction decisions)
defaultContextWindowpositive integer1000000Context window assumed for models absent from the catalog
defaultMaxTokenspositive integer256000Per-request output cap materialized when callers omit one
statusSinkstringunset (channel off)Local JSONL path for out-of-band status events
subagentToolNamesstring[]["subagent"]Tool names treated as subagent delegation for derivation.join and status naming

Invalid config aborts composition at load time with a field path — request-time hint construction has no failure path.