Introduction¶

DeepSeek Harness (DSH) extends runtime tools and delegation capabilities through plugins. For scenarios requiring different models, personas, or tool filtering strategies for different tasks, the default subagent delegation parameters might not be flexible enough.

dsh-subagent-tools is a DSH bundle designed to enhance the subagent delegation tool: it supports overriding model, provider, persona, and toolFilter on a single call, supports @preset: preset references, and also supports composite model IDs in the format provider/model. It is provided as a standard bundle and does not modify official package files.

What is this¶

Name: dsh-subagent-tools
Purpose: Enhance DSH’s subagent delegation tools
License: MIT
GitHub: https://github.com/lynx-gt/dsh-subagent-tools
Package Version: 0.1.0

Core Features¶

Single Call Override¶

This package adds override parameters that take effect on a single call to the subagent delegation tool.

model: Overrides the model for this call. Supports bare model IDs and composite IDs in the format provider/model.
provider: Overrides the delegate provider for this call. Here, provider refers to the subagent backend, not the LLM provider; to switch the LLM provider, use a composite model ID or an instance agentOptions.
persona: Overrides the persona for this call. Supports raw text or @preset:<id> preset references.
toolFilter: Overrides the tool allow/deny filtering strategy for this call.

Preset References¶

@preset: references depend on the local preset layout. Presets on different machines may vary; for example, @preset:审校员 can only be resolved in an environment where that preset exists.

You can display available presets on the current deployment via presetHints in the tool schema, making it easier for the model to select a suitable @preset:<id> when making calls.

Bundle and Compatibility¶

This package is provided as a standard dsh bundle and does not modify official package files.

It declares compatible DSH versions via peerDependencies; if the current DSH version does not meet requirements, the plugin will refuse to load.

The compatible dependencies declared in package.json include:

{
  "peerDependencies": {
    "@deepseek-ai/cordis": "^4.0.1",
    "@deepseek-ai/dsh-tools": "^0.1.0-rc.6",
    "@deepseek-ai/dsh-subagent": "^0.1.0-rc.6",
    "@deepseek-ai/dsh-agent": "^0.1.0-rc.6",
    "@deepseek-ai/dsh-llm": "^0.1.0-rc.6",
    "@deepseek-ai/dsh-session": "^0.1.0-rc.6",
    "@deepseek-ai/dsh-jobs": "^0.1.0-rc.6"
  }
}

Installation and Enablement¶

The following steps are for the web profile.

Install the plugin:

dsh plugin --profile web add dsh-subagent-tools

If enabling Web sessions, run the preset adapter to make the tool row for Web sessions point to this package. For Windows environments, use:

powershell -ExecutionPolicy Bypass -File install-preset.ps1

For POSIX environments, use:

./install-preset.sh

Restart dsh web and start a new session:

restart dsh web and start a NEW session

Note: When the preset adapter is not running, the default standard preset still points to the official subagent package. headless and other non-web profiles do not require a preset adapter.

Typical Usage¶

The following example specifies a composite model ID and a preset persona in a single subagent call:

subagent(description="Review the translation", prompt="...", model="kimi-code/k3", persona="@preset:审校员")

Here, model="kimi-code/k3" uses a composite model ID; persona="@preset:审校员" references a preset that exists locally.

Suitable Scenarios and Notes¶

Suitable for the following scenarios:

Need to switch models, personas, subagent backends, or tool filtering strategies based on tasks.
Using DSH Web sessions and willing to run the preset adapter.
Accepting the MIT license and checking the plugin source code before use.

Please note:

This package does not provide a cwd parameter. The cwd functionality is provided in the companion package dsh-subagent-tools-cwd; do not install both at the same time.
The provider parameter refers to the subagent backend, not the LLM provider.
@preset: references depend on the local preset layout; presets on different machines may differ.
Web sessions require running the preset adapter; headless and other non-web profiles do not.
The plugin enters the DSH runtime environment and runs with the permissions of the current DSH process. You should check the source code and license before installation.

Conclusion¶

The value of dsh-subagent-tools lies in making model, provider, persona, and toolFilter in subagent delegation single-call parameters, while maintaining standard bundle installation without modifying official package files.

GitHub: https://github.com/lynx-gt/dsh-subagent-tools

dsh-subagent-tools: Add single-call override parameters for DeepSeek Harness