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
설치
$
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:evan7ang/dsh-agent-hintsConfiguration reference
| Field | Type | Default | Description |
|---|---|---|---|
baseURL | string | — (required) | Upstream base; every chat request posts to ${baseURL}/chat/completions |
apiKeyEnv | string | — (required) | Environment-variable name resolved per request |
agentType | string | agent | Reported as session.agent_type |
priority | {level, reason} or null | {level: 3, reason: "user_waiting"} | Soft priority; null omits the field |
cacheControl | array or null | [{type: "pin", range: {end: 1}}] | Cache control entries; null omits |
thinking | "enabled" / "disabled" | enabled | disabled limits every conversation request to off |
reasoningEffort | "off"/"low"/"high"/"max" | high | Default reasoning effort when a request carries none |
models | {id, name, contextWindow, maxTokens}[] | DeepSeek-V4 family catalog | Advisory model catalog for resolveModel; provide real limits when pointing at your own gateway (they feed compaction decisions) |
defaultContextWindow | positive integer | 1000000 | Context window assumed for models absent from the catalog |
defaultMaxTokens | positive integer | 256000 | Per-request output cap materialized when callers omit one |
statusSink | string | unset (channel off) | Local JSONL path for out-of-band status events |
subagentToolNames | string[] | ["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.