DeepSeek Harness plugin

dsh-http-probe

Third-party DeepSeek Harness plugin: model-facing http_probe tool over a deployment-owned probe target with bounded streaming body reads and a cooperative timeout budget.

Jump to install

Source facts

Repository
TwistedRiCen/dsh-http-probe
Latest update
Aug 14, 2026
Category
Tools & Capabilities
GitHub stars
2
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/TwistedRiCen/dsh-http-probe
Plugin: dsh-http-probe
Author: TwistedRiCen

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.mdSource · read only

dsh-http-probe

Third-party DeepSeek Harness plugin bundle providing the model-facing http_probe tool: a controlled HTTP GET against a deployment-owned probe target.

Features

  • Controlled probe: only the URL path is model-controlled; host and port come from deployment config.
  • Deployment-owned baseUrl.
  • Bounded response body read: past the byte cap the read stops and the canonical result carries truncated: true.
  • Cooperative timeout integration: the budget is declared on the tool and enforced by the host tool-call timeout policy.
  • Structured canonical Tool result (ok, status, url, contentType, body, truncated), with the model-facing text produced separately by output.render.
  • Redirects are not followed automatically (redirect: 'manual').

Installation

Prebuilt GitHub Release tarball (the currently verified distribution path):

1. Download dsh-http-probe-0.1.0.tgz from the Releases page. 2. Install it with:

dsh plugin --profile <profile> add /path/to/dsh-http-probe-0.1.0.tgz

The package declares dsh.bundle, so dsh plugin add registers it as a profile bundle layer automatically. Remove it with:

dsh plugin --profile <profile> remove dsh-http-probe

Configuration

FieldTypeDefaultMeaning
baseUrlstringhttp://127.0.0.1:3199Probe target base URL (http/https, normalized with a trailing /).
maxBodyBytesnumber8192Maximum response body bytes read from the wire; past it the read stops and the canonical result carries truncated: true.
timeoutMsnumber2000Cooperative tool-call timeout budget, enforced by the host's @deepseek-ai/dsh-tool-call-timeout-policy.

Config is validated by the plugin at load (no schema dependency): unknown fields and non-positive-integer limits fail loud.

Tool

  • Name: http_probe
  • Parameter: path only — must start with a single /; no .. segments, query, fragment, or control characters.

Example: Use the http_probe tool to GET /ok.

Security

  • The model cannot choose a full URL: only path is exposed.
  • baseUrl is deployment configuration.
  • Redirects are not followed automatically.
  • This is a fixed-target probe, not a general-purpose arbitrary-URL fetcher.

Compatibility / Developer Preview

  • Requires the host to provide @deepseek-ai/cordis@4.0.1 and @deepseek-ai/dsh-tools@0.1.0-rc.5 (hard peer dependencies).
  • @deepseek-ai/dsh-tools@0.1.0-rc.5 is not currently published on the npm registry, therefore:

- Prebuilt tarball installation is verified and supported. - Git source self-contained install is not verified and is currently blocked. - Do not substitute a different @deepseek-ai/dsh-tools version; keep the exact host version.

Development

  • The public tsconfig.json carries no machine-specific paths and is used by pnpm build.
  • While @deepseek-ai/dsh-tools@0.1.0-rc.5 types are unavailable from the registry, local development uses a gitignored tsconfig.local.json that extends ./tsconfig.json with a paths mapping to a local rc.5 declaration build; run pnpm build:local to use it.
  • tsconfig.local.json never ships in the tarball and never enters Git.