dsh-ThirdApi-ThinkingMode

api_thinking is a community-maintained DeepSeek Harness (DSH) plugin. It is not a DeepSeek AI product.

The problem it solves

DSH's built-in model catalogue does not contain your third-party APIs. To get them into the model picker at all, you declare an llm-pi-ai route by hand and list its models: yourself.

But a hand-written models: list replaces the installed catalogue outright. Those models are neither in the catalogue nor declare reasoningEfforts, so dsh-llm-pi-ai treats them as non-reasoning and the composer offers no thinking levels.

Writing the levels into YAML fixes that once — and goes stale immediately: nobody adds them when the gateway ships a new model, and nobody updates them when upstream changes what it supports.

Yet an OpenAI-compatible gateway usually already publishes that capability in its own model listing. This plugin reads it and writes the result back into your configuration, so you stop maintaining that YAML by hand.

Features

• Automatic level sync — requests each route's model listing and writes the levels the endpoint publishes into the matching model's reasoningEfforts.
• New APIs just work — add a route, or add models to an existing one; no plugin change, no restart.
• Never invents capability — an endpoint that says nothing about reasoning is left exactly as it is; hand-written levels are never erased.
• Owns exactly one field — it owns reasoningEfforts and nothing else; comments, !!js expressions and every other field stay as they were.
• Idempotent — a sweep that finds nothing to change writes no file at all.
• Self-diagnosing — every load and every sweep records a status document, so there is always something to read when it misbehaves.

Screenshots

Once installed, the model picker offers the thinking levels a model actually supports.

Install

Requires a working DeepSeek Harness installation. The examples use the desktop profile — substitute your own profile name.

From the plugin page

Open Settings → Plugins in the DSH web UI, search for dsh-api-thinking and install it. An agent can also call the plugin manager's install_bundle directly.

From the command line

dsh plugin --profile desktop add dsh-api-thinking

Restart DSH and refresh the page afterwards.

Let an agent do it

Paste this to an agent that can run terminal commands and is connected to your DSH:

Install dsh-api-thinking into my DSH profile, confirm it is active, and tell me how to reload.

Uninstall

Switch it off or uninstall it from the plugin page, or remove the dsh-api-thinking dependency from that profile's package.json and delete it from the dsh.profile.bundles array.

Usage

It works as soon as it is installed — there is no switch to turn on. The plugin walks every route under the llm-pi-ai row:

Rules

A model's capability comes from the first matching field in the endpoint's model listing:

What gets written:

The last two are deliberate safety design: LiteLLM, vLLM and most self-hosted gateways publish no capability data, and treating that silence as "no levels" would erase hand-written configuration. The plugin only ever acts on what the endpoint actually states.

includeOff defaults to off. When no level is selected, the pi-ai adapter sends the mapped off value as the default — so adding off to a model that allows disabling thinking would silently turn "provider default" into "no thinking". It has to be enabled explicitly.

Configuration

- insert:
    - id: api-thinking
      name: dsh-api-thinking
      config:
        entryId: llm-pi-ai
        routes: []
        intervalMs: 120000
        startDelayMs: 3000
        timeoutMs: 15000
        includeOff: false
        fixedEffortAsLevel: true
        log: true
        statusFile: ''

Overriding the bundle row: an override in your profile patch must repeat name: dsh-api-thinking word for word, or applyEntryPatches skips it silently.

When it runs

Every sweep re-reads the row's providers from the composed profile layers rather than from the snapshot the plugin was instantiated with — which is what makes a route you just saved visible immediately.

Troubleshooting: why nothing happened

The host logger is not reliably reachable from a plugin, so every load and sweep writes its result to a status document (by default $DSH_HOME/api-thinking.status.json):

{
  "phase": "sweep", "reason": "interval", "wrote": true, "via": "patch-file", "error": null,
  "routes": [{ "route": "my-gateway", "models": 20, "listed": 51,
               "changes": [{ "id": "example-model", "to": { "low": "low", "high": "high" } }],
               "dropped": [], "error": null }]
}

Read these first:

A non-empty listed with an empty changes usually means the endpoint publishes no reasoning capability — see Rules.

Write channels

The plugin prefers the official channel and only falls back when it has to:

The fallback is unrelated to how the plugin was installed: a hot-reloaded plugin runs its apply() inside the very HMR transaction that replaced it, after which every write through the official channel is refused as a nested transaction. The fallback touches only the target models' reasoningEfforts (located by indentation, written to a temp file and renamed), leaving comments and every other field byte-identical.

Known limitations

• It reads the model listing as its only source of capability. An endpoint that publishes nothing about reasoning is left alone.
• Only protocols that can list models are supported: openai-completions, openai-responses, anthropic-messages.
• Models are matched by exact id; no aliases or fuzzy matching.
• The default meaning of off is constrained by the pi-ai adapter, which cannot express "selectable but not the default".
• The fallback channel does no schema validation, only structural location.
• Writing cordis.patch.yml at the same time as the settings page can in theory overwrite each other; the next sweep converges again (it is idempotent).

Feedback and contributing

Found a bug or have a suggestion? Please open an issue with your DSH version, the plugin version and reproduction steps.

npm test                              # 15 checks: pure logic, patch edits, composed config, real gateway catalogue
node tools/check_live.mjs             # live profile vs gateway, per model; drift should be 0
node tools/diff_gateway_profile.mjs   # "why is my new API missing": gateway vs profile, per model

The maintenance tools infer locations from the environment (DSH_HOME / DSH_PROFILE, or API_THINKING_PROFILE_DIR / API_THINKING_PROFILE) and read the gateway from API_THINKING_BASE_URL (optionally with API_THINKING_API_KEY) or API_THINKING_GATEWAY_CONFIG (a config.json holding { listen, api_key }).

License

MIT