DeepSeek Harness: Publishing Plugins

# Compile TypeScript
pnpm build

# Confirm output
ls dist/
# index.js  index.d.ts  ...

# First publish
npm publish --access public

# Publish after version update
npm version patch  # 1.0.0 → 1.0.1
npm publish

# .npmignore
src/
tests/
tsconfig.json
*.tsbuildinfo
.git/
.vscode/

# Install in another project
pnpm add @dsh-plugin/my-tool

# Verify import
node -e "console.log(require('@dsh-plugin/my-tool'))"

{
  "name": "@dsh-plugin/my-tool",
  "version": "1.0.0",
  "main": "dist/index.js",
  "types": "dist/index.d.ts",
  "dsh": {
    "name": "my-tool",
    "description": "A custom tool for DSH",
    "services": ["tools"],
    "inject": ["tools"],
    "capabilities": [],
    "compatibility": {
      "dsh": ">=0.5.0",
      "cordis": ">=1.0.0"
    },
    "permissions": [
      "fs.read",
      "network.outbound"
    ],
    "config": {
      "apiKey": {
        "type": "string",
        "required": true,
        "description": "API key for the service"
      }
    }
  }
}

Repository Settings → Topics → Add topic: dsh-plugin

# GitHub CLI search
gh search repos --topic dsh-plugin --sort stars

# GitHub web search
https://github.com/topics/dsh-plugin

dsh-plugin        ← Required
deepseek-harness  ← Optional, increases discoverability
Tool type         ← e.g., database, search, devops

When to bump PATCH:
  - Fix a tool bug
  - Fix a config validation issue
  - Documentation update

When to bump MINOR:
  - Add a new tool
  - Add a config option (with default)
  - Add a capability implementation
  - Add optional dependencies

When to bump MAJOR:
  - Remove a tool
  - Change tool parameter format
  - Remove a config option
  - Change inject list
  - Change Capability interface

# Bump PATCH
npm version patch -m "fix: resolve timeout issue"

# Bump MINOR
npm version minor -m "feat: add batch query tool"

# Bump MAJOR
npm version major -m "breaking: change tool parameter format"

# Alpha version
npm version prealpha --preid alpha
# 1.0.0 → 1.1.0-alpha.0

# Beta version
npm version prebeta --preid beta
# 1.0.0 → 1.1.0-beta.0

# RC version
npm version prerelease --preid rc
# 1.1.0-beta.0 → 1.1.0-rc.0

{
  "dsh": {
    "compatibility": {
      "dsh": ">=0.5.0",
      "cordis": ">=1.0.0",
      "node": ">=18.0.0"
    }
  },
  "peerDependencies": {
    "@deepseek-ai/dsh": ">=0.5.0",
    "@deepseek-ai/cordis": ">=1.0.0"
  }
}

# DSH built-in check
dsh plugin check @dsh-plugin/my-tool

# Output
✅ Compatible with dsh@0.5.0
✅ Compatible with cordis@1.0.0
⚠️ Requires Node.js >= 18.0.0 (current: 16.20.0)

# @dsh-plugin/my-tool

> DSH plugin for [feature description]

## Installation

\```bash
dsh plugin add @dsh-plugin/my-tool
\```

## Configuration

\```yaml
plugins:
  '@dsh-plugin/my-tool':
    config:
      apiKey: sk-xxx
      maxRetries: 3
\```

## Provided Tools

| Tool | Description |
|:-----|:-----------|
| `my_tool` | Does something useful |

## Dependencies

- DSH >= 0.5.0
- Cordis >= 1.0.0

## Permissions

- fs.read
- network.outbound

### ▶ Example

\```text
👤 Alice: Analyze project with my_tool

🤖 Agent:
🔧 Using tool: my_tool
  → Result: ...
\```

## License

MIT

# Changelog

## 1.1.0 (2026-08-20)

### Added
- batch_query tool for querying multiple paths
- Config option `maxDepth` for recursive analysis

### Fixed
- Timeout handling for large directories

## 1.0.0 (2026-08-01)

### Breaking
- Changed parameter format from `dir_path` to `path`

### Added
- Initial release with file_info tool