dsh-web-summary

Readme

# dsh-web-summary

A [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) Host tool plugin that fetches a public web page over HTTPS and returns its `<title>` and a plain-text summary of the visible content to the agent.

## Features

- Registers one model-callable tool: `fetch_page_summary`
- Accepts an `https://` URL and an optional `maxChars` cap (default 4000)
- Returns `{ url, title, summary, truncated }`; scripts, styles, and markup are stripped
- Plain ESM JavaScript — no build step, works from both Git and npm installs

## Install

```bash
dsh plugin --profile <profile> add github:<owner>/dsh-web-summary
```

or from npm:

```bash
dsh plugin --profile <profile> add dsh-web-summary
```

Restart the profile afterwards. The tool then appears as `fetch_page_summary` for the agent.

## Usage example

Ask the agent: *"Summarize https://example.com"*. The agent will call `fetch_page_summary` and receive the title plus up to `maxChars` characters of visible text.

## Development

```bash
# verify the file parses as ESM and exports a Cordis plugin
node --check lib/index.js
```

## License

[MIT](LICENSE)