Introduction

DeepSeek Harness adopts a plugin-based architecture. Agent presets typically contain many tools. When managing the declarations and states of these tools, it can be easy to become confused about which tools are visible to users, how static disabling is handled, and how dynamic control should be used. The dsh-agent-manager plugin provides a solution for this. It runs as a settings plugin and is specifically used to manage the tool policy of agent presets.

What Is This

dsh-agent-manager is a DeepSeek Harness settings plugin maintained by developer hrhgit. Its core purpose is to view and toggle tools within the scope of agent preset declarations. It does not manage model providers or model metadata.

Core Features

The plugin provides the following capabilities:

  1. Tool visibility filtering: It only shows tools explicitly declared in a preset with agentTool.label. If this field is not declared, a tool will not appear in the interface, even if its package provides tools.
  2. Local preset editing: It allows users to toggle the static disabled state in local presets.
  3. Preset read/write protection: System and shipped presets are read-only. To edit them, they must first be copied to a user preset.
  4. State visualization: It displays the specific state of each tool, including host-controlled, not mounted, available, unavailable, or expired.

Typical Usage

The plugin obtains the tool list and performs operations through the ctx.agentPresets service of the Host. When declaring a tool in a preset, the agentTool.label field must be added to make it visible to the manager.

Example of declaring a tool:

- id: persistent-bash
  name: '@deepseek-ai/dsh-tool-bash-persistent'
  disabled: false
  agentTool:
    label: Persistent Bash

Applicable Scenarios and Notes

This plugin is suitable for developers who need fine-grained management of agent tool policies.

  • Session isolation: Policy changes apply only to future sessions; existing sessions retain their original configuration.
  • Condition value restrictions: Conditional values (such as disabled: !!js process.platform === 'win32') cannot be toggled in the browser and are marked as Host-controlled.
  • Security note: The plugin runs with the permissions of the current DSH process. Before installation, it is recommended to review the source code and license (MIT).

Closing

dsh-agent-manager helps developers better control agent tool policies by providing a centralized tool management interface. For more details, refer to the source code or the plugin directory.