dsh-tool-hackernews

English | 中文

Hacker News tool suite for DeepSeek Harness (DSH) agents: hn_top_stories, hn_search, and hn_item. Built on the free Algolia HN search API — no API key required.

Tools

All three tools are read-only and concurrency-safe, so DSH may schedule sibling calls in parallel. Each request carries the deployment's cooperative timeout budget and forwards the caller's AbortSignal.

Install

DSH plugins install into a profile via dsh plugin (pnpm under the hood). From this GitHub repository:

dsh plugin --profile <name> add "github:tanf1ng/dsh-tool-hackernews"

Or from a local checkout with pnpm:

pnpm install
pnpm build
# then in the profile that should load it:
dsh plugin --profile <name> add "file:../../dsh-tool-hackernews"

Enable the plugin in the profile's cordis.patch.yml (or a product bundle):

- id: tool-hackernews
  name: dsh-tool-hackernews

Config

All keys optional:

Development

pnpm install
pnpm build     # tsc -> lib/
pnpm test      # smoke test against a stub fetch (no network needed)

The package follows the official DSH tool-plugin pattern: a Cordis plugin (name / inject / Config / apply) that registers defineTool definitions on ctx.tools, with full parameter schemas, canonical output schemas, text renderers, and presentCall UI cards.

License

MIT